[docs] Fixed XML syntax issue with CipherSuitsCallback, and ServicePointManager xml...
[mono.git] / mcs / class / System / Documentation / en / System.Net / ServicePointManager.xml
1 <Type Name="ServicePointManager" FullName="System.Net.ServicePointManager" FullNameSP="System_Net_ServicePointManager" Maintainer="ecma">
2   <TypeSignature Language="ILASM" Value=".class public ServicePointManager extends System.Object" />
3   <TypeSignature Language="C#" Value="public class ServicePointManager" />
4   <TypeSignature Language="ILAsm" Value=".class public auto ansi ServicePointManager extends System.Object" />
5   <MemberOfLibrary>Networking</MemberOfLibrary>
6   <AssemblyInfo>
7     <AssemblyName>System</AssemblyName>
8     <AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
9     <AssemblyVersion>1.0.x.x</AssemblyVersion>
10     <AssemblyVersion>1.0.5000.0</AssemblyVersion>
11     <AssemblyVersion>2.0.0.0</AssemblyVersion>
12     <AssemblyVersion>4.0.0.0</AssemblyVersion>
13   </AssemblyInfo>
14   <ThreadingSafetyStatement>The public static fields exposed in ServicePointManager are not thread safe.  Changing one of these values in one thread will change the value for any other thread subsequently accessing the field.</ThreadingSafetyStatement>
15   <Base>
16     <BaseTypeName>System.Object</BaseTypeName>
17   </Base>
18   <Interfaces />
19   <Docs>
20     <summary>
21       <para> Manages <see cref="T:System.Net.ServicePoint" /> instances.</para>
22     </summary>
23     <remarks>
24       <para>
25         <see cref="T:System.Net.ServicePointManager" /> creates, maintains,
26  and deletes <see cref="T:System.Net.ServicePoint" /> instances. </para>
27       <para> When an application requests a connection to an Internet resource through
28  the <see cref="T:System.Net.ServicePointManager" />, the <see cref="T:System.Net.ServicePointManager" />
29  returns a <see cref="T:System.Net.ServicePoint" /> instance containing
30  connection information for the host identified by
31  the Uniform Resource Identifier (URI) of the resource. If there is an existing <see cref="T:System.Net.ServicePoint" /> for that host, the
32 <see cref="T:System.Net.ServicePointManager" /> 
33 returns the existing <see cref="T:System.Net.ServicePoint" />, otherwise the <see cref="T:System.Net.ServicePointManager" /> creates a new <see cref="T:System.Net.ServicePoint" />
34 instance. </para>
35     </remarks>
36   </Docs>
37   <Members>
38     <Member MemberName="CertificatePolicy">
39       <MemberSignature Language="C#" Value="public static System.Net.ICertificatePolicy CertificatePolicy { get; set; }" />
40       <MemberSignature Language="ILAsm" Value=".property class System.Net.ICertificatePolicy CertificatePolicy" />
41       <MemberType>Property</MemberType>
42       <AssemblyInfo>
43         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
44         <AssemblyVersion>2.0.0.0</AssemblyVersion>
45         <AssemblyVersion>4.0.0.0</AssemblyVersion>
46       </AssemblyInfo>
47       <Attributes>
48         <Attribute>
49           <AttributeName>System.Obsolete("Use ServerCertificateValidationCallback instead", false)</AttributeName>
50         </Attribute>
51       </Attributes>
52       <ReturnValue>
53         <ReturnType>System.Net.ICertificatePolicy</ReturnType>
54       </ReturnValue>
55       <Docs>
56         <summary>To be added.</summary>
57         <value>To be added.</value>
58         <remarks>To be added.</remarks>
59       </Docs>
60     </Member>
61     <Member MemberName="CheckCertificateRevocationList">
62       <MemberSignature Language="C#" Value="public static bool CheckCertificateRevocationList { get; set; }" />
63       <MemberSignature Language="ILAsm" Value=".property bool CheckCertificateRevocationList" />
64       <MemberType>Property</MemberType>
65       <AssemblyInfo>
66         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
67         <AssemblyVersion>2.0.0.0</AssemblyVersion>
68         <AssemblyVersion>4.0.0.0</AssemblyVersion>
69       </AssemblyInfo>
70       <Attributes>
71         <Attribute>
72           <AttributeName>System.MonoTODO("CRL checks not implemented")</AttributeName>
73         </Attribute>
74       </Attributes>
75       <ReturnValue>
76         <ReturnType>System.Boolean</ReturnType>
77       </ReturnValue>
78       <Docs>
79         <summary>To be added.</summary>
80         <value>To be added.</value>
81         <remarks>To be added.</remarks>
82       </Docs>
83     </Member>
84     <Member MemberName="ClientCipherSuitesCallback">
85       <MemberSignature Language="C#" Value="public static System.Net.CipherSuitesCallback ClientCipherSuitesCallback { get; set; }" />
86       <MemberSignature Language="ILAsm" Value=".property class System.Net.CipherSuitesCallback ClientCipherSuitesCallback" />
87       <MemberType>Property</MemberType>
88       <AssemblyInfo>
89         <AssemblyVersion>4.0.0.0</AssemblyVersion>
90       </AssemblyInfo>
91       <ReturnValue>
92         <ReturnType>System.Net.CipherSuitesCallback</ReturnType>
93       </ReturnValue>
94       <Docs>
95         <summary>You can filter and/or re-order the ciphers suites that will be sent to the SSL/TLS server by providing your own callback.</summary>
96         <value>Your custom delegate or null for the default behaviour.</value>
97         <remarks>
98           <para>
99             This mechanism cannot be used to add new ciphers. Undefined ciphers will be ignored. 
100           </para>
101           <para>
102             This API is only available in Mono and Xamarin products.
103           </para>
104           <para>
105             You can filter and/or re-order the ciphers suites that the SSL/TLS server
106             will accept from a client. The first match for a supported client cipher suite
107             will be used (so the order is important).
108           </para>
109           <example>
110             <para>The following example removes weak (export) ciphers from the list that will be offered to the server.</para>
111             <code lang="C#">
112 ServicePointManager.ClientCipherSuitesCallback += (SecurityProtocolType p, IEnumerable&lt;string&gt; allCiphers) =&gt; {
113     return from cipher in allCiphers where !cipher.Contains ("EXPORT")
114     select cipher;
115 };
116           </code>
117         </example>
118         <example>
119           <para>Example: Use AES128 (preference) or AES256 (allowed) but no other ciphers.</para>
120
121           <code lang="C#">
122 ServicePointManager.ClientCipherSuitesCallback += (SecurityProtocolType p, IEnumerable&lt;string&gt; allCiphers) =&gt; {
123     string prefix = p == SecurityProtocolType.Tls ? "TLS_" : "SSL_";
124     return new List&lt;string&gt; { prefix + "RSA_WITH_AES_128_CBC_SHA", prefix + "RSA_WITH_AES_256_CBC_SHA" };
125 };
126     </code>
127         </example>
128       </remarks>
129       </Docs>
130     </Member>
131     <Member MemberName="DefaultConnectionLimit">
132       <MemberSignature Language="ILASM" Value=".property int32 DefaultConnectionLimit { public hidebysig static specialname int32 get_DefaultConnectionLimit() public hidebysig static specialname void set_DefaultConnectionLimit(int32 value) }" />
133       <MemberSignature Language="C#" Value="public static int DefaultConnectionLimit { get; set; }" />
134       <MemberSignature Language="ILAsm" Value=".property int32 DefaultConnectionLimit" />
135       <MemberType>Property</MemberType>
136       <AssemblyInfo>
137         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
138         <AssemblyVersion>2.0.0.0</AssemblyVersion>
139         <AssemblyVersion>4.0.0.0</AssemblyVersion>
140       </AssemblyInfo>
141       <ReturnValue>
142         <ReturnType>System.Int32</ReturnType>
143       </ReturnValue>
144       <Parameters />
145       <MemberValue>2</MemberValue>
146       <Docs>
147         <summary>
148           <para>Gets or sets the maximum number of concurrent connections allowed by a
149    <see cref="T:System.Net.ServicePoint" /> instance.</para>
150         </summary>
151         <value>
152           <para>A <see cref="T:System.Int32" /> containing the maximum number of concurrent connections allowed by a <see cref="T:System.Net.ServicePoint" /> instance.</para>
153         </value>
154         <remarks>
155           <para>The <see cref="P:System.Net.ServicePointManager.DefaultConnectionLimit" /> property sets the default maximum number of concurrent
156    connections that the <see cref="T:System.Net.ServicePointManager" /> assigns to the <see cref="P:System.Net.ServicePoint.ConnectionLimit" /> property
157    when creating <see cref="T:System.Net.ServicePoint" /> instances.</para>
158           <para>
159             <block subset="none" type="note">Changing the <see cref="P:System.Net.ServicePointManager.DefaultConnectionLimit" /> property has no effect on existing <see cref="T:System.Net.ServicePoint" />
160 instances; it affects only <see cref="T:System.Net.ServicePoint" /> instances that
161 are initialized after the change.</block>
162           </para>
163         </remarks>
164         <exception cref="T:System.ArgumentOutOfRangeException">The value specified for a set operation is less than or equal to zero.</exception>
165       </Docs>
166       <Excluded>0</Excluded>
167     </Member>
168     <Member MemberName="DefaultNonPersistentConnectionLimit">
169       <MemberSignature Language="ILASM" Value=".field public static literal int32 DefaultNonPersistentConnectionLimit = 4" />
170       <MemberSignature Language="C#" Value="public const int DefaultNonPersistentConnectionLimit = 4;" />
171       <MemberSignature Language="ILAsm" Value=".field public static literal int32 DefaultNonPersistentConnectionLimit = (4)" />
172       <MemberType>Field</MemberType>
173       <AssemblyInfo>
174         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
175         <AssemblyVersion>2.0.0.0</AssemblyVersion>
176         <AssemblyVersion>4.0.0.0</AssemblyVersion>
177       </AssemblyInfo>
178       <ReturnValue>
179         <ReturnType>System.Int32</ReturnType>
180       </ReturnValue>
181       <Parameters />
182       <MemberValue>4</MemberValue>
183       <Docs>
184         <summary>
185           <para> The default number of non-persistent connections allowed on a <see cref="T:System.Net.ServicePoint" /> .
186    </para>
187         </summary>
188         <remarks>
189           <para>This field is read-only.</para>
190           <para>The value of this field is
191       4.</para>
192         </remarks>
193       </Docs>
194       <Excluded>0</Excluded>
195     </Member>
196     <Member MemberName="DefaultPersistentConnectionLimit">
197       <MemberSignature Language="ILASM" Value=".field public static literal int32 DefaultPersistentConnectionLimit = 2" />
198       <MemberSignature Language="C#" Value="public const int DefaultPersistentConnectionLimit = 2;" />
199       <MemberSignature Language="ILAsm" Value=".field public static literal int32 DefaultPersistentConnectionLimit = (2)" />
200       <MemberType>Field</MemberType>
201       <AssemblyInfo>
202         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
203         <AssemblyVersion>2.0.0.0</AssemblyVersion>
204         <AssemblyVersion>4.0.0.0</AssemblyVersion>
205       </AssemblyInfo>
206       <ReturnValue>
207         <ReturnType>System.Int32</ReturnType>
208       </ReturnValue>
209       <Parameters />
210       <MemberValue>2</MemberValue>
211       <Docs>
212         <summary>
213           <para> The default number of persistent connections allowed on a <see cref="T:System.Net.ServicePoint" /> .
214    </para>
215         </summary>
216         <remarks>
217           <para>This field is read-only.</para>
218           <para>The value of this field is
219       2.</para>
220         </remarks>
221       </Docs>
222       <Excluded>0</Excluded>
223     </Member>
224     <Member MemberName="DnsRefreshTimeout">
225       <MemberSignature Language="C#" Value="public static int DnsRefreshTimeout { get; set; }" />
226       <MemberSignature Language="ILAsm" Value=".property int32 DnsRefreshTimeout" />
227       <MemberType>Property</MemberType>
228       <AssemblyInfo>
229         <AssemblyVersion>2.0.0.0</AssemblyVersion>
230         <AssemblyVersion>4.0.0.0</AssemblyVersion>
231       </AssemblyInfo>
232       <Attributes>
233         <Attribute>
234           <AttributeName>System.MonoTODO</AttributeName>
235         </Attribute>
236       </Attributes>
237       <ReturnValue>
238         <ReturnType>System.Int32</ReturnType>
239       </ReturnValue>
240       <Docs>
241         <summary>To be added.</summary>
242         <value>To be added.</value>
243         <remarks>To be added.</remarks>
244       </Docs>
245     </Member>
246     <Member MemberName="EnableDnsRoundRobin">
247       <MemberSignature Language="C#" Value="public static bool EnableDnsRoundRobin { get; set; }" />
248       <MemberSignature Language="ILAsm" Value=".property bool EnableDnsRoundRobin" />
249       <MemberType>Property</MemberType>
250       <AssemblyInfo>
251         <AssemblyVersion>2.0.0.0</AssemblyVersion>
252         <AssemblyVersion>4.0.0.0</AssemblyVersion>
253       </AssemblyInfo>
254       <Attributes>
255         <Attribute>
256           <AttributeName>System.MonoTODO</AttributeName>
257         </Attribute>
258       </Attributes>
259       <ReturnValue>
260         <ReturnType>System.Boolean</ReturnType>
261       </ReturnValue>
262       <Docs>
263         <summary>To be added.</summary>
264         <value>To be added.</value>
265         <remarks>To be added.</remarks>
266       </Docs>
267     </Member>
268     <Member MemberName="Expect100Continue">
269       <MemberSignature Language="C#" Value="public static bool Expect100Continue { get; set; }" />
270       <MemberSignature Language="ILAsm" Value=".property bool Expect100Continue" />
271       <MemberType>Property</MemberType>
272       <AssemblyInfo>
273         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
274         <AssemblyVersion>2.0.0.0</AssemblyVersion>
275         <AssemblyVersion>4.0.0.0</AssemblyVersion>
276       </AssemblyInfo>
277       <ReturnValue>
278         <ReturnType>System.Boolean</ReturnType>
279       </ReturnValue>
280       <Docs>
281         <summary>To be added.</summary>
282         <value>To be added.</value>
283         <remarks>To be added.</remarks>
284       </Docs>
285     </Member>
286     <Member MemberName="FindServicePoint">
287       <MemberSignature Language="ILASM" Value=".method public hidebysig static class System.Net.ServicePoint FindServicePoint(class System.Uri address)" />
288       <MemberSignature Language="C#" Value="public static System.Net.ServicePoint FindServicePoint (Uri address);" />
289       <MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Net.ServicePoint FindServicePoint(class System.Uri address) cil managed" />
290       <MemberType>Method</MemberType>
291       <AssemblyInfo>
292         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
293         <AssemblyVersion>2.0.0.0</AssemblyVersion>
294         <AssemblyVersion>4.0.0.0</AssemblyVersion>
295       </AssemblyInfo>
296       <ReturnValue>
297         <ReturnType>System.Net.ServicePoint</ReturnType>
298       </ReturnValue>
299       <Parameters>
300         <Parameter Name="address" Type="System.Uri" />
301       </Parameters>
302       <Docs>
303         <param name="address">A <see cref="T:System.Uri" /> containing the Internet host to contact.</param>
304         <summary>
305           <para>Finds an existing <see cref="T:System.Net.ServicePoint" /> or creates a new <see cref="T:System.Net.ServicePoint" /> to connect to the specified host.</para>
306         </summary>
307         <returns>
308           <para>A <see cref="T:System.Net.ServicePoint" /> that connects to the host identified in
309 <paramref name="address" /> 
310 .</para>
311         </returns>
312         <remarks>
313           <para>This method is identical to <see cref="M:System.Net.ServicePointManager.FindServicePoint(System.Uri)" />(<paramref name="address" />, <see cref="M:System.Net.GlobalProxySelection.GetEmptyWebProxy" />).</para>
314           <para> If no <see cref="T:System.Net.ServicePoint" /> exists for the host named in <paramref name="address" /> , the <see cref="T:System.Net.ServicePointManager" /> attempts to
315 create one.</para>
316         </remarks>
317         <exception cref="T:System.ArgumentNullException">
318           <paramref name="address " />is <see langword="null" />.</exception>
319         <exception cref="T:System.InvalidOperationException">The maximum number of service points defined in <see cref="P:System.Net.ServicePointManager.MaxServicePoints" /> has been reached and there is no service point that connects to the specified host.</exception>
320       </Docs>
321       <Excluded>0</Excluded>
322     </Member>
323     <Member MemberName="FindServicePoint">
324       <MemberSignature Language="ILASM" Value=".method public hidebysig static class System.Net.ServicePoint FindServicePoint(string uriString, class System.Net.IWebProxy proxy)" />
325       <MemberSignature Language="C#" Value="public static System.Net.ServicePoint FindServicePoint (string uriString, System.Net.IWebProxy proxy);" />
326       <MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Net.ServicePoint FindServicePoint(string uriString, class System.Net.IWebProxy proxy) cil managed" />
327       <MemberType>Method</MemberType>
328       <AssemblyInfo>
329         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
330         <AssemblyVersion>2.0.0.0</AssemblyVersion>
331         <AssemblyVersion>4.0.0.0</AssemblyVersion>
332       </AssemblyInfo>
333       <ReturnValue>
334         <ReturnType>System.Net.ServicePoint</ReturnType>
335       </ReturnValue>
336       <Parameters>
337         <Parameter Name="uriString" Type="System.String" />
338         <Parameter Name="proxy" Type="System.Net.IWebProxy" />
339       </Parameters>
340       <Docs>
341         <param name="uriString">A <see cref="T:System.String" /> containing a URI that names the host to contact.</param>
342         <param name="proxy">A <see cref="T:System.Net.IWebProxy" /> that represents a proxy server to access.</param>
343         <summary>
344           <para>Finds an existing <see cref="T:System.Net.ServicePoint" /> or creates a new <see cref="T:System.Net.ServicePoint" /> to connect to the specified host.</para>
345         </summary>
346         <returns>
347           <para>A <see cref="T:System.Net.ServicePoint" /> that connects to the host identified in
348 <paramref name="uriString" /> 
349 .</para>
350         </returns>
351         <remarks>
352           <para>This method is identical to <see cref="M:System.Net.ServicePointManager.FindServicePoint(System.Uri)" />(new <see cref="T:System.Uri" />(<paramref name="uriString" />),
353 <paramref name="proxy" />).</para>
354           <para>If no <see cref="T:System.Net.ServicePoint" /> exists for the host named in <paramref name="uriString" />, the
355 <see cref="T:System.Net.ServicePointManager" /> attempts to create one.</para>
356         </remarks>
357         <exception cref="T:System.ArgumentNullException">
358           <paramref name="uriString" /> is <see langword="null" />.</exception>
359         <exception cref="T:System.UriFormatException">The URI specified in <paramref name="uriString" /> is in an invalid form.</exception>
360         <exception cref="T:System.InvalidOperationException">The maximum number of service points defined in <see cref="P:System.Net.ServicePointManager.MaxServicePoints" /> has been reached and there is no service point that connects to the specified host.</exception>
361       </Docs>
362       <Excluded>0</Excluded>
363     </Member>
364     <Member MemberName="FindServicePoint">
365       <MemberSignature Language="ILASM" Value=".method public hidebysig static class System.Net.ServicePoint FindServicePoint(class System.Uri address, class System.Net.IWebProxy proxy)" />
366       <MemberSignature Language="C#" Value="public static System.Net.ServicePoint FindServicePoint (Uri address, System.Net.IWebProxy proxy);" />
367       <MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Net.ServicePoint FindServicePoint(class System.Uri address, class System.Net.IWebProxy proxy) cil managed" />
368       <MemberType>Method</MemberType>
369       <AssemblyInfo>
370         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
371         <AssemblyVersion>2.0.0.0</AssemblyVersion>
372         <AssemblyVersion>4.0.0.0</AssemblyVersion>
373       </AssemblyInfo>
374       <ReturnValue>
375         <ReturnType>System.Net.ServicePoint</ReturnType>
376       </ReturnValue>
377       <Parameters>
378         <Parameter Name="address" Type="System.Uri" />
379         <Parameter Name="proxy" Type="System.Net.IWebProxy" />
380       </Parameters>
381       <Docs>
382         <param name="address">A <see cref="T:System.Uri" /> instance containing the address of the Internet resource to contact.</param>
383         <param name="proxy">A <see cref="T:System.Net.IWebProxy" /> that represents a proxy server to access.</param>
384         <summary>
385           <para>Finds an existing <see cref="T:System.Net.ServicePoint" /> or creates a new <see cref="T:System.Net.ServicePoint" /> to connect to the specified host.</para>
386         </summary>
387         <returns>
388           <para>A <see cref="T:System.Net.ServicePoint" /> that connects to the host identified in
389 <paramref name="address" /> 
390 .</para>
391         </returns>
392         <remarks>
393           <para> If no <see cref="T:System.Net.ServicePoint" /> exists for the <see cref="P:System.Uri.Host" /> specified in <paramref name="address" /> , the <see cref="T:System.Net.ServicePointManager" /> attempts to create one.</para>
394         </remarks>
395         <exception cref="T:System.ArgumentNullException">
396           <paramref name="address " />is <see langword="null" />.</exception>
397         <exception cref="T:System.InvalidOperationException">The maximum number of service points defined in <see cref="P:System.Net.ServicePointManager.MaxServicePoints" /> has been reached and there is no service point that connects to the specified host.</exception>
398       </Docs>
399       <Excluded>0</Excluded>
400     </Member>
401     <Member MemberName="MaxServicePointIdleTime">
402       <MemberSignature Language="ILASM" Value=".property int32 MaxServicePointIdleTime { public hidebysig static specialname int32 get_MaxServicePointIdleTime() public hidebysig static specialname void set_MaxServicePointIdleTime(int32 value) }" />
403       <MemberSignature Language="C#" Value="public static int MaxServicePointIdleTime { get; set; }" />
404       <MemberSignature Language="ILAsm" Value=".property int32 MaxServicePointIdleTime" />
405       <MemberType>Property</MemberType>
406       <AssemblyInfo>
407         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
408         <AssemblyVersion>2.0.0.0</AssemblyVersion>
409         <AssemblyVersion>4.0.0.0</AssemblyVersion>
410       </AssemblyInfo>
411       <ReturnValue>
412         <ReturnType>System.Int32</ReturnType>
413       </ReturnValue>
414       <Parameters />
415       <MemberValue>900000</MemberValue>
416       <Docs>
417         <summary>
418           <para> Gets or sets the maximum amount of time a <see cref="T:System.Net.ServicePoint" /> instance can be idle, 
419    after which resources allocated
420    to the service point can be released.</para>
421         </summary>
422         <value>
423           <para>A <see cref="T:System.Int32" /> containing the maximum idle time, in milliseconds, of a <see cref="T:System.Net.ServicePoint" /> instance.</para>
424         </value>
425         <remarks>
426           <para> A <see cref="T:System.Net.ServicePoint" />
427 is idle when the list of
428 connections associated with the <see cref="T:System.Net.ServicePoint" /> is empty.</para>
429           <para>The <see cref="P:System.Net.ServicePointManager.MaxServicePointIdleTime" />
430 property holds the value for the maximum idle time for service points. When a <see cref="T:System.Net.ServicePoint" /> instance is created,
431 this value is assigned to its <see cref="P:System.Net.ServicePoint.MaxIdleTime" /> property. Changes to the value
432 of this property affect only <see cref="T:System.Net.ServicePoint" /> instances that are initialized after this property
433 is changed.</para>
434           <para>After a <see cref="T:System.Net.ServicePoint" /> has been idle for the time
435 specified in <see cref="P:System.Net.ServicePoint.MaxIdleTime" /> , it is
436 released by the service point manager, and
437 any resources allocated
438 for it are freed.</para>
439           <para>The default value of this property is
440    implementation defined.</para>
441         </remarks>
442         <exception cref="T:System.ArgumentOutOfRangeException">The value specified for a set operation is less than <see cref="F:System.Threading.Timeout.Infinite" /> or greater than <see cref="F:System.Int32.MaxValue" qualify="true" /></exception>
443       </Docs>
444       <Excluded>0</Excluded>
445     </Member>
446     <Member MemberName="MaxServicePoints">
447       <MemberSignature Language="ILASM" Value=".property int32 MaxServicePoints { public hidebysig static specialname int32 get_MaxServicePoints() public hidebysig static specialname void set_MaxServicePoints(int32 value) }" />
448       <MemberSignature Language="C#" Value="public static int MaxServicePoints { get; set; }" />
449       <MemberSignature Language="ILAsm" Value=".property int32 MaxServicePoints" />
450       <MemberType>Property</MemberType>
451       <AssemblyInfo>
452         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
453         <AssemblyVersion>2.0.0.0</AssemblyVersion>
454         <AssemblyVersion>4.0.0.0</AssemblyVersion>
455       </AssemblyInfo>
456       <ReturnValue>
457         <ReturnType>System.Int32</ReturnType>
458       </ReturnValue>
459       <Parameters />
460       <MemberValue>0</MemberValue>
461       <Docs>
462         <summary>
463           <para>Gets or sets the maximum number of <see cref="T:System.Net.ServicePoint" /> instances managed by this class at any
464  time.</para>
465         </summary>
466         <value>
467           <para>A <see cref="T:System.Int32" /> containing the maximum number of <see cref="T:System.Net.ServicePoint" /> instances to maintain.</para>
468         </value>
469         <remarks>
470           <para>If this property is set to a value that is less than the
471  number of <see cref="T:System.Net.ServicePoint" /> instances currently in
472  existence, the <see cref="T:System.Net.ServicePointManager" />
473  deletes the
474  <see cref="T:System.Net.ServicePoint" /> instances with the longest idle times.
475  If the number of <see cref="T:System.Net.ServicePoint" /> instances with active
476  connections is greater than the value of
477  <see cref="P:System.Net.ServicePointManager.MaxServicePoints" />, the <see cref="T:System.Net.ServicePointManager" /> 
478  deletes <see cref="T:System.Net.ServicePoint" />
479  instances as they become idle. </para>
480           <para>
481             <block subset="none" type="note">The default value
482  of the <see cref="P:System.Net.ServicePointManager.MaxServicePoints" /> property is 0, which indicates
483  there is no limit to the number of <see cref="T:System.Net.ServicePoint" /> instances.</block>
484           </para>
485         </remarks>
486         <exception cref="T:System.ArgumentOutOfRangeException">The value specified for a set operation is less than zero or greater than <see cref="F:System.Int32.MaxValue" qualify="true" /></exception>
487       </Docs>
488       <Excluded>0</Excluded>
489     </Member>
490     <Member MemberName="SecurityProtocol">
491       <MemberSignature Language="C#" Value="public static System.Net.SecurityProtocolType SecurityProtocol { get; set; }" />
492       <MemberSignature Language="ILAsm" Value=".property valuetype System.Net.SecurityProtocolType SecurityProtocol" />
493       <MemberType>Property</MemberType>
494       <AssemblyInfo>
495         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
496         <AssemblyVersion>2.0.0.0</AssemblyVersion>
497         <AssemblyVersion>4.0.0.0</AssemblyVersion>
498       </AssemblyInfo>
499       <ReturnValue>
500         <ReturnType>System.Net.SecurityProtocolType</ReturnType>
501       </ReturnValue>
502       <Docs>
503         <summary>To be added.</summary>
504         <value>To be added.</value>
505         <remarks>To be added.</remarks>
506       </Docs>
507     </Member>
508     <Member MemberName="ServerCertificateValidationCallback">
509       <MemberSignature Language="C#" Value="public static System.Net.Security.RemoteCertificateValidationCallback ServerCertificateValidationCallback { get; set; }" />
510       <MemberSignature Language="ILAsm" Value=".property class System.Net.Security.RemoteCertificateValidationCallback ServerCertificateValidationCallback" />
511       <MemberType>Property</MemberType>
512       <AssemblyInfo>
513         <AssemblyVersion>2.0.0.0</AssemblyVersion>
514         <AssemblyVersion>4.0.0.0</AssemblyVersion>
515       </AssemblyInfo>
516       <ReturnValue>
517         <ReturnType>System.Net.Security.RemoteCertificateValidationCallback</ReturnType>
518       </ReturnValue>
519       <Docs>
520         <summary>To be added.</summary>
521         <value>To be added.</value>
522         <remarks>To be added.</remarks>
523       </Docs>
524     </Member>
525     <Member MemberName="ServerCipherSuitesCallback">
526       <MemberSignature Language="C#" Value="public static System.Net.CipherSuitesCallback ServerCipherSuitesCallback { get; set; }" />
527       <MemberSignature Language="ILAsm" Value=".property class System.Net.CipherSuitesCallback ServerCipherSuitesCallback" />
528       <MemberType>Property</MemberType>
529       <AssemblyInfo>
530         <AssemblyVersion>4.0.0.0</AssemblyVersion>
531       </AssemblyInfo>
532       <ReturnValue>
533         <ReturnType>System.Net.CipherSuitesCallback</ReturnType>
534       </ReturnValue>
535       <Docs>
536         <summary>You can filter and/or re-order the ciphers suites that the SSL/TLS server
537                         will accept from a client. The first match for a supported client cipher suite
538                         will be used (so the order is important).</summary>
539         <value>Your custom delegate or null for the default behaviour.</value>
540         <remarks>This mechanism cannot be used to add new ciphers. Undefined ciphers will be ignored. 
541                         This API is only available in Mono and Xamarin products.</remarks>
542                 <example>
543                         <para>The following example let the server accept AES128 (prefered cipher) or AES256 (allowed cipher) but no other cipher suite.</para>
544                         <code lang="C#">ServicePointManager.ClientCipherSuitesCallback += (SecurityProtocolType
545 p, IEnumerable&lt;string&gt; allCiphers) => {
546             string prefix = p == SecurityProtocolType.Tls ? "TLS_" : "SSL_";
547             return new List&lt;string&gt; { prefix + "RSA_WITH_AES_128_CBC_SHA",
548 prefix + "RSA_WITH_AES_256_CBC_SHA" };
549         };
550                         </code>
551                 </example>
552       </Docs>
553     </Member>
554     <Member MemberName="SetTcpKeepAlive">
555       <MemberSignature Language="C#" Value="public static void SetTcpKeepAlive (bool enabled, int keepAliveTime, int keepAliveInterval);" />
556       <MemberSignature Language="ILAsm" Value=".method public static hidebysig void SetTcpKeepAlive(bool enabled, int32 keepAliveTime, int32 keepAliveInterval) cil managed" />
557       <MemberType>Method</MemberType>
558       <AssemblyInfo>
559         <AssemblyVersion>4.0.0.0</AssemblyVersion>
560       </AssemblyInfo>
561       <ReturnValue>
562         <ReturnType>System.Void</ReturnType>
563       </ReturnValue>
564       <Parameters>
565         <Parameter Name="enabled" Type="System.Boolean" />
566         <Parameter Name="keepAliveTime" Type="System.Int32" />
567         <Parameter Name="keepAliveInterval" Type="System.Int32" />
568       </Parameters>
569       <Docs>
570         <param name="enabled">To be added.</param>
571         <param name="keepAliveTime">To be added.</param>
572         <param name="keepAliveInterval">To be added.</param>
573         <summary>To be added.</summary>
574         <remarks>To be added.</remarks>
575       </Docs>
576     </Member>
577     <Member MemberName="UseNagleAlgorithm">
578       <MemberSignature Language="C#" Value="public static bool UseNagleAlgorithm { get; set; }" />
579       <MemberSignature Language="ILAsm" Value=".property bool UseNagleAlgorithm" />
580       <MemberType>Property</MemberType>
581       <AssemblyInfo>
582         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
583         <AssemblyVersion>2.0.0.0</AssemblyVersion>
584         <AssemblyVersion>4.0.0.0</AssemblyVersion>
585       </AssemblyInfo>
586       <ReturnValue>
587         <ReturnType>System.Boolean</ReturnType>
588       </ReturnValue>
589       <Docs>
590         <summary>To be added.</summary>
591         <value>To be added.</value>
592         <remarks>To be added.</remarks>
593       </Docs>
594     </Member>
595   </Members>
596   <TypeExcluded>0</TypeExcluded>
597 </Type>