1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.Net.ServicePoint</name>
6 <member name="T:System.Net.BindIPEndPoint">
7 <summary>Represents the method that specifies a local Internet Protocol address and port number for a <see cref="T:System.Net.ServicePoint"></see>.</summary>
8 <param name="servicePoint">The <see cref="T:System.Net.ServicePoint"></see> associated with the connection to be created.</param>
9 <param name="remoteEndPoint">The remote <see cref="T:System.Net.IPEndPoint"></see> that specifies the remote host.</param>
10 <param name="retryCount">The number of times this delegate was called for a specified connection.</param>
11 <returns>The local <see cref="System.Net.IPEndPoint"></see> to which the <see cref="System.Net.ServicePoint"></see> is bound.</returns>
13 <member name="T:System.Net.SecurityProtocolType">
14 <summary>Specifies the security protocols that are supported by the Schannel security package.</summary>
16 <member name="F:System.Net.SecurityProtocolType.Ssl3">
17 <summary>Specifies the Secure Socket Layer (SSL) 3.0 security protocol.</summary>
20 <member name="F:System.Net.SecurityProtocolType.SystemDefault">
21 <summary>Allows the operating system to choose the best protocol to use, and to block protocols that are not secure. Unless your app has a specific reason not to, you should use this value.</summary>
24 <member name="F:System.Net.SecurityProtocolType.Tls">
25 <summary>Specifies the Transport Layer Security (TLS) 1.0 security protocol.</summary>
28 <member name="F:System.Net.SecurityProtocolType.Tls11">
29 <summary>Specifies the Transport Layer Security (TLS) 1.1 security protocol.</summary>
32 <member name="F:System.Net.SecurityProtocolType.Tls12">
33 <summary>Specifies the Transport Layer Security (TLS) 1.2 security protocol.</summary>
36 <member name="T:System.Net.ServicePoint">
37 <summary>Provides connection management for HTTP connections.</summary>
39 <member name="P:System.Net.ServicePoint.Address">
40 <summary>Gets the Uniform Resource Identifier (URI) of the server that this <see cref="T:System.Net.ServicePoint"></see> object connects to.</summary>
41 <returns>An instance of the <see cref="System.Uri"></see> class that contains the URI of the Internet server that this <see cref="System.Net.ServicePoint"></see> object connects to.</returns>
42 <exception cref="T:System.NotSupportedException">The <see cref="System.Net.ServicePoint"></see> is in host mode.</exception>
44 <member name="P:System.Net.ServicePoint.BindIPEndPointDelegate">
45 <summary>Specifies the delegate to associate a local <see cref="T:System.Net.IPEndPoint"></see> with a <see cref="T:System.Net.ServicePoint"></see>.</summary>
46 <returns>A delegate that forces a <see cref="System.Net.ServicePoint"></see> to use a particular local Internet Protocol (IP) address and port number. The default value is null.</returns>
48 <member name="P:System.Net.ServicePoint.Certificate">
49 <summary>Gets the certificate received for this <see cref="T:System.Net.ServicePoint"></see> object.</summary>
50 <returns>An instance of the <see cref="System.Security.Cryptography.X509Certificates.X509Certificate"></see> class that contains the security certificate received for this <see cref="System.Net.ServicePoint"></see> object.</returns>
52 <member name="P:System.Net.ServicePoint.ClientCertificate">
53 <summary>Gets the last client certificate sent to the server.</summary>
54 <returns>An <see cref="System.Security.Cryptography.X509Certificates.X509Certificate"></see> object that contains the public values of the last client certificate sent to the server.</returns>
56 <member name="M:System.Net.ServicePoint.CloseConnectionGroup(System.String)">
57 <summary>Removes the specified connection group from this <see cref="T:System.Net.ServicePoint"></see> object.</summary>
58 <param name="connectionGroupName">The name of the connection group that contains the connections to close and remove from this service point.</param>
59 <returns>A <see cref="System.Boolean"></see> value that indicates whether the connection group was closed.</returns>
61 <member name="P:System.Net.ServicePoint.ConnectionLeaseTimeout">
62 <summary>Gets or sets the number of milliseconds after which an active <see cref="T:System.Net.ServicePoint"></see> connection is closed.</summary>
63 <returns>A <see cref="System.Int32"></see> that specifies the number of milliseconds that an active <see cref="System.Net.ServicePoint"></see> connection remains open. The default is -1, which allows an active <see cref="System.Net.ServicePoint"></see> connection to stay connected indefinitely. Set this property to 0 to force <see cref="System.Net.ServicePoint"></see> connections to close after servicing a request.</returns>
64 <exception cref="T:System.ArgumentOutOfRangeException">The value specified for a set operation is a negative number less than -1.</exception>
66 <member name="P:System.Net.ServicePoint.ConnectionLimit">
67 <summary>Gets or sets the maximum number of connections allowed on this <see cref="T:System.Net.ServicePoint"></see> object.</summary>
68 <returns>The maximum number of connections allowed on this <see cref="System.Net.ServicePoint"></see> object.</returns>
69 <exception cref="T:System.ArgumentOutOfRangeException">The connection limit is equal to or less than 0.</exception>
71 <member name="P:System.Net.ServicePoint.ConnectionName">
72 <summary>Gets the connection name.</summary>
73 <returns>A <see cref="System.String"></see> that represents the connection name.</returns>
75 <member name="P:System.Net.ServicePoint.CurrentConnections">
76 <summary>Gets the number of open connections associated with this <see cref="T:System.Net.ServicePoint"></see> object.</summary>
77 <returns>The number of open connections associated with this <see cref="System.Net.ServicePoint"></see> object.</returns>
79 <member name="P:System.Net.ServicePoint.Expect100Continue">
80 <summary>Gets or sets a <see cref="T:System.Boolean"></see> value that determines whether 100-Continue behavior is used.</summary>
81 <returns>true to expect 100-Continue responses for POST requests; otherwise, false. The default value is true.</returns>
83 <member name="P:System.Net.ServicePoint.IdleSince">
84 <summary>Gets the date and time that the <see cref="T:System.Net.ServicePoint"></see> object was last connected to a host.</summary>
85 <returns>A <see cref="System.DateTime"></see> object that contains the date and time at which the <see cref="System.Net.ServicePoint"></see> object was last connected.</returns>
87 <member name="P:System.Net.ServicePoint.MaxIdleTime">
88 <summary>Gets or sets the amount of time a connection associated with the <see cref="T:System.Net.ServicePoint"></see> object can remain idle before the connection is closed.</summary>
89 <returns>The length of time, in milliseconds, that a connection associated with the <see cref="System.Net.ServicePoint"></see> object can remain idle before it is closed and reused for another connection.</returns>
90 <exception cref="T:System.ArgumentOutOfRangeException"><see cref="System.Net.ServicePoint.MaxIdleTime"></see> is set to less than <see cref="System.Threading.Timeout.Infinite"></see> or greater than <see cref="System.Int32.MaxValue"></see>.</exception>
92 <member name="P:System.Net.ServicePoint.ProtocolVersion">
93 <summary>Gets the version of the HTTP protocol that the <see cref="T:System.Net.ServicePoint"></see> object uses.</summary>
94 <returns>A <see cref="System.Version"></see> object that contains the HTTP protocol version that the <see cref="System.Net.ServicePoint"></see> object uses.</returns>
96 <member name="P:System.Net.ServicePoint.ReceiveBufferSize">
97 <summary>Gets or sets the size of the receiving buffer for the socket used by this <see cref="T:System.Net.ServicePoint"></see>.</summary>
98 <returns>A <see cref="System.Int32"></see> that contains the size, in bytes, of the receive buffer. The default is 8192.</returns>
99 <exception cref="T:System.ArgumentOutOfRangeException">The value specified for a set operation is greater than <see cref="System.Int32.MaxValue"></see>.</exception>
101 <member name="M:System.Net.ServicePoint.SetTcpKeepAlive(System.Boolean,System.Int32,System.Int32)">
102 <summary>Enables or disables the keep-alive option on a TCP connection.</summary>
103 <param name="enabled">If set to true, then the TCP keep-alive option on a TCP connection will be enabled using the specified keepAliveTime and keepAliveInterval values.
104 If set to false, then the TCP keep-alive option is disabled and the remaining parameters are ignored.
105 The default value is false.</param>
106 <param name="keepAliveTime">Specifies the timeout, in milliseconds, with no activity until the first keep-alive packet is sent.
107 The value must be greater than 0. If a value of less than or equal to zero is passed an <see cref="T:System.ArgumentOutOfRangeException"></see> is thrown.</param>
108 <param name="keepAliveInterval">Specifies the interval, in milliseconds, between when successive keep-alive packets are sent if no acknowledgement is received.
109 The value must be greater than 0. If a value of less than or equal to zero is passed an <see cref="T:System.ArgumentOutOfRangeException"></see> is thrown.</param>
110 <exception cref="T:System.ArgumentOutOfRangeException">The value specified for <paramref name="keepAliveTime">keepAliveTime</paramref> or <paramref name="keepAliveInterval">keepAliveInterval</paramref> parameter is less than or equal to 0.</exception>
112 <member name="P:System.Net.ServicePoint.SupportsPipelining">
113 <summary>Indicates whether the <see cref="T:System.Net.ServicePoint"></see> object supports pipelined connections.</summary>
114 <returns>true if the <see cref="System.Net.ServicePoint"></see> object supports pipelined connections; otherwise, false.</returns>
116 <member name="P:System.Net.ServicePoint.UseNagleAlgorithm">
117 <summary>Gets or sets a <see cref="T:System.Boolean"></see> value that determines whether the Nagle algorithm is used on connections managed by this <see cref="T:System.Net.ServicePoint"></see> object.</summary>
118 <returns>true to use the Nagle algorithm; otherwise, false. The default value is true.</returns>
120 <member name="T:System.Net.ServicePointManager">
121 <summary>Manages the collection of <see cref="T:System.Net.ServicePoint"></see> objects.</summary>
123 <member name="P:System.Net.ServicePointManager.CheckCertificateRevocationList">
124 <summary>Gets or sets a <see cref="T:System.Boolean"></see> value that indicates whether the certificate is checked against the certificate authority revocation list.</summary>
125 <returns>true if the certificate revocation list is checked; otherwise, false.</returns>
127 <member name="P:System.Net.ServicePointManager.DefaultConnectionLimit">
128 <summary>Gets or sets the maximum number of concurrent connections allowed by a <see cref="T:System.Net.ServicePoint"></see> object.</summary>
129 <returns>The maximum number of concurrent connections allowed by a <see cref="System.Net.ServicePoint"></see> object. The default value is 2. When an app is running as an ASP.NET host, it is not possible to alter the value of this property through the config file if the autoConfig property is set to true. However, you can change the value programmatically when the autoConfig property is true. Set your preferred value once, when the AppDomain loads.</returns>
130 <exception cref="T:System.ArgumentOutOfRangeException"><see cref="System.Net.ServicePointManager.DefaultConnectionLimit"></see> is less than or equal to 0.</exception>
132 <member name="F:System.Net.ServicePointManager.DefaultNonPersistentConnectionLimit">
133 <summary>The default number of non-persistent connections (4) allowed on a <see cref="T:System.Net.ServicePoint"></see> object connected to an HTTP/1.0 or later server. This field is constant but is no longer used in the .NET Framework 2.0.</summary>
136 <member name="F:System.Net.ServicePointManager.DefaultPersistentConnectionLimit">
137 <summary>The default number of persistent connections (2) allowed on a <see cref="T:System.Net.ServicePoint"></see> object connected to an HTTP/1.1 or later server. This field is constant and is used to initialize the <see cref="P:System.Net.ServicePointManager.DefaultConnectionLimit"></see> property if the value of the <see cref="P:System.Net.ServicePointManager.DefaultConnectionLimit"></see> property has not been set either directly or through configuration.</summary>
140 <member name="P:System.Net.ServicePointManager.DnsRefreshTimeout">
141 <summary>Gets or sets a value that indicates how long a Domain Name Service (DNS) resolution is considered valid.</summary>
142 <returns>The time-out value, in milliseconds. A value of -1 indicates an infinite time-out period. The default value is 120,000 milliseconds (two minutes).</returns>
144 <member name="P:System.Net.ServicePointManager.EnableDnsRoundRobin">
145 <summary>Gets or sets a value that indicates whether a Domain Name Service (DNS) resolution rotates among the applicable Internet Protocol (IP) addresses.</summary>
146 <returns>false if a DNS resolution always returns the first IP address for a particular host; otherwise true. The default is false.</returns>
148 <member name="P:System.Net.ServicePointManager.EncryptionPolicy">
149 <summary>Gets the <see cref="T:System.Net.Security.EncryptionPolicy"></see> for this <see cref="T:System.Net.ServicePointManager"></see> instance.</summary>
150 <returns>The encryption policy to use for this <see cref="System.Net.ServicePointManager"></see> instance.</returns>
152 <member name="P:System.Net.ServicePointManager.Expect100Continue">
153 <summary>Gets or sets a <see cref="T:System.Boolean"></see> value that determines whether 100-Continue behavior is used.</summary>
154 <returns>true to enable 100-Continue behavior. The default value is true.</returns>
156 <member name="M:System.Net.ServicePointManager.FindServicePoint(System.Uri,System.Net.IWebProxy)">
157 <summary>Finds an existing <see cref="T:System.Net.ServicePoint"></see> object or creates a new <see cref="T:System.Net.ServicePoint"></see> object to manage communications with the specified <see cref="T:System.Uri"></see> object.</summary>
158 <param name="address">A <see cref="T:System.Uri"></see> object that contains the address of the Internet resource to contact.</param>
159 <param name="proxy">The proxy data for this request.</param>
160 <returns>The <see cref="System.Net.ServicePoint"></see> object that manages communications for the request.</returns>
161 <exception cref="T:System.ArgumentNullException"><paramref name="address">address</paramref> is null.</exception>
162 <exception cref="T:System.InvalidOperationException">The maximum number of <see cref="System.Net.ServicePoint"></see> objects defined in <see cref="System.Net.ServicePointManager.MaxServicePoints"></see> has been reached.</exception>
164 <member name="M:System.Net.ServicePointManager.FindServicePoint(System.Uri)">
165 <summary>Finds an existing <see cref="T:System.Net.ServicePoint"></see> object or creates a new <see cref="T:System.Net.ServicePoint"></see> object to manage communications with the specified <see cref="T:System.Uri"></see> object.</summary>
166 <param name="address">The <see cref="T:System.Uri"></see> object of the Internet resource to contact.</param>
167 <returns>The <see cref="System.Net.ServicePoint"></see> object that manages communications for the request.</returns>
168 <exception cref="T:System.ArgumentNullException"><paramref name="address">address</paramref> is null.</exception>
169 <exception cref="T:System.InvalidOperationException">The maximum number of <see cref="System.Net.ServicePoint"></see> objects defined in <see cref="System.Net.ServicePointManager.MaxServicePoints"></see> has been reached.</exception>
171 <member name="M:System.Net.ServicePointManager.FindServicePoint(System.String,System.Net.IWebProxy)">
172 <summary>Finds an existing <see cref="T:System.Net.ServicePoint"></see> object or creates a new <see cref="T:System.Net.ServicePoint"></see> object to manage communications with the specified Uniform Resource Identifier (URI).</summary>
173 <param name="uriString">The URI of the Internet resource to be contacted.</param>
174 <param name="proxy">The proxy data for this request.</param>
175 <returns>The <see cref="System.Net.ServicePoint"></see> object that manages communications for the request.</returns>
176 <exception cref="T:System.UriFormatException">The URI specified in <paramref name="uriString">uriString</paramref> is invalid.</exception>
177 <exception cref="T:System.InvalidOperationException">The maximum number of <see cref="System.Net.ServicePoint"></see> objects defined in <see cref="System.Net.ServicePointManager.MaxServicePoints"></see> has been reached.</exception>
179 <member name="P:System.Net.ServicePointManager.MaxServicePointIdleTime">
180 <summary>Gets or sets the maximum idle time of a <see cref="T:System.Net.ServicePoint"></see> object.</summary>
181 <returns>The maximum idle time, in milliseconds, of a <see cref="System.Net.ServicePoint"></see> object. The default value is 100,000 milliseconds (100 seconds).</returns>
182 <exception cref="T:System.ArgumentOutOfRangeException"><see cref="System.Net.ServicePointManager.MaxServicePointIdleTime"></see> is less than <see cref="System.Threading.Timeout.Infinite"></see> or greater than <see cref="System.Int32.MaxValue"></see>.</exception>
184 <member name="P:System.Net.ServicePointManager.MaxServicePoints">
185 <summary>Gets or sets the maximum number of <see cref="T:System.Net.ServicePoint"></see> objects to maintain at any time.</summary>
186 <returns>The maximum number of <see cref="System.Net.ServicePoint"></see> objects to maintain. The default value is 0, which means there is no limit to the number of <see cref="System.Net.ServicePoint"></see> objects.</returns>
187 <exception cref="T:System.ArgumentOutOfRangeException"><see cref="System.Net.ServicePointManager.MaxServicePoints"></see> is less than 0 or greater than <see cref="System.Int32.MaxValue"></see>.</exception>
189 <member name="P:System.Net.ServicePointManager.ReusePort">
190 <summary>Setting this property value to true causes all outbound TCP connections from HttpWebRequest to use the native socket option SO_REUSE_UNICASTPORT on the socket. This causes the underlying outgoing ports to be shared. This is useful for scenarios where a large number of outgoing connections are made in a short time, and the app risks running out of ports.</summary>
191 <returns>Returns <see cref="System.Boolean"></see>.</returns>
193 <member name="P:System.Net.ServicePointManager.SecurityProtocol">
194 <summary>Gets or sets the security protocol used by the <see cref="T:System.Net.ServicePoint"></see> objects managed by the <see cref="T:System.Net.ServicePointManager"></see> object.</summary>
195 <returns>One of the values defined in the <see cref="System.Net.SecurityProtocolType"></see> enumeration.</returns>
196 <exception cref="T:System.NotSupportedException">The value specified to set the property is not a valid <see cref="System.Net.SecurityProtocolType"></see> enumeration value.</exception>
198 <member name="P:System.Net.ServicePointManager.ServerCertificateValidationCallback">
199 <summary>Gets or sets the callback to validate a server certificate.</summary>
200 <returns>A <see cref="System.Net.Security.RemoteCertificateValidationCallback"></see>. The default value is null.</returns>
202 <member name="M:System.Net.ServicePointManager.SetTcpKeepAlive(System.Boolean,System.Int32,System.Int32)">
203 <summary>Enables or disables the keep-alive option on a TCP connection.</summary>
204 <param name="enabled">If set to true, then the TCP keep-alive option on a TCP connection will be enabled using the specified keepAliveTime and keepAliveInterval values.
205 If set to false, then the TCP keep-alive option is disabled and the remaining parameters are ignored.
206 The default value is false.</param>
207 <param name="keepAliveTime">Specifies the timeout, in milliseconds, with no activity until the first keep-alive packet is sent.
208 The value must be greater than 0. If a value of less than or equal to zero is passed an <see cref="T:System.ArgumentOutOfRangeException"></see> is thrown.</param>
209 <param name="keepAliveInterval">Specifies the interval, in milliseconds, between when successive keep-alive packets are sent if no acknowledgement is received.
210 The value must be greater than 0. If a value of less than or equal to zero is passed an <see cref="T:System.ArgumentOutOfRangeException"></see> is thrown.</param>
211 <exception cref="T:System.ArgumentOutOfRangeException">The value specified for <paramref name="keepAliveTime">keepAliveTime</paramref> or <paramref name="keepAliveInterval">keepAliveInterval</paramref> parameter is less than or equal to 0.</exception>
213 <member name="P:System.Net.ServicePointManager.UseNagleAlgorithm">
214 <summary>Determines whether the Nagle algorithm is used by the service points managed by this <see cref="T:System.Net.ServicePointManager"></see> object.</summary>
215 <returns>true to use the Nagle algorithm; otherwise, false. The default value is true.</returns>