Networking System [00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ] 1.0.x.x 1.0.5000.0 2.0.0.0 4.0.0.0 All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe. System.Object

The class handles connections to an Internet resource based on the host information passed in the resource's Uniform Resource Identifier (URI). The initial connection to the resource determines the information that the object maintains, which is then shared by all subsequent requests to that resource.

objects are managed by the class and are created, if necessary, by the method. objects are never created directly but are always created and managed by the class. The maximum number of objects that can be created is set by the property.

Each object maintains its connection to an Internet resource until it has been idle longer than the time specified in the property. When a exceeds the value, it can be recycled to another connection. The default value of is set by the property.

When the property is set to a value other than -1, and after the specified time elapses, an active connection is closed after it services the next request. This is useful for applications that do not require active connections that are opened indefinitely, as they are by default.

In high load conditions, some applications may run out of free threads in the ThreadPool, which may lead to poor system performance (such as high and variable transaction times). See http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnpag/html/scalenetchapt17.asp for a number of configuration changes you can make to fix this issue.

Provides connection management for HTTP connections.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Uri

  A instance representing the URI specified at the time the current instance was constructed

  This property is read-only.

  The property of the returned by this property names the host to which the current instance connects.

  Gets the Uniform Resource Identifier (URI) of the server that this object connects to.

  0
- Property
  2.0.0.0
  4.0.0.0
  System.Net.BindIPEndPoint To be added.

  Some load balancing techniques require a client to use a specific local IP address and port number, rather than (or for Internet Protocol Version 6) and an ephemeral port. Your can satisfy this requirement.

  Specifies the delegate to associate a local with a .

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Security.Cryptography.X509Certificates.X509Certificate To be added.

  Although a object can make multiple connections to an Internet resource, it can maintain only one certificate.

  Gets the certificate received for this object.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Security.Cryptography.X509Certificates.X509Certificate To be added. To be added.

  Gets the last client certificate sent to the server.

- Method
  2.0.0.0
  4.0.0.0
  System.Boolean ``

  Connection groups associate a set of requests with a particular connection or set of connections. This method removes and closes all connections that belong to the specified connection group.

  Removes the specified connection group from this object.

  A value that indicates whether the connection group was closed.

  The name of the connection group that contains the connections to close and remove from this service point.
- Property
  2.0.0.0
  4.0.0.0
  System.MonoTODO
  System.Int32 To be added.

  You can use this property to ensure that a object's active connections do not remain open indefinitely. This property is intended for scenarios where connections should be dropped and reestablished periodically, such as load balancing scenarios.

  By default, when is true for a request, the property sets the time-out for closing connections due to inactivity. If the has active connections, has no effect and the connections remain open indefinitely.

  When the property is set to a value other than -1, and after the specified time elapses, an active connection is closed after servicing a request by setting to false in that request.

  Setting this value affects all connections managed by the object.

  Gets or sets the number of milliseconds after which an active connection is closed.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32

  A containing the maximum number of simultaneous connections allowed on the current .

  The value specified for a set operation is less than or equal to zero.

  The property sets the maximum number of connections that the object can make to an Internet resource. The value of the property is set to the value of the property when the object is created; subsequent changes to have no effect on existing objects.

  Gets or sets the maximum number of connections allowed on this object.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String

  A containing the value of the property of the that initiated the connection provided by the current instance.

  If the object was constructed with a object (the or methods, for example), then the property represents the property of the object used.

  If the object was constructed from a network host and port, the property contains a string that represents the host and the network port. If the property is set when constructed from a host and port, only objects with the same value can use this object.

  Gets the connection name.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32 A containing the number of connections held by the current instance.

  The property contains the number of open Internet connections associated with this object. The value of cannot exceed that of .

  Gets the number of open connections associated with this object.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean To be added.

  When this property is set to true, client requests that use the POST method expect to receive a 100-Continue response from the server to indicate that the client should send the data to be posted. This mechanism allows clients to avoid sending large amounts of data over the network when the server, based on the request headers, intends to reject the request.

  For example, assume the property is false. When the request is sent to the server, it includes the data. If, after reading the request headers, the server requires authentication and sends a 401 response, the client must resend the data with proper authentication headers.

  If the property is true, the request headers are sent to the server. If the server has not rejected the request, it sends a 100-Continue response signaling that the data can be transmitted. If, as in the preceding example, the server requires authentication, it sends the 401 response and the client has not unnecessarily transmitted the data.

  Changing the value of this property does not affect existing connections. Only new connections created after the change are affected.

  The Expect 100-Continue behavior is fully described in IETF RFC 2616 Section 10.1.1.

  Gets or sets a value that determines whether 100-Continue behavior is used.

- Method
  System.Int32

  The method returns a hash code of this instance. This value can be used as a key in hash tables.

  Returns a hash value for a instance.

  An integer hash value.

  0
  1.0.5000.0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.DateTime

  A instance containing the date and time at which the was last connected.

  The property records the last date and time at which a service point was disconnected from a host. When the difference between the current time and exceeds the value of , the object is available for recycling to another connection.

  Gets the date and time that the object was last connected to a host.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32

  A containing the number of milliseconds that a can remain idle before it is released by the and subsequently freed.

  The value specified for a set operation is less than or greater than .

  You can set to to indicate that a connection associated with the object should never time out.

  The default value of the property is the value of the property when the object is created. Subsequent changes to the property have no effect on existing objects.

  When the for a connection associated with a is exceeded, the connection remains open until the application tries to use the connection. At that time, the Framework closes the connection and creates a new connection to the remote host.

  Gets or sets the amount of time a connection associated with the object can remain idle before the connection is closed.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Version

  A instance containing the version of the protocol used by the .

  The HTTP protocol versions are HTTP/1.0 and HTTP/1.1.

  Gets the version of the HTTP protocol that the object uses.

  0
- Property
  2.0.0.0
  4.0.0.0
  System.MonoTODO
  System.Int32 To be added.

  For additional information, see .

  Gets or sets the size of the receiving buffer for the socket used by this .

- Method
  4.0.0.0
  System.Void `` `` ``

  An application can request that a TCP/IP provider enable the use of keep-alive packets on a TCP connection. The default is that the use of keep-alive packets on a TCP connection is disabled.

  The default settings when a TCP socket is initialized sets the keep-alive timeout to 2 hours and the keep-alive interval to 1 second. The parameter specifies the timeout, in milliseconds, with no activity until the first keep-alive packet is sent. The parameter specifies the interval, in milliseconds, between when successive keep-alive packets are sent if no acknowledgement is received. The number of keep-alive probes cannot be changed and is set to 10.

  If a TCP connection is dropped as the result of keep-alives, a of is returned to any calls in progress on the socket, and any subsequent calls will fail with a of .

  Enables or disables the keep-alive option on a TCP connection.

  If set to true, then the TCP keep-alive option on a TCP connection will be enabled using the specified and values. Specifies the timeout, in milliseconds, with no activity until the first keep-alive packet is sent. Specifies the interval, in milliseconds, between when successive keep-alive packets are sent if no acknowledgement is received.
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean

  if the supports pipelined connections; otherwise, .

  Pipelining allows clients to send multiple requests across a persistent connection without waiting for each response from the server. The server sends the responses in the same order as the requests were received.

  Pipelining is described in detail in IETF RFC 2616 section 8.1.2.2.

  Indicates whether the object supports pipelined connections.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean To be added.

  The Nagle algorithm is used to buffer small packets of data and transmit them as a single packet. This process, referred to as "nagling," is widely used because it reduces the number of packets transmitted and lowers the overhead per packet.

  Changing the value of this property does not affect existing connections. Only new connections created after the change are affected.

  The Nagle algorithm is fully described in IETF RFC 896.

  Gets or sets a value that determines whether the Nagle algorithm is used on connections managed by this object.

0