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