diff --git a/xml/System.Net.Http.Headers/ContentDispositionHeaderValue.xml b/xml/System.Net.Http.Headers/ContentDispositionHeaderValue.xml index f70d35e0774..cb5a8862695 100644 --- a/xml/System.Net.Http.Headers/ContentDispositionHeaderValue.xml +++ b/xml/System.Net.Http.Headers/ContentDispositionHeaderValue.xml @@ -55,17 +55,17 @@ Represents the value of the Content-Disposition header. - class. For more information, see IETF RFC 2183. - -2. An HTTP header in class. For more information, see IETF RFC 6266. - + class. For more information, see IETF RFC 2183. + +2. An HTTP header in class. For more information, see IETF RFC 6266. + ]]> @@ -234,11 +234,11 @@ The disposition type for a content body part. The disposition type. - property of "inline" if it is intended to be displayed automatically upon display of the message. A body part can be designated with a property of "attachment" to indicate that they are separate from the main body of the HTTP request or response. - + property of "inline" if it is intended to be displayed automatically upon display of the message. A body part can be designated with a property of "attachment" to indicate that they are separate from the main body of the HTTP request or response. + ]]> @@ -329,11 +329,11 @@ A suggestion for how to construct a filename for storing the message payload to be used if the entity is detached and stored in a separate file. A suggested filename. - property uses MIME encoding for non-ascii characters. - + property uses MIME encoding for non-ascii characters. + ]]> @@ -374,11 +374,11 @@ A suggestion for how to construct filenames for storing message payloads to be used if the entities are detached and stored in a separate files. A suggested filename of the form filename*. - property uses IETF RFC 5987 encoding. The and properties differ only in that uses the encoding defined in IETF RFC 5987, allowing the use of characters not present in the ISO-8859-1 character set. - + property uses IETF RFC 5987 encoding. The and properties differ only in that uses the encoding defined in IETF RFC 5987, allowing the use of characters not present in the ISO-8859-1 character set. + ]]> @@ -419,13 +419,13 @@ Serves as a hash function for an object. A hash code for the current object. - method is suitable for use in hashing algorithms and data structures such as a hash table. - + method is suitable for use in hashing algorithms and data structures such as a hash table. + ]]> @@ -462,7 +462,7 @@ System.Nullable<System.DateTimeOffset> - The date at which the file was last modified. + The date when the file was last modified. The file modification date. To be added. diff --git a/xml/System.Net.Http.Headers/ProductInfoHeaderValue.xml b/xml/System.Net.Http.Headers/ProductInfoHeaderValue.xml index a3bd03f87e5..0ad2ea038cb 100644 --- a/xml/System.Net.Http.Headers/ProductInfoHeaderValue.xml +++ b/xml/System.Net.Http.Headers/ProductInfoHeaderValue.xml @@ -53,15 +53,15 @@ - Represents a value which can either be a product or a comment in a User-Agent header. + Represents a value that can either be a product or a comment in a User-Agent header. - class provides support for the product and comment tokens values used in a User-Agent header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF. - - The User-Agent field contains information about the user agent originating the request. The field can contain multiple product tokens and comments identifying the user agent and any sub-products. - + class provides support for the product and comment tokens values used in a User-Agent header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF. + + The User-Agent field contains information about the user agent originating the request. The field can contain multiple product tokens and comments identifying the user agent and any sub-products. + ]]> @@ -329,13 +329,13 @@ Serves as a hash function for an object. A hash code for the current object. - method is suitable for use in hashing algorithms and data structures such as a hash table. - + method is suitable for use in hashing algorithms and data structures such as a hash table. + ]]> diff --git a/xml/System.Net.Http.Headers/RangeConditionHeaderValue.xml b/xml/System.Net.Http.Headers/RangeConditionHeaderValue.xml index c888d49071b..b9d1fc2e591 100644 --- a/xml/System.Net.Http.Headers/RangeConditionHeaderValue.xml +++ b/xml/System.Net.Http.Headers/RangeConditionHeaderValue.xml @@ -53,13 +53,13 @@ - Represents an If-Range header value which can either be a date/time or an entity-tag value. + Represents an If-Range header value that can either be a date/time or an entity-tag value. - class provides support for the If-Range header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF. - + class provides support for the If-Range header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF. + ]]> @@ -354,13 +354,13 @@ Serves as a hash function for an object. A hash code for the current object. - method is suitable for use in hashing algorithms and data structures such as a hash table. - + method is suitable for use in hashing algorithms and data structures such as a hash table. + ]]> diff --git a/xml/System.Net.Http.Headers/RetryConditionHeaderValue.xml b/xml/System.Net.Http.Headers/RetryConditionHeaderValue.xml index 6a56169043f..39b1ef556e8 100644 --- a/xml/System.Net.Http.Headers/RetryConditionHeaderValue.xml +++ b/xml/System.Net.Http.Headers/RetryConditionHeaderValue.xml @@ -47,13 +47,13 @@ - Represents a Retry-After header value which can either be a date/time or a timespan value. + Represents a Retry-After header value that can either be a date/time or a timespan value. - class provides support for the Retry-After header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF. - + class provides support for the Retry-After header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF. + ]]> @@ -304,13 +304,13 @@ Serves as a hash function for an object. A hash code for the current object. - method is suitable for use in hashing algorithms and data structures such as a hash table. - + method is suitable for use in hashing algorithms and data structures such as a hash table. + ]]> diff --git a/xml/System.Net.Http/HttpResponseMessage.xml b/xml/System.Net.Http/HttpResponseMessage.xml index 3372a83505f..1cdd7257633 100644 --- a/xml/System.Net.Http/HttpResponseMessage.xml +++ b/xml/System.Net.Http/HttpResponseMessage.xml @@ -50,20 +50,20 @@ Represents a HTTP response message including the status code and data. - is from one of the methods. + is from one of the methods. ## Examples - :::code language="csharp" source="~/snippets/csharp/System.Net.Http/HttpClient/source.cs" id="Snippet1"::: - :::code language="fsharp" source="~/snippets/fsharp/System.Net.Http/HttpClient/source.fs" id="Snippet1"::: + :::code language="csharp" source="~/snippets/csharp/System.Net.Http/HttpClient/source.cs" id="Snippet1"::: + :::code language="fsharp" source="~/snippets/fsharp/System.Net.Http/HttpClient/source.fs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Misc/system.net.http.httpclient/vb/source.vb" id="Snippet1"::: The preceding code example uses an `async Task Main()` entry point. That feature requires C# 7.1 or later. - + ]]> @@ -78,11 +78,11 @@ Initializes a new instance of the class. - is from one of the methods. - + is from one of the methods. + ]]> @@ -192,11 +192,11 @@ Gets or sets the content of a HTTP response message. The content of the HTTP response message. - @@ -251,8 +251,8 @@ Releases the unmanaged resources and disposes of unmanaged resources used by the . - @@ -298,16 +298,16 @@ to release both managed and unmanaged resources; to releases only unmanaged resources. Releases the unmanaged resources used by the and optionally disposes of the managed resources. - method, if it has been overridden. `Dispose()` invokes this method with the `disposing` parameter set to `true`. `Finalize` invokes this method with `disposing` set to `false`. -When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object. - +When the `disposing` parameter is `true`, this method releases all resources held by any managed objects that this references. This method invokes the `Dispose()` method of each referenced object. + ]]> @@ -348,11 +348,11 @@ When the `disposing` parameter is `true`, this method releases all resources hel Throws an exception if the property for the HTTP response is . The HTTP response message if the call is successful. - method throws an exception if the HTTP response was unsuccessful. In .NET Framework and .NET Core 2.2 and earlier versions, if the is not `null`, this method will also call to free managed and unmanaged resources. Starting with .NET Core 3.0, the content will not be disposed. - + method throws an exception if the HTTP response was unsuccessful. In .NET Framework and .NET Core 2.2 and earlier versions, if the is not `null`, this method will also call to free managed and unmanaged resources. Starting with .NET Core 3.0, the content will not be disposed. + ]]> The HTTP response is unsuccessful. @@ -472,7 +472,7 @@ When the `disposing` parameter is `true`, this method releases all resources hel System.String - Gets or sets the reason phrase which typically is sent by servers together with the status code. + Gets or sets the reason phrase, which typically is sent by servers together with the status code. The reason phrase sent by the server. To be added. @@ -516,14 +516,14 @@ When the `disposing` parameter is `true`, this method releases all resources hel System.Net.Http.HttpRequestMessage - Gets or sets the request message which led to this response message. - The request message which led to this response message. + Gets or sets the request message that led to this response message. + The request message that led to this response message. - , this property will point to the actual request message leading to the final response. Note that this may not be the same message the user provided when sending the request. This is typically the case if the request needs to be resent due to redirects or authentication. This property can be used to determine what URL actually created the response (useful in case of redirects). - + , this property will point to the actual request message leading to the final response. Note that this may not be the same message the user provided when sending the request. This is typically the case if the request needs to be resent due to redirects or authentication. This property can be used to determine what URL actually created the response (useful in case of redirects). + ]]> @@ -633,12 +633,12 @@ When the `disposing` parameter is `true`, this method releases all resources hel Gets the collection of trailing headers included in an HTTP response. The collection of trailing headers in the HTTP response. - instance if it is accessed and the response content has not been read completely. +Since trailing headers are sent as an HTTP header appended at the end of the response message, the `TrailingHeaders` property returns an empty instance if it is accessed and the response content has not been read completely. For additional information on trailing headers, see [RFC 7230 - 4.1.2. Chunked Trailer Part](https://tools.ietf.org/html/rfc7230#section-4.1.2). diff --git a/xml/System.Net.PeerToPeer.Collaboration/PeerCollaboration.xml b/xml/System.Net.PeerToPeer.Collaboration/PeerCollaboration.xml index 8d06937f46b..e16abd55dd0 100644 --- a/xml/System.Net.PeerToPeer.Collaboration/PeerCollaboration.xml +++ b/xml/System.Net.PeerToPeer.Collaboration/PeerCollaboration.xml @@ -17,27 +17,27 @@ Interacts with the Peer Collaboration infrastructure. Many of the core collaboration scenarios begin with this class. - and of the collaboration infrastructure, manage lists of contacts, or publish their presence to each other - -- Utilize properties and events to coordinate asynchronous application communication, especially for changes in name, presence, application, or other objects. - - "Link-local cloud", "subnet of the calling peer", and "NearMe scope" are synonymous terms. "Internet scope" and "serverless presence" are synonymous. The site-local has no equivalent in the collaboration namespace. - - The use of every method or property in this class requires a of . This state is created when the peer collaboration session begins. - + and of the collaboration infrastructure, manage lists of contacts, or publish their presence to each other + +- Utilize properties and events to coordinate asynchronous application communication, especially for changes in name, presence, application, or other objects. + + "Link-local cloud", "subnet of the calling peer", and "NearMe scope" are synonymous terms. "Internet scope" and "serverless presence" are synonymous. The site-local has no equivalent in the collaboration namespace. + + The use of every method or property in this class requires a of . This state is created when the peer collaboration session begins. + ]]> @@ -68,13 +68,13 @@ Gets the object that contains information needed when an application is started due to a collaboration request from a remote peer. If the application was started due to an invitation, a object that contains both information about the peer that sent the application invitation and the invitation itself is returned; otherwise, is returned. The default value for this property is . - instance after it is started to determine whether it was started due to a collaboration request from a remote peer. The calling application should inspect the and properties to get further information about the invitation request. - - Access to this property requires a of . This state is created when the collaboration session begins. - + instance after it is started to determine whether it was started due to a collaboration request from a remote peer. The calling application should inspect the and properties to get further information about the invitation request. + + Access to this property requires a of . This state is created when the collaboration session begins. + ]]> @@ -143,13 +143,13 @@ The to unregister. Unregisters a associated with the calling peer. - of . This state is created when the collaboration session begins. - + of . This state is created when the collaboration session begins. + ]]> The parameter cannot be . @@ -166,20 +166,20 @@ Gets a collection of objects that are registered on the local machine. - method or prior to the use of this method. - - Access to this property requires a of . This state is created when the collaboration session begins. - - - -## Examples - The following example code illustrates how to retrieve a collection of applications registered with the Collaboration infrastructure: - - :::code language="csharp" source="~/snippets/csharp/System.Net.PeerToPeer.Collaboration/ContactManager/Overview/NCLPNRPContacts.cs" id="Snippet5"::: - + method or prior to the use of this method. + + Access to this property requires a of . This state is created when the collaboration session begins. + + + +## Examples + The following example code illustrates how to retrieve a collection of applications registered with the Collaboration infrastructure: + + :::code language="csharp" source="~/snippets/csharp/System.Net.PeerToPeer.Collaboration/ContactManager/Overview/NCLPNRPContacts.cs" id="Snippet5"::: + ]]> @@ -208,13 +208,13 @@ Gets all objects that are registered on the local machine. A that contains all applications that are registered on the local machine. If an application is not found, a collection of size zero (0) is returned. - method prior to the use of this method. - - Access to this property requires a of . This state is created when the collaboration session begins. - + method prior to the use of this method. + + Access to this property requires a of . This state is created when the collaboration session begins. + ]]> An invalid value was returned when this method attempted to enumerate the application registered to this peer. Please make sure that all applications have valid registry values. @@ -254,13 +254,13 @@ Gets a collection of all objects that are registered on the local machine for the specified . A that contains all applications of the specified that are registered on the local machine. If an application is not found, a collection of size zero (0) is returned. - method prior to the use of this method. - - Access to this method requires a of . This state is created when the collaboration session begins. - + method prior to the use of this method. + + Access to this method requires a of . This state is created when the collaboration session begins. + ]]> The parameter is not set to a known value in the enumeration. @@ -294,15 +294,15 @@ Obtains all instances registered by the calling peer with the infrastructure on this machine. - A which contains all the instances registered by the calling peer with the infrastructure on the local machine. - + All the instances registered by the calling peer with the infrastructure on the local machine. + If registered instances are not discovered on the local machine, a collection of size zero (0) is returned. - of . This state is created when the collaboration session begins. - + of . This state is created when the collaboration session begins. + ]]> An invalid value was returned when this method attempted to enumerate all available instances. @@ -335,24 +335,24 @@ Returns a collection of all the endpoints currently signed in on the network subnet of the calling peer. - A that contains all the endpoints currently signed into the 'Near Me' scope. - + A that contains all the endpoints currently signed into the 'Near Me' scope. + If peers are not discovered on the subnet, a collection of size zero (0) is returned. - via this method can require an indeterminate amount of time after sign-in depending on network topology and latency. - - Calling this method requires a of . This state is created when the collaboration session begins. - - - -## Examples - The following code example illustrates how to retrieve PeersNearMe as a PeerNearMeCollection: - - :::code language="csharp" source="~/snippets/csharp/System.Net.PeerToPeer.Collaboration/ContactManager/Overview/NCLPNRPContacts.cs" id="Snippet2"::: - + via this method can require an indeterminate amount of time after sign-in depending on network topology and latency. + + Calling this method requires a of . This state is created when the collaboration session begins. + + + +## Examples + The following code example illustrates how to retrieve PeersNearMe as a PeerNearMeCollection: + + :::code language="csharp" source="~/snippets/csharp/System.Net.PeerToPeer.Collaboration/ContactManager/Overview/NCLPNRPContacts.cs" id="Snippet2"::: + ]]> The peer is not signed in to the 'Near Me' scope. @@ -422,11 +422,11 @@ that contains the name associated with the calling peer's endpoint (provided as the property). The default value for this property is . - of . This state is created when the collaboration session begins. - + of . This state is created when the collaboration session begins. + ]]> Unable to set . @@ -565,17 +565,17 @@ Gets or sets the presence for the calling peer within the infrastructure. The that contains presence information for the calling peer that has registered for a session. - of . This state is created when the collaboration session begins. - + of . This state is created when the collaboration session begins. + ]]> cannot specify - - is offline - + - is offline + - Unable to set @@ -613,24 +613,24 @@ The type of registration to perform. The application may be registered for just the calling peer or for all peers using the machine. Registers the specified for a collaboration session with the calling peer. - method prior to calling this method. - - Access to this method requires a of . This state is created when the collaboration session begins. - - - -## Examples - The following code example illustrates how to register an application with the Collaboration infrastructure: - - :::code language="csharp" source="~/snippets/csharp/System.Net.PeerToPeer.Collaboration/ContactManager/Overview/NCLPNRPContacts.cs" id="Snippet4"::: - + method prior to calling this method. + + Access to this method requires a of . This state is created when the collaboration session begins. + + + +## Examples + The following code example illustrates how to register an application with the Collaboration infrastructure: + + :::code language="csharp" source="~/snippets/csharp/System.Net.PeerToPeer.Collaboration/ContactManager/Overview/NCLPNRPContacts.cs" id="Snippet4"::: + ]]> - - The property on the object passed to is . - + - The property on the object passed to is . + - The peer application instance provided has the same globally unique as an application which is already registered. The existing registration must be unregistered before a new application can be registered with the provided identifier. The and parameters cannot be . Both parameters must be specified. The type parameter is not set to a known value in the enumeration. @@ -666,20 +666,20 @@ The to register. Registers a associated with the calling peer. - method. - - The size of the data portion of the must be less than or equal to 16,384 bytes. - - Access to this method requires a of . This state is created when the collaboration session begins. - + method. + + The size of the data portion of the must be less than or equal to 16,384 bytes. + + Access to this method requires a of . This state is created when the collaboration session begins. + ]]> Object already registered - - cannot be . - + - cannot be . + - cannot be . The operation could not be completed. @@ -716,22 +716,22 @@ The scope the peer is using to join the activity. Signs the peer into the collaboration infrastructure with the specified . - of . This state is created when the collaboration session begins. - - - -## Examples - The following code example illustrates how to sign the users into the Collaboration infrastructure. - - :::code language="csharp" source="~/snippets/csharp/System.Net.PeerToPeer.Collaboration/ContactManager/Overview/NCLPNRPContacts.cs" id="Snippet1"::: - + of . This state is created when the collaboration session begins. + + + +## Examples + The following code example illustrates how to sign the users into the Collaboration infrastructure. + + :::code language="csharp" source="~/snippets/csharp/System.Net.PeerToPeer.Collaboration/ContactManager/Overview/NCLPNRPContacts.cs" id="Snippet1"::: + ]]> @@ -770,13 +770,13 @@ object that specifies the scope in which the calling peer will participate. The default value for this property is . - @@ -814,15 +814,15 @@ Scope enumeration specified by . Signs the peer out of the specified scope. - endpoint object set. This includes and , in addition to any identifying objects registered by the calling peer into the collaboration infrastructure. Because this information is deleted, it is no longer available to either remote peers or a peer host for collaboration. From the perspective of the class, other sharing of the same information with trusted contacts is not relevant; use of the class does not affect other objects in which this information was persisted, such as a remote peer object. Likewise, deleting a peer from the does not affect its presence in a collaboration application; other contacts are still able to view its presence and collaborate with it. - - Calling this method requires a of . This state is created when the collaboration session begins. - + endpoint object set. This includes and , in addition to any identifying objects registered by the calling peer into the collaboration infrastructure. Because this information is deleted, it is no longer available to either remote peers or a peer host for collaboration. From the perspective of the class, other sharing of the same information with trusted contacts is not relevant; use of the class does not affect other objects in which this information was persisted, such as a remote peer object. Likewise, deleting a peer from the does not affect its presence in a collaboration application; other contacts are still able to view its presence and collaborate with it. + + Calling this method requires a of . This state is created when the collaboration session begins. + ]]> The parameter contains an invalid enumeration value. @@ -868,8 +868,8 @@ Gets or sets the event handler callback object for all event handlers. - An object with implemented on it, to be used for application thread synchronization. - + An object with implemented on it, to be used for application thread synchronization. + The default value for this property is . To be added. @@ -908,13 +908,13 @@ The type of deregistration to perform for either the calling peer or for all peers that exist on the machine. Unregisters the specified from the infrastructure. - stops the calling peer from receiving collaboration invitations for it. If the application being unregistered was not previously registered, this is a no-op. - - Calling this method requires a of . This state is created when the collaboration session begins. - + stops the calling peer from receiving collaboration invitations for it. If the application being unregistered was not previously registered, this is a no-op. + + Calling this method requires a of . This state is created when the collaboration session begins. + ]]> The globally unique for the specified application does not exist or is empty. diff --git a/xml/System.Net.PeerToPeer.Collaboration/PeerContact.xml b/xml/System.Net.PeerToPeer.Collaboration/PeerContact.xml index 6af9f31bb62..cfd935f085d 100644 --- a/xml/System.Net.PeerToPeer.Collaboration/PeerContact.xml +++ b/xml/System.Net.PeerToPeer.Collaboration/PeerContact.xml @@ -33,7 +33,7 @@ object must be created for a remote peer or for a user to collaborate with the remote peer when it is outside of the "People Near Me" scope. A object can exist as either an application running on a remote computer, or the user of a remote computer. An instance of this class can be added to the which stores the contact information in a persistent manner. + A contact represents a trusted peer. A object must be created for a remote peer or for a user to collaborate with the remote peer when it is outside of the "People Near Me" scope. A object can exist as either an application running on a remote computer, or the user of a remote computer. An instance of this class can be added to the , which stores the contact information in a persistent manner. An application invitation from a is both authenticated and encrypted. The UI dialog to accept or reject an invitation from a peer contact also indicates that the inviter is trusted. @@ -169,9 +169,8 @@ System.String - Gets or sets a string which represents the display name of the . - - which represents the display name of this . Unless explicitly specified, the default value for all properties is for reference types. + Gets or sets the display name of the . + The display name of this . Unless explicitly specified, the default value for all properties is for reference types. object are the list of contacts to which it has subscribed and from which it expects updates. Those contacts either have updated their own application, object, and presence information, or they have updated information regarding contacts in the . - This property always returns `true` if the object is a which represents the local or "Me" contact, since a contact is always subscribed to itself. + This property always returns `true` if the object is a that represents the local or "Me" contact, since a contact is always subscribed to itself. ]]> @@ -1652,8 +1651,7 @@ Gets or sets the associated with the . - - which represents the of the . Unless explicitly specified, the default value for all properties is for reference types. + The peer name of the . Unless explicitly specified, the default value for all properties is for reference types. Specifies the values that define a Peer object. - is a set of nodes that can communicate with each other through the network. Cloud, peer mesh, and peer-to-peer graph are synonymous. A single peer or node may be connected to more than one cloud. - - Communication between nodes should never cross from one cloud to another. A instance is uniquely identified by its name, which is case-sensitive. - - Clouds are tied very closely to network interfaces. On a multi-homed machine with two network cards attached to different subnets, three clouds will be returned: one for each of the link local addresses per interface, and a single global scope cloud. - + is a set of nodes that can communicate with each other through the network. Cloud, peer mesh, and peer-to-peer graph are synonymous. A single peer or node may be connected to more than one cloud. + + Communication between nodes should never cross from one cloud to another. A instance is uniquely identified by its name, which is case-sensitive. + + Clouds are tied very closely to network interfaces. On a multi-homed machine with two network cards attached to different subnets, three clouds will be returned: one for each of the link local addresses per interface, and a single global scope cloud. + ]]> @@ -67,11 +67,11 @@ Context that provides the means for deserializing the data. Also referred to as the source of the serialized data. Initializes a new instance of the PNRP type. This populates a serialization information object with the data needed to serialize the Cloud object. - property contains the name of the cloud object. - + property contains the name of the cloud object. + ]]> @@ -96,13 +96,13 @@ System.Net.PeerToPeer.Cloud - Returns a reference to a which represents all the link-local clouds in which the client or peer is currently participating. + Returns a reference to a that represents all the link-local clouds in which the client or peer is currently participating. - or to occur in all possible link local clouds. - + or to occur in all possible link local clouds. + ]]> @@ -126,14 +126,14 @@ System.Net.PeerToPeer.Cloud - Returns a static reference to a which represents all the available clouds in which the client is currently participating. + Returns a static reference to a that represents all the available clouds in which the client is currently participating. - or to on all possible clouds. - + or to on all possible clouds. + ]]> @@ -180,11 +180,11 @@ if the specified identifies the same resource as the current one, otherwise . - objects were constructed. - + objects were constructed. + ]]> @@ -216,13 +216,13 @@ if the and the comparison object contain the same information; otherwise . - . - - Other objects that may be compared with clouds include PeopleNearMe clouds and peer meshes available via the Windows SDK Networking Services. - + . + + Other objects that may be compared with clouds include PeopleNearMe clouds and peer meshes available via the Windows SDK Networking Services. + ]]> @@ -252,13 +252,13 @@ Obtains a collection of peer clouds known to the calling peer. A object that specifies a collection of peer clouds known to the calling peer. If no clouds are available, is returned. - methods are the only ways to get new instances of the class. - - Clouds are tied very closely to network interfaces. On a multi-homed machine with two network cards attached to different subnets, three clouds will be returned: one for each of the link local addresses per interface, and a single scope . - + methods are the only ways to get new instances of the class. + + Clouds are tied very closely to network interfaces. On a multi-homed machine with two network cards attached to different subnets, three clouds will be returned: one for each of the link local addresses per interface, and a single scope . + ]]> @@ -290,15 +290,15 @@ Returns the object with the specified cloud name. The object with the specified cloud name. - , link-local, or otherwise, is specified in . - + , link-local, or otherwise, is specified in . + ]]> The name is not known. @@ -328,11 +328,11 @@ Overrides . A hashcode for the current . - @@ -388,8 +388,7 @@ Gets a instance that contains globally (internet) scoped peers. - - which contains the peers that will communicate via the global network scope. + The that contains the peers that will communicate via the global network scope. To be added. @@ -415,11 +414,11 @@ Gets the name of the peer . The name of the peer . - @@ -447,11 +446,11 @@ enumeration value that specifies the PNRP scope of the current peer cloud instance. - scope . - + scope . + ]]> @@ -479,11 +478,11 @@ Gets the identifier of a specific IP address for this peer . An integer value that specifies the scope-specific ID for this peer cloud. - , and the other is scope. - + , and the other is scope. + ]]> @@ -551,11 +550,11 @@ Returns a string representation of the current . A string that represents the current . - . - + . + ]]> diff --git a/xml/System.Net.PeerToPeer/PeerName.xml b/xml/System.Net.PeerToPeer/PeerName.xml index 11a5185e420..10dc4818295 100644 --- a/xml/System.Net.PeerToPeer/PeerName.xml +++ b/xml/System.Net.PeerToPeer/PeerName.xml @@ -93,11 +93,11 @@ Context that provides the means for deserializing the data. Also referred to as the source of the serialized data. Populates a object with the data needed to serialize the . - One or more parameters are . @@ -135,19 +135,19 @@ enumeration value that specifies the type of peer name to create. Initializes a new instance of the class. - that contains the fully qualified name of the peer. It also specifies whether the peer name is secured or unsecured. - - This instance uses the default peer identity for the current user and the specified , in addition to the type of peer name to create with the specified classifier and type. - + that contains the fully qualified name of the peer. It also specifies whether the peer name is secured or unsecured. + + This instance uses the default peer identity for the current user and the specified , in addition to the type of peer name to create with the specified classifier and type. + ]]> The includes one or more illegal characters. One or more parameters are . - - The Default Identity used as the basis of the could not be retrieved. - + - The Default Identity used as the basis of the could not be retrieved. + - The could not be created. @@ -170,15 +170,15 @@ Returns a string that specifies the used by this object. - The string which contains the authentication portion of the specified . For secured peer names, this property contains the public key as a forty-character hexadecimal string. For unsecured peer names, this property is set to zero (0). + The string that contains the authentication portion of the specified . For secured peer names, this property contains the public key as a forty-character hexadecimal string. For unsecured peer names, this property is set to zero (0). - @@ -206,17 +206,17 @@ Returns a string that contains the classifier for a peer-to-peer . - The string which contains the classifier portion used to identify a peer name for or resolution within a PNRP . - + The classifier portion used to identify a peer name for or resolution within a PNRP . + Unless explicitly specified, the default value for all properties is for reference types and zero (0) for properties of type . - @@ -254,13 +254,13 @@ Creates a new instance of the specified object with the specified peer host name. A object that represents the specified peer host name. - object based on the property. This peer name is not associated with the identity of the calling node. - + object based on the property. This peer name is not associated with the identity of the calling node. + ]]> The provided is not a valid peer host name string. @@ -303,11 +303,11 @@ Creates a new by replacing the field defined on the supplied object with the specified classifier string value. The new object that contains the updated classifier. - is appended to the existing portion of the . This string is no more than 149 characters long, including the `null` terminator. Specify `null` to return the peer name of the identity. - + is appended to the existing portion of the . This string is no more than 149 characters long, including the `null` terminator. Specify `null` to return the peer name of the identity. + ]]> The provided is not a valid peer name classifier. @@ -326,11 +326,11 @@ Determines whether the content of this object is equivalent to the content of another object. - . - + . + ]]> @@ -364,17 +364,17 @@ The peer name to compare with this . Performs a case-sensitive comparison of the current and the specified peer name. - if the specified identifies the same resource as the current peer name object; otherwise, . - + if the specified identifies the same resource as the current peer name object; otherwise, . + This method also returns if is set to . - and components. - - No normalizations are performed on the strings prior to comparison. All normalization should have been completed while or before constructing the peer name objects. - + and components. + + No normalizations are performed on the strings prior to comparison. All normalization should have been completed while or before constructing the peer name objects. + ]]> @@ -405,11 +405,11 @@ if the and the comparison object contain the same information; otherwise, . - . - + . + ]]> @@ -436,11 +436,11 @@ Overrides the method. A hashcode for the current . - @@ -471,11 +471,11 @@ Contains the destination for the serialized stream associated with the object. Populates a serialization information object with the data needed to serialize the . - method. - + method. + ]]> @@ -499,17 +499,17 @@ Gets a Boolean value that specifies whether this is a secured peer name. - If , this peer name is secured with a private key/ public key pair. Its name contains the Secure Hash Algorithm (SHA) hash of the public key of the user certificate of that peer machine. Otherwise, if , the peer name has no associated identity. - + If , this peer name is secured with a private key/ public key pair. Its name contains the Secure Hash Algorithm (SHA) hash of the public key of the user certificate of that peer machine. Otherwise, if , the peer name has no associated identity. + Unless explicitly specified, the default value for all properties is for reference types and zero (0) for properties of type . - @@ -542,16 +542,16 @@ System.String - Gets the name of the peer-to-peer host. This is a DNS-encoded version of the which is equivalent to a in that they are both identifiers. The difference between the two is visual representation. - A value that is the name of the peer-to-peer host. Unless explicitly specified, the default value for all properties is for reference types. + Gets the name of the peer-to-peer host. This is a DNS-encoded version of the , which is equivalent to a in that they are both identifiers. The difference between the two is visual representation. + The name of the peer-to-peer host. Unless explicitly specified, the default value for all properties is for reference types. - property specifies the name of a peer that created the peer-to-peer networking session, and which is considered the host of the session. The host of a peer-to-peer networking session may collect peers into more than one . Also, a peer may simultaneously be hosted by more than one peer host. - + property specifies the name of a peer that created the peer-to-peer networking session, and which is considered the host of the session. The host of a peer-to-peer networking session may collect peers into more than one . Also, a peer may simultaneously be hosted by more than one peer host. + ]]> @@ -620,11 +620,11 @@ Returns a string representation of the current object. A string that represents the current , and specified in the following format: *Authority.Classifier*. For example, "0.MyInternetPeer". - . - + . + ]]> diff --git a/xml/System.Net.PeerToPeer/PeerNameResolver.xml b/xml/System.Net.PeerToPeer/PeerNameResolver.xml index 88c6bc561e0..ae4b7147db9 100644 --- a/xml/System.Net.PeerToPeer/PeerNameResolver.xml +++ b/xml/System.Net.PeerToPeer/PeerNameResolver.xml @@ -17,11 +17,11 @@ Specifies the values that resolve a to a using the PNRP Namespace Provider API protocol. - which contains all the information for the that was published in the or cloud(s) that were queried during the resolve process. - + contains all the information for the that was published in the or cloud(s) that were queried during the resolve process. + ]]> @@ -42,11 +42,11 @@ Initializes a new default instance of the class. - , the contains all the information for the specified that was published in the cloud(s) that were queried during the operation. - + , the contains all the information for the specified that was published in the cloud(s) that were queried during the operation. + ]]> @@ -74,13 +74,13 @@ The object that contains the data returned by the event. Returns peer resolution data after the event is raised. - event is raised by the peer resolver object. - + event is raised by the peer resolver object. + ]]> @@ -110,13 +110,13 @@ object that contains peer name resolution progress information returned by the event. Returns peer resolution progress data when the event is raised. - event occurs. - + event occurs. + ]]> @@ -132,17 +132,17 @@ Resolves a object to a using the PNRP protocol. - method is similar to calling the method for each peer name record in the . Note that using the Resolve method on an individual peer name record does not invalidate resolving multiple peer names. - - For every method, there is an equivalent method. They are identical in the parameters they are passed, except that the ResolveAsync method includes a system token in its parameter list for asynchronous event handling. - - If the parameter is not supplied, the method uses the shortcut to fill in cloud parameters. If the `maxRecords` parameter is missing, the default value of zero causes an exception to be thrown. - - This event will also be raised if the resolve operation completes in error or is canceled. - + method is similar to calling the method for each peer name record in the . Note that using the Resolve method on an individual peer name record does not invalidate resolving multiple peer names. + + For every method, there is an equivalent method. They are identical in the parameters they are passed, except that the ResolveAsync method includes a system token in its parameter list for asynchronous event handling. + + If the parameter is not supplied, the method uses the shortcut to fill in cloud parameters. If the `maxRecords` parameter is missing, the default value of zero causes an exception to be thrown. + + This event will also be raised if the resolve operation completes in error or is canceled. + ]]> @@ -172,28 +172,28 @@ Resolves the specified in all clouds known to the calling peer. A that contains all peer name records (represented as objects) associated with the specified peer name. For unsecured peer names, the same can be registered by different users in the same , and associated with different endpoints. - . If the peer name cannot be resolved or is `null`, an is thrown. - - For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud. - - Calling the method is similar to calling the method for each peer name record in the . Note that using the Resolve method on an individual peer name record does not invalidate resolving multiple peer names. - - For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling. - - If the parameter is not supplied, the method uses the shortcut to fill in cloud parameters. - - The event will be raised if the resolve operation completes in error or is canceled. - - - -## Examples - The following code example illustrates how to resolve a published in any . - - :::code language="csharp" source="~/snippets/csharp/System.Net.PeerToPeer/PeerNameResolver/Resolve/PeerNameResolver.cs" id="Snippet1"::: - + . If the peer name cannot be resolved or is `null`, an is thrown. + + For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud. + + Calling the method is similar to calling the method for each peer name record in the . Note that using the Resolve method on an individual peer name record does not invalidate resolving multiple peer names. + + For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling. + + If the parameter is not supplied, the method uses the shortcut to fill in cloud parameters. + + The event will be raised if the resolve operation completes in error or is canceled. + + + +## Examples + The following code example illustrates how to resolve a published in any . + + :::code language="csharp" source="~/snippets/csharp/System.Net.PeerToPeer/PeerNameResolver/Resolve/PeerNameResolver.cs" id="Snippet1"::: + ]]> The parameter is set to . @@ -227,15 +227,15 @@ Resolves the specified peer name in all clouds known to the calling peer, returning no more than the specified number of objects. A whose size is less than or equal to entries. This collection contains peer name records associated with the that was resolved. - , and associated with different endpoints. If the cannot be resolved (for example, the peer name is not published) an is thrown. - - For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling. - - The event will be raised if the resolve operation completes in error or is canceled. - + , and associated with different endpoints. If the cannot be resolved (for example, the peer name is not published) an is thrown. + + For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling. + + The event will be raised if the resolve operation completes in error or is canceled. + ]]> The parameter is set to . @@ -270,19 +270,19 @@ that contains all peer name records (represented as objects) associated with the specified peer name. For unsecured peer names, the same can be registered by different users in the same , and associated with different endpoints. - cannot be resolved (that is, the peer name is not published) an is thrown. - - For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud. - - For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling. - - If the parameter is `null`, the uses the shortcut to fill in the , , and . - - The event will be raised if the resolve operation completes in error or is canceled. - + cannot be resolved (that is, the peer name is not published) an is thrown. + + For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud. + + For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling. + + If the parameter is `null`, the uses the shortcut to fill in the , , and . + + The event will be raised if the resolve operation completes in error or is canceled. + ]]> The parameter is set to . @@ -323,17 +323,17 @@ Resolves the specified in the specified , returning no more than the specified number of objects. A whose size is less than or equal to entries. This collection contains peer name records associated with the that was resolved. - is thrown. - - For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling. - - If the parameter is `null`, the uses the shortcut to fill in the , , and . - - The event will be raised if the resolve operation completes in error or is canceled. - + is thrown. + + For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling. + + If the parameter is `null`, the uses the shortcut to fill in the , , and . + + The event will be raised if the resolve operation completes in error or is canceled. + ]]> The parameter is set to . @@ -349,13 +349,13 @@ These methods begin an asynchronous resolution operation for the specified in all clouds known to the calling peer. - method, there is an equivalent method, which is used when asynchronous processing is required. They are identical in the parameters they are passed, except that ResolveAsync includes a system token in its parameter list for event handling. - - If a parameter mismatch occurs between the Resolve method and the ResolveAsync method, and the parameter is not supplied, the method uses the shortcut to fill in cloud parameters. - + method, there is an equivalent method, which is used when asynchronous processing is required. They are identical in the parameters they are passed, except that ResolveAsync includes a system token in its parameter list for event handling. + + If a parameter mismatch occurs between the Resolve method and the ResolveAsync method, and the parameter is not supplied, the method uses the shortcut to fill in cloud parameters. + ]]> @@ -385,23 +385,23 @@ A user-defined object that contains state information about the peer name resolution operation. Begins an asynchronous peer name resolution operation for the specified in all clouds known to the calling peer. - . It raises the event, which calls back to the method. Or, it raises the event, which calls back to the method. - - If the peer name cannot be resolved, an is thrown. - - For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud. - - Calling the method is similar to calling the method for each peer name record in the . Note that using the Resolve method on an individual peer name record does not invalidate resolving multiple peer names. - - For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing. - - All asynchronous references to the resolver object are coordinated with a unique identifier token. This `userState` token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue. - - The event will be raised if the resolve operation completes in error or is canceled. - + . It raises the event, which calls back to the method. Or, it raises the event, which calls back to the method. + + If the peer name cannot be resolved, an is thrown. + + For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud. + + Calling the method is similar to calling the method for each peer name record in the . Note that using the Resolve method on an individual peer name record does not invalidate resolving multiple peer names. + + For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing. + + All asynchronous references to the resolver object are coordinated with a unique identifier token. This `userState` token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue. + + The event will be raised if the resolve operation completes in error or is canceled. + ]]> One or both of the and parameters are set to . @@ -434,19 +434,19 @@ A user-defined object that contains information about the resolve operation. Begins an asynchronous peer name resolution operation for the specified in all clouds known to the calling peer, returning no more than entries for the peer name. - . For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud. If the peer name cannot be resolved or is `null`, an is thrown. - - This method raises the event, which calls back to the method. Or, it raises the event, which calls back to the method. - - For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing. - - All asynchronous references to the resolver object are coordinated with a unique identifier token . This `userState` token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue. - - The event will be raised if the resolve operation completes in error or is canceled. - + . For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud. If the peer name cannot be resolved or is `null`, an is thrown. + + This method raises the event, which calls back to the method. Or, it raises the event, which calls back to the method. + + For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing. + + All asynchronous references to the resolver object are coordinated with a unique identifier token . This `userState` token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue. + + The event will be raised if the resolve operation completes in error or is canceled. + ]]> One or both of the and parameters are set to . @@ -486,21 +486,21 @@ A user-defined that contains information about the peer name resolution operation. Begins an asynchronous peer name resolution operation for the specified in the specified . - event, which calls back to the method. Or, it raises the event, which calls back to the method. - - For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud. - - If the parameter is `null`, the name is resolved using the shortcut, which initializes default values for the , , and properties. - - For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing. - - All asynchronous references to the resolver object are coordinated with a unique identifier token. This `userState` token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue. - - The event will be raised if the resolve operation completes in error or is canceled. - + event, which calls back to the method. Or, it raises the event, which calls back to the method. + + For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud. + + If the parameter is `null`, the name is resolved using the shortcut, which initializes default values for the , , and properties. + + For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing. + + All asynchronous references to the resolver object are coordinated with a unique identifier token. This `userState` token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue. + + The event will be raised if the resolve operation completes in error or is canceled. + ]]> One or both of the and parameters are set to . @@ -541,21 +541,21 @@ A user-defined object that contains information about the peer name resolution operation. Begins an asynchronous peer name resolution operation for the specified in the specified . The resolution operation will resolve no more than entries for the specified peer name. - event, which calls back to the method. Or, it raises the event, which calls back to the method. - - If the parameter is `null`, the name is resolved using the shortcut, which initializes default values for the , , and properties. - - For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing. - - All asynchronous references to the peer resolver object are coordinated with a unique identifier token . This `userState` token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue. - - The event will be raised if the resolve operation completes in error or is canceled. - + event, which calls back to the method. Or, it raises the event, which calls back to the method. + + If the parameter is `null`, the name is resolved using the shortcut, which initializes default values for the , , and properties. + + For every method, there is an equivalent method. Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing. + + All asynchronous references to the peer resolver object are coordinated with a unique identifier token . This `userState` token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue. + + The event will be raised if the resolve operation completes in error or is canceled. + ]]> One or both of the and parameters are set to . @@ -590,20 +590,20 @@ - The object provided to the method instance which started the resolve operation. + The object provided to the method instance that started the resolve operation. Cancels the specified asynchronous peer name resolution request. - . If this method is called when an asynchronous peer name resolution operation is not outstanding, it acts as a "no operation" (NO OP). - - The `userState` object must be provided since it is used to track a specific asynchronous call when multiple calls are in progress. This caller-supplied object is unique for each peer name resolution request. - - This method will return immediately, but the operation may or may not immediately cancel. The event arguments returned by the event contains a field which can be polled by clients to determine whether cancellation occurred. - - Calling this method ensures the ResolveCompleted event will be signaled as soon as possible with the event argument set to `true`. - + . If this method is called when an asynchronous peer name resolution operation is not outstanding, it acts as a "no operation" (NO OP). + + The `userState` object must be provided since it is used to track a specific asynchronous call when multiple calls are in progress. This caller-supplied object is unique for each peer name resolution request. + + This method will return immediately, but the operation may or may not immediately cancel. The event arguments returned by the event contains a field that can be polled by clients to determine whether cancellation occurred. + + Calling this method ensures the ResolveCompleted event will be signaled as soon as possible with the event argument set to `true`. + ]]> The parameters cannot be . @@ -629,13 +629,13 @@ The event is signaled when a peer name resolution request for a specific has completed. - event will be raised once for each endpoint found, and this event will be raised only once when all endpoints have been found. - - This event will also be raised if the operation completes in error or is canceled. - + event will be raised once for each endpoint found, and this event will be raised only once when all endpoints have been found. + + This event will also be raised if the operation completes in error or is canceled. + ]]> @@ -660,11 +660,11 @@ This event is signaled whenever a object is found in response to a operation for a specific . - objects exist in the cloud(s) being queried, this event is signaled once for each found. - + objects exist in the cloud(s) being queried, this event is signaled once for each found. + ]]> diff --git a/xml/System.Net.Security/SslStream.xml b/xml/System.Net.Security/SslStream.xml index 944a2665473..e3d5e7e34cb 100644 --- a/xml/System.Net.Security/SslStream.xml +++ b/xml/System.Net.Security/SslStream.xml @@ -4345,8 +4345,8 @@ Authentication has not occurred. System.Net.Security.TlsCipherSuite - Gets the cipher suite which was negotiated for this connection. - One of the enumeration values that identifies the cipher suite which was negotiated for this connection. + Gets the cipher suite that was negotiated for this connection. + One of the enumeration values that identifies the cipher suite that was negotiated for this connection. instance with data ga ## Remarks The property indicates whether a is in blocking mode. - If you are in blocking mode, and you make a method call which does not complete immediately, your application will block execution until the requested operation completes. If you want execution to continue even though the requested operation is not complete, change the property to `false`. The property has no effect on asynchronous methods. If you are sending and receiving data asynchronously and want to block execution, use the class. + If you are in blocking mode, and you make a method call that does not complete immediately, your application will block execution until the requested operation completes. If you want execution to continue even though the requested operation is not complete, change the property to `false`. The property has no effect on asynchronous methods. If you are sending and receiving data asynchronously and want to block execution, use the class. > [!NOTE] > If you receive a , use the property to obtain the specific error code. After you have obtained this code, refer to the [Windows Sockets version 2 API error code](/windows/desktop/winsock/windows-sockets-error-codes-2) documentation for a detailed description of the error. @@ -4114,7 +4114,7 @@ This method populates the instance with data ga - - Optionally, a buffer may be provided which will atomically be sent on the socket after the method succeeds. In this case, the property needs to be set to the buffer containing the data to send and the property needs to be set to the number of bytes of data to send from the buffer. Once a connection is established, this buffer of data is sent. + Optionally, a buffer may be provided that will atomically be sent on the socket after the method succeeds. In this case, the property needs to be set to the buffer containing the data to send and the property needs to be set to the number of bytes of data to send from the buffer. Once a connection is established, this buffer of data is sent. If you are using a connection-oriented protocol and do not call before calling , the underlying service provider will assign the most appropriate local network address and port number. @@ -4530,7 +4530,7 @@ This method populates the instance with data ga - - Optionally, a buffer may be provided which will atomically be sent on the socket after the method succeeds. In this case, the property needs to be set to the buffer containing the data to send and the property needs to be set to the number of bytes of data to send from the buffer. Once a connection is established, this buffer of data is sent. + Optionally, a buffer may be provided that will atomically be sent on the socket after the method succeeds. In this case, the property needs to be set to the buffer containing the data to send and the property needs to be set to the number of bytes of data to send from the buffer. Once a connection is established, this buffer of data is sent. If you are using a connection-oriented protocol and do not call before calling , the underlying service provider will assign the most appropriate local network address and port number. diff --git a/xml/System.Net/HttpListener.xml b/xml/System.Net/HttpListener.xml index de0f849841a..dc75a7b863c 100644 --- a/xml/System.Net/HttpListener.xml +++ b/xml/System.Net/HttpListener.xml @@ -748,7 +748,7 @@ The following code example demonstrates calling the `Close` method: For each request, the delegate can choose the settings that the instance will use to provide extended protection. - If a delegate returns `null` for this property, this represents a which the property set to . + If a delegate returns `null` for this property, this represents a that the property set to . ]]> diff --git a/xml/System.Net/HttpListenerRequest.xml b/xml/System.Net/HttpListenerRequest.xml index 507b96a7a5e..8c27840d77c 100644 --- a/xml/System.Net/HttpListenerRequest.xml +++ b/xml/System.Net/HttpListenerRequest.xml @@ -1661,9 +1661,9 @@ property can be used to retrieve the channel binding token (CBT) for an which was sent using HTTPS. + The property can be used to retrieve the channel binding token (CBT) for an that was sent using HTTPS. - An application could use the property to perform custom authentication using calls to the native Win32 [AcceptSecurityContext](https://go.microsoft.com/fwlink/?LinkId=147021) function. + An application could use the property to perform custom authentication using calls to the native Win32 [AcceptSecurityContext](/windows/win32/api/sspi/nf-sspi-acceptsecuritycontext) function. If an application attempts to retrieve the channel binding token (CBT) from this property using the method and the is not , then the will throw . The overrides the method with an internal implementation.