mono/linux-packaging-mono
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Imported Upstream version 3.6.0

Browse Source 
Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
This commit is contained in:
Jo Shields
2014-08-13 10:39:27 +01:00
commit a575963da9
50588 changed files with 8155799 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

316
mcs/class/System/Documentation/en/System.Net/AuthenticationManager.xml Normal file
View File

@ -0,0 +1,316 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="AuthenticationManager" FullName="System.Net.AuthenticationManager" FullNameSP="System_Net_AuthenticationManager" Maintainer="ecma">
<TypeSignature Language="ILASM" Value=".class public AuthenticationManager extends System.Object" />
<TypeSignature Language="C#" Value="public class AuthenticationManager" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit AuthenticationManager extends System.Object" />
<MemberOfLibrary>Networking</MemberOfLibrary>
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
<AssemblyVersion>1.0.x.x</AssemblyVersion>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>
<see cref="T:System.Net.AuthenticationManager" /> is a static class that manages the authentication modules that an application uses. When a request is made to protected resources, the <see cref="T:System.Net.AuthenticationManager" /> calls the <see cref="M:System.Net.AuthenticationManager.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)" /> method to get an <see cref="T:System.Net.Authorization" /> instance to use in subsequent requests.</para>
<para>The <see cref="T:System.Net.AuthenticationManager" /> queries each registered authentication module by calling the <see cref="M:System.Net.IAuthenticationModule.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)" /> method for each module. The first authentication module to return an <see cref="T:System.Net.Authorization" /> instance is used to authenticate the request.</para>
<para>Modules that provide the basic, digest, negotiate, NTLM, and Kerberos authentication types are registered with the <see cref="T:System.Net.AuthenticationManager" /> by default. Additional authentication modules that implement the <see cref="T:System.Net.IAuthenticationModule" /> interface can be added using the <see cref="M:System.Net.AuthenticationManager.Register(System.Net.IAuthenticationModule)" /> method. Authentication modules are called in the order in which they were added to the list.</para>
<block subset="none" type="note">
<para>The Kerberos and negotiate authentication type is not supported on Windows 95/98 or Windows NT 4.0.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Manages the authentication modules called during the client authentication process.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Authenticate">
<MemberSignature Language="ILASM" Value=".method public hidebysig static class System.Net.Authorization Authenticate(string challenge, class System.Net.WebRequest request, class System.Net.ICredentials credentials)" />
<MemberSignature Language="C#" Value="public static System.Net.Authorization Authenticate (string challenge, System.Net.WebRequest request, System.Net.ICredentials credentials);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Net.Authorization Authenticate(string challenge, class System.Net.WebRequest request, class System.Net.ICredentials credentials) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.Authorization</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="challenge" Type="System.String" />
<Parameter Name="request" Type="System.Net.WebRequest" />
<Parameter Name="credentials" Type="System.Net.ICredentials" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentNullException">
<paramref name="challenge " />, <paramref name="request " />, or <paramref name="credentials " /> is <see langword="null" />.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.AuthenticationManager.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)" /> method calls the <see cref="M:System.Net.IAuthenticationModule.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)" /> method on each registered authentication module until one of the module responds with an <see cref="T:System.Net.Authorization" /> instance.</para>
<para>The first <see cref="T:System.Net.Authorization" /> instance returned is used to authenticate the request. If no authentication module can authenticate the request, the <see cref="M:System.Net.AuthenticationManager.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)" /> method returns null.</para>
<para>Authentication modules are called in the order in which they are registered with the <see cref="T:System.Net.AuthenticationManager" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Calls each registered authentication module to find the first module that can respond to the authentication request.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An instance of the <see cref="T:System.Net.Authorization" /> class containing the result of the authorization attempt. If there is no authentication module to respond to the challenge, this method returns null.</para>
</returns>
<param name="challenge">
<attribution license="cc4" from="Microsoft" modified="false" />The challenge returned by the Internet resource. </param>
<param name="request">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.WebRequest" /> that initiated the authentication challenge. </param>
<param name="credentials">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.ICredentials" /> associated with this request. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="CredentialPolicy">
<MemberSignature Language="C#" Value="public static System.Net.ICredentialPolicy CredentialPolicy { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property class System.Net.ICredentialPolicy CredentialPolicy" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.ICredentialPolicy</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The credential policy determines whether to send credentials when sending a request for a network resource, such as the content of a Web page. If credentials are sent, servers that require client authentication can attempt to authenticate the client when the request is received instead of sending a response indicating that the client's credentials are required. While this saves a round trip to the server, this must be balanced against the security risk inherent in sending credentials across the network. When the destination server does not require client authentication it is best to not send credentials.</para>
<para>The credential policy will be called only for requests that specify credentials or use a <see cref="T:System.Net.WebProxy" /> object that specifies credentials. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the credential policy to be used for resource requests made using the <see cref="T:System.Net.HttpWebRequest" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName="CustomTargetNameDictionary">
<MemberSignature Language="C#" Value="public static System.Collections.Specialized.StringDictionary CustomTargetNameDictionary { get; }" />
<MemberSignature Language="ILAsm" Value=".property class System.Collections.Specialized.StringDictionary CustomTargetNameDictionary" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.MonoTODO</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Collections.Specialized.StringDictionary</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An SPN is a name by which a client uniquely identifies an instance of a service or application on a server for purposes of mutual authentication. Mutual authentication is requested by default, and you can require it by setting <see cref="P:System.Net.WebRequest.AuthenticationLevel" /> to <see cref="F:System.Net.Security.AuthenticationLevel.MutualAuthRequired" /> in your request.</para>
<para>When a <see cref="T:System.Net.WebRequest" /> requires mutual authentication, the SPN for the destination must be supplied by the client. If you know the SPN, you can add it to the <see cref="P:System.Net.AuthenticationManager.CustomTargetNameDictionary" /> before sending the request. If you have not added SPN information to this dictionary, the <see cref="T:System.Net.AuthenticationManager" /> uses the <see cref="P:System.Net.WebRequest.RequestUri" /> method to compose the most likely SPN; however, this is a computed value and might be incorrect. If mutual authentication is attempted and fails, you can check the dictionary to determine the computed SPN. No SPN is entered into the dictionary if the authentication protocol does not support mutual authentication.</para>
<para>To add an SPN value to this dictionary, use the <see cref="P:System.Uri.AbsoluteUri" /> of the <see cref="P:System.Net.WebRequest.RequestUri" /> as the key. Internally, the key is truncated to include the <see cref="P:System.Uri.Scheme" />, <see cref="P:System.Uri.Host" />, and the <see cref="P:System.Uri.Port" /> if it is not the default port. </para>
<block subset="none" type="note">
<para>Accessing the methods and properties of the <see cref="P:System.Net.AuthenticationManager.CustomTargetNameDictionary" /> requires unrestricted <see cref="T:System.Net.WebPermission" />.</para>
</block>
<block subset="none" type="note">
<para>When Kerberos authentication is performed through a proxy, both the proxy and the ultimate host name need to be resolved to an SPN. The proxy name resolution is protected by a timeout. Resolution of the ultimate host name to a SPN requires a DNS lookup, and there is no timeout associated directly with this operation. Therefore synchronous operations may take longer to timeout. To overcome this, add the ultimate host's URI prefix to the SPN cache prior to making requests to it.</para>
</block>
<para>Version 3.5 SP1 now defaults to specifying the host name used in the request URL in the SPN in the NTLM (NT LAN Manager) authentication exchange when the <see cref="P:System.Net.AuthenticationManager.CustomTargetNameDictionary" /> property is not set. The host name used in the request URL may be different from the Host header specified in the <see cref="T:System.Net.HttpRequestHeader" /> in the client request. The host name used in the request URL may be different from the actual host name of the server, the machine name of the server, the computer's IP address, or the loopback address. In these cases, Windows will fail the authentication request. To address the issue, you may need to notify Windows that the host name used in the request URL in the client request ("contoso", for example) is actually an alternate name for the local computer.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the dictionary that contains Service Principal Names (SPNs) that are used to identify hosts during Kerberos authentication for requests made using <see cref="T:System.Net.WebRequest" /> and its derived classes.</para>
</summary>
</Docs>
</Member>
<Member MemberName="PreAuthenticate">
<MemberSignature Language="ILASM" Value=".method public hidebysig static class System.Net.Authorization PreAuthenticate(class System.Net.WebRequest request, class System.Net.ICredentials credentials)" />
<MemberSignature Language="C#" Value="public static System.Net.Authorization PreAuthenticate (System.Net.WebRequest request, System.Net.ICredentials credentials);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Net.Authorization PreAuthenticate(class System.Net.WebRequest request, class System.Net.ICredentials credentials) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.Authorization</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="request" Type="System.Net.WebRequest" />
<Parameter Name="credentials" Type="System.Net.ICredentials" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentNullException">
<para>
<paramref name="request " />is <see langword="null." /></para>
</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If the authentication module can preauthenticate the request, the <see cref="M:System.Net.AuthenticationManager.PreAuthenticate(System.Net.WebRequest,System.Net.ICredentials)" /> method returns an Authentication instance and sends the authorization information to the server preemptively instead of waiting for the resource to issue a challenge. This behavior is outlined in section 3.3 of RFC 2617 (HTTP Authentication: Basic and Digest Access Authentication). Authentication modules that support preauthentication allow clients to improve server efficiency by avoiding extra round trips caused by authentication challenges.</para>
<para>Authorization modules that can preauthenticate requests set the <see cref="P:System.Net.IAuthenticationModule.CanPreAuthenticate" /> property to true.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Preauthenticates a request.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An instance of the <see cref="T:System.Net.Authorization" /> class if the request can be preauthenticated; otherwise, null. If <paramref name="credentials" /> is null, this method returns null.</para>
</returns>
<param name="request">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.WebRequest" /> to an Internet resource. </param>
<param name="credentials">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.ICredentials" /> associated with the request. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Register">
<MemberSignature Language="ILASM" Value=".method public hidebysig static void Register(class System.Net.IAuthenticationModule authenticationModule)" />
<MemberSignature Language="C#" Value="public static void Register (System.Net.IAuthenticationModule authenticationModule);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void Register(class System.Net.IAuthenticationModule authenticationModule) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="authenticationModule" Type="System.Net.IAuthenticationModule" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentNullException">
<paramref name="authenticationModule " /> is <see langword="null" />.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.AuthenticationManager.Register(System.Net.IAuthenticationModule)" /> method adds authentication modules to the end of the list of modules called by the <see cref="M:System.Net.AuthenticationManager.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)" /> method. Authentication modules are called in the order in which they were added to the list. If a module with the same <see cref="P:System.Net.IAuthenticationModule.AuthenticationType" /> is already registered, this method removes the registered module and adds <paramref name="authenticationModule" /> to the end of the list.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Registers an authentication module with the authentication manager.</para>
</summary>
<param name="authenticationModule">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.IAuthenticationModule" /> to register with the authentication manager. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="RegisteredModules">
<MemberSignature Language="ILASM" Value=".property class System.Collections.IEnumerator RegisteredModules { public hidebysig static specialname class System.Collections.IEnumerator get_RegisteredModules() }" />
<MemberSignature Language="C#" Value="public static System.Collections.IEnumerator RegisteredModules { get; }" />
<MemberSignature Language="ILAsm" Value=".property class System.Collections.IEnumerator RegisteredModules" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.IEnumerator</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.Collections.IEnumerator" /> that
provides access to the list of registered
authentication modules.</para>
</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.AuthenticationManager.RegisteredModules" /> property provides an <see cref="T:System.Collections.IEnumerator" /> instance that enables the list of registered authentication modules to be read. The <see cref="M:System.Net.AuthenticationManager.Register(System.Net.IAuthenticationModule)" /> method adds modules to the list, and the <see cref="M:System.Net.AuthenticationManager.Unregister(System.Net.IAuthenticationModule)" /> method removes modules from it.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a list of authentication modules that are registered with the authentication manager.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Unregister">
<MemberSignature Language="ILASM" Value=".method public hidebysig static void Unregister(class System.Net.IAuthenticationModule authenticationModule)" />
<MemberSignature Language="C#" Value="public static void Unregister (System.Net.IAuthenticationModule authenticationModule);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void Unregister(class System.Net.IAuthenticationModule authenticationModule) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="authenticationModule" Type="System.Net.IAuthenticationModule" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentNullException">
<paramref name="authenticationModule " /> is <see langword="null" />.</exception>
<exception cref="T:System.InvalidOperationException">
<paramref name="authenticationModule " />is not a registered authentication module.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.AuthenticationManager.Unregister(System.Net.IAuthenticationModule)" /> method removes the specified authentication module from the list of authentication modules called by the <see cref="M:System.Net.AuthenticationManager.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)" /> method. The module must have been added to the list using the <see cref="M:System.Net.AuthenticationManager.Register(System.Net.IAuthenticationModule)" /> method before it can be removed from the list.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Removes the specified authentication module from the list of registered modules.</para>
</summary>
<param name="authenticationModule">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.IAuthenticationModule" /> to remove from the list of registered modules. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Unregister">
<MemberSignature Language="ILASM" Value=".method public hidebysig static void Unregister(string authenticationScheme)" />
<MemberSignature Language="C#" Value="public static void Unregister (string authenticationScheme);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void Unregister(string authenticationScheme) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="authenticationScheme" Type="System.String" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentNullException">
<paramref name="authenticationScheme " /> is <see langword="null" />.</exception>
<exception cref="T:System.InvalidOperationException">There is no registered module with the <paramref name="authenticationScheme " /> authentication type.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.AuthenticationManager.Unregister(System.Net.IAuthenticationModule)" /> method removes the authentication module with the specified authentication scheme from the list of authentication modules called by the <see cref="M:System.Net.AuthenticationManager.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)" /> method. The module must have been added to the list using the <see cref="M:System.Net.AuthenticationManager.Register(System.Net.IAuthenticationModule)" /> method before it can be removed from the list.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Removes authentication modules with the specified authentication scheme from the list of registered modules.</para>
</summary>
<param name="authenticationScheme">
<attribution license="cc4" from="Microsoft" modified="false" />The authentication scheme of the module to remove. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
</Members>
<TypeExcluded>0</TypeExcluded>
</Type>

33
mcs/class/System/Documentation/en/System.Net/AuthenticationSchemeSelector.xml Normal file
View File

@ -0,0 +1,33 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="AuthenticationSchemeSelector" FullName="System.Net.AuthenticationSchemeSelector">
<TypeSignature Language="C#" Value="public delegate System.Net.AuthenticationSchemes AuthenticationSchemeSelector(HttpListenerRequest httpRequest);" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed AuthenticationSchemeSelector extends System.MulticastDelegate" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Delegate</BaseTypeName>
</Base>
<Parameters>
<Parameter Name="httpRequest" Type="System.Net.HttpListenerRequest" />
</Parameters>
<ReturnValue>
<ReturnType>System.Net.AuthenticationSchemes</ReturnType>
</ReturnValue>
<Docs>
<param name="httpRequest">To be added.</param>
<returns>To be added.</returns>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Delegates of this type are used by <see cref="T:System.Net.HttpListener" /> instances to select an authentication scheme based on the characteristics of a request.</para>
<para>An <see cref="T:System.Net.AuthenticationSchemeSelector" /> delegate is passed an <see cref="T:System.Net.HttpListenerRequest" /> object for each incoming request that has not provided authentication information. The method invoked by the delegate uses the <see cref="T:System.Net.HttpListenerRequest" /> object and any other available information to decide which authentication scheme to require. The delegate is specified by using the <see cref="P:System.Net.HttpListener.AuthenticationSchemeSelectorDelegate" /> property.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Selects the authentication scheme for an <see cref="T:System.Net.HttpListener" /> instance.</para>
</summary>
</Docs>
</Type>

173
mcs/class/System/Documentation/en/System.Net/AuthenticationSchemes.xml Normal file
View File

@ -0,0 +1,173 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="AuthenticationSchemes" FullName="System.Net.AuthenticationSchemes">
<TypeSignature Language="C#" Value="public enum AuthenticationSchemes" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed AuthenticationSchemes extends System.Enum" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Attributes>
<Attribute>
<AttributeName>System.Flags</AttributeName>
</Attribute>
</Attributes>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This enumeration is used to specify the method used to authenticate client requests being processed by <see cref="T:System.Net.HttpListener" /> objects.</para>
<para>Note   Basic authentication requires the exchange of a password and should therefore be avoided except in the case of secure, encrypted connections.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies protocols for authentication.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Anonymous">
<MemberSignature Language="C#" Value="Anonymous" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Net.AuthenticationSchemes Anonymous = int32(32768)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.AuthenticationSchemes</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies anonymous authentication.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Basic">
<MemberSignature Language="C#" Value="Basic" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Net.AuthenticationSchemes Basic = int32(8)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.AuthenticationSchemes</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>For additional information, see RFC2617 – HTTP Authentication: Basic and Digest Authentication. This document is available at <see cref="http://www.rfc-editor.org/">http://www.rfc-editor.org</see>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies basic authentication. </para>
</summary>
</Docs>
</Member>
<Member MemberName="Digest">
<MemberSignature Language="C#" Value="Digest" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Net.AuthenticationSchemes Digest = int32(1)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.AuthenticationSchemes</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>For additional information, see RFC2617 – HTTP Authentication: Basic and Digest Authentication. This document is available at <see cref="http://www.rfc-editor.org/">http://www.rfc-editor.org</see></para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies digest authentication.</para>
</summary>
</Docs>
</Member>
<Member MemberName="IntegratedWindowsAuthentication">
<MemberSignature Language="C#" Value="IntegratedWindowsAuthentication" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Net.AuthenticationSchemes IntegratedWindowsAuthentication = int32(6)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.AuthenticationSchemes</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies Windows authentication.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Negotiate">
<MemberSignature Language="C#" Value="Negotiate" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Net.AuthenticationSchemes Negotiate = int32(2)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.AuthenticationSchemes</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Negotiates with the client to determine the authentication scheme. If both client and server support Kerberos, it is used; otherwise, NTLM is used.</para>
</summary>
</Docs>
</Member>
<Member MemberName="None">
<MemberSignature Language="C#" Value="None" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Net.AuthenticationSchemes None = int32(0)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.AuthenticationSchemes</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>No authentication is allowed. A client requesting an <see cref="T:System.Net.HttpListener" /> object with this flag set will always receive a 403 Forbidden status. Use this flag when a resource should never be served to a client.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Ntlm">
<MemberSignature Language="C#" Value="Ntlm" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Net.AuthenticationSchemes Ntlm = int32(4)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.AuthenticationSchemes</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies NTLM authentication.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

295
mcs/class/System/Documentation/en/System.Net/Authorization.xml Normal file
View File

@ -0,0 +1,295 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="Authorization" FullName="System.Net.Authorization" FullNameSP="System_Net_Authorization" Maintainer="ecma">
<TypeSignature Language="ILASM" Value=".class public Authorization extends System.Object" />
<TypeSignature Language="C#" Value="public class Authorization" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit Authorization extends System.Object" />
<MemberOfLibrary>Networking</MemberOfLibrary>
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
<AssemblyVersion>1.0.x.x</AssemblyVersion>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Net.AuthenticationManager" /> returns an instance of the <see cref="T:System.Net.Authorization" /> class that contains an authentication message. This message is sent to the Internet server to indicate that the client (such as <see cref="T:System.Net.WebRequest" /> or one of its descendants) is authorized to access the server.</para>
<para>The <see cref="T:System.Net.Authorization" /> instance is created by the authentication module that the <see cref="T:System.Net.AuthenticationManager" /> designates to handle the request.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Contains an authentication message for an Internet server.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string token)" />
<MemberSignature Language="C#" Value="public Authorization (string token);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string token) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="token" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Net.Authorization" /> instance is created with the <see cref="P:System.Net.Authorization.Message" /> property set to <paramref name="token" /> and the <see cref="P:System.Net.Authorization.Complete" /> property set to true.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a new instance of the <see cref="T:System.Net.Authorization" /> class with the specified authorization message.</para>
</summary>
<param name="token">
<attribution license="cc4" from="Microsoft" modified="false" />The encrypted authorization message expected by the server. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string token, bool finished)" />
<MemberSignature Language="C#" Value="public Authorization (string token, bool finished);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string token, bool finished) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="token" Type="System.String" />
<Parameter Name="finished" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Net.Authorization" /> instance is created with the <see cref="P:System.Net.Authorization.Message" /> property set to <paramref name="token" /> and the <see cref="P:System.Net.Authorization.Complete" /> property set to <paramref name="finished" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a new instance of the <see cref="T:System.Net.Authorization" /> class with the specified authorization message and completion status.</para>
</summary>
<param name="token">
<attribution license="cc4" from="Microsoft" modified="false" />The encrypted authorization message expected by the server. </param>
<param name="finished">
<attribution license="cc4" from="Microsoft" modified="false" />The completion status of the authorization attempt. true if the authorization attempt is complete; otherwise, false. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string token, bool finished, string connectionGroupId)" />
<MemberSignature Language="C#" Value="public Authorization (string token, bool finished, string connectionGroupId);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string token, bool finished, string connectionGroupId) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="token" Type="System.String" />
<Parameter Name="finished" Type="System.Boolean" />
<Parameter Name="connectionGroupId" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<para>This constructor creates a <see cref="T:System.Net.Authorization" /> instance with the <see cref="P:System.Net.Authorization.Message" /> property set to <paramref name="token" />, the
<see cref="P:System.Net.Authorization.Complete" /> property set to <paramref name="finished" />, and
the <see cref="P:System.Net.Authorization.ConnectionGroupId" /> property set to <paramref name="connectionGroupId" />. If <paramref name="token" /> is
<see langword="null" /> or a zero-length string, <see cref="P:System.Net.Authorization.Message" /> is set to <see langword="null" />. If
<paramref name="connectionGroupId " /> is <see langword="null" /> or a zero-length string,
<see cref="P:System.Net.Authorization.ConnectionGroupId" /> is set to <see langword="null" />.</para>
<block subset="none" type="note">
<para>The connection group identifier is used to restrict access to the
server connection established with the current authorization instance. Only
<see cref="T:System.Net.WebRequest" />
instances that have <paramref name="connectionGroupId" /> as their <see cref="P:System.Net.WebRequest.ConnectionGroupName" />
property value can use the connection. The connection group information
set by this constructor is also available in the <see cref="P:System.Net.ServicePoint.ConnectionName" /> property of
the service point that represents the connection.</para>
<para>The <see cref="P:System.Net.Authorization.Complete" /> property indicates whether the
authentication, as defined by the authentication protocol implemented by the
caller, is finished or requires additional information exchange between the
client and server.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a new instance of the <see cref="T:System.Net.Authorization" /> class with the specified authorization message, completion status, and connection group identifier.</para>
</summary>
<param name="token">
<attribution license="cc4" from="Microsoft" modified="false" />The encrypted authorization message expected by the server. </param>
<param name="finished">
<attribution license="cc4" from="Microsoft" modified="false" />The completion status of the authorization attempt. true if the authorization attempt is complete; otherwise, false. </param>
<param name="connectionGroupId">
<attribution license="cc4" from="Microsoft" modified="false" />A unique identifier that can be used to create private client-server connections that are bound only to this authentication scheme. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Complete">
<MemberSignature Language="ILASM" Value=".property bool Complete { public hidebysig specialname instance bool get_Complete() }" />
<MemberSignature Language="C#" Value="public bool Complete { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool Complete" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>
<see langword="true " />if the authentication process is complete; otherwise,
<see langword="false" />.</para>
</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.Authorization.Complete" /> property is set to true when the authentication process between the client and the server is finished. Some authentication modules, such as the Kerberos module, use multiple round trips between the client and server to complete the authentication process. To keep the <see cref="T:System.Net.WebRequest" /> or descendant that initiated the authentication process from interrupting while authorization is taking place, the authentication module sets the <see cref="P:System.Net.Authorization.Complete" /> property to false.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the completion status of the authorization.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="ConnectionGroupId">
<MemberSignature Language="ILASM" Value=".property string ConnectionGroupId { public hidebysig specialname instance string get_ConnectionGroupId() }" />
<MemberSignature Language="C#" Value="public string ConnectionGroupId { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string ConnectionGroupId" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.String" /> containing a unique
connection identifier, or <see langword="null" /> if no value was specified to the
constructor for the
current instance.</para>
</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.Authorization.ConnectionGroupId" /> property is a unique string that associates a connection with a specific authenticating entity. For example, the NTLM authorization module ties the authentication credential information to a specific connection to prevent invalid reuse of the connection.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a unique identifier for user-specific connections.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Message">
<MemberSignature Language="ILASM" Value=".property string Message { public hidebysig specialname instance string get_Message() }" />
<MemberSignature Language="C#" Value="public string Message { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Message" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.String" /> containing the message that will be returned to the server in response to an
authentication challenge.</para>
</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.Authorization.Message" /> property contains the authorization string that the client will return to the server when accessing protected resources. The actual contents of the message are defined by the authentication type the client and server are using. Basic HTTP authentication, for example, uses a different message than Kerberos authentication.</para>
<para>When an authentication module supports preauthentication, the <see cref="P:System.Net.Authorization.Message" /> property is sent with the initial request.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the message returned to the server in response to an authentication challenge.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="MutuallyAuthenticated">
<MemberSignature Language="C#" Value="public bool MutuallyAuthenticated { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool MutuallyAuthenticated" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.MonoTODO</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This property returns false if the authentication has not completed.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a <see cref="T:System.Boolean" /> value that indicates whether mutual authentication occurred.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ProtectionRealm">
<MemberSignature Language="ILASM" Value=".property class System.String[] ProtectionRealm { public hidebysig specialname instance class System.String[] get_ProtectionRealm() public hidebysig specialname instance void set_ProtectionRealm(class System.String[] value) }" />
<MemberSignature Language="C#" Value="public string[] ProtectionRealm { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string[] ProtectionRealm" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String[]</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.String" /> array containing URIs.</para>
</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.Authorization.ProtectionRealm" /> property contains a list of URI prefixes that the <see cref="P:System.Net.Authorization.Message" /> property can be used to authenticate. <see cref="T:System.Net.WebRequest" /> and its descendants compare a URI to this list to determine if the <see cref="T:System.Net.Authorization" /> is valid for a particular URI.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the prefix for Uniform Resource Identifiers (URIs) that can be authenticated with the <see cref="P:System.Net.Authorization.Message" /> property.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
</Members>
<TypeExcluded>0</TypeExcluded>
</Type>

38
mcs/class/System/Documentation/en/System.Net/BindIPEndPoint.xml Normal file
View File

@ -0,0 +1,38 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="BindIPEndPoint" FullName="System.Net.BindIPEndPoint">
<TypeSignature Language="C#" Value="public delegate System.Net.IPEndPoint BindIPEndPoint(ServicePoint servicePoint, IPEndPoint remoteEndPoint, int retryCount);" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed BindIPEndPoint extends System.MulticastDelegate" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Delegate</BaseTypeName>
</Base>
<Parameters>
<Parameter Name="servicePoint" Type="System.Net.ServicePoint" />
<Parameter Name="remoteEndPoint" Type="System.Net.IPEndPoint" />
<Parameter Name="retryCount" Type="System.Int32" />
</Parameters>
<ReturnValue>
<ReturnType>System.Net.IPEndPoint</ReturnType>
</ReturnValue>
<Docs>
<param name="servicePoint">To be added.</param>
<param name="remoteEndPoint">To be added.</param>
<param name="retryCount">To be added.</param>
<returns>To be added.</returns>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specify that the <see cref="T:System.Net.BindIPEndPoint" /> delegate is used by a <see cref="T:System.Net.ServicePoint" /> by setting the <see cref="P:System.Net.ServicePoint.BindIPEndPointDelegate" /> property with the delegate as an argument. This delegate should specify a local IP address and port number in the returned <see cref="T:System.Net.IPEndPoint" />.</para>
<para>If the .NET Framework cannot bind the returned <see cref="T:System.Net.IPEndPoint" /> to the <see cref="T:System.Net.ServicePoint" /> after <see cref="F:System.Int32.MaxValue" /> attempts, an <see cref="T:System.OverflowException" /> is thrown. </para>
<para>If you want the delegate to give the service point control of the connection binding, the delegate should return null. If you want to abort the connection, the delegate must throw an exception.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the method that specifies a local Internet Protocol address and port number for a <see cref="T:System.Net.ServicePoint" />.</para>
</summary>
</Docs>
</Type>

28
mcs/class/System/Documentation/en/System.Net/CipherSuitesCallback.xml Normal file
View File

@ -0,0 +1,28 @@
<Type Name="CipherSuitesCallback" FullName="System.Net.CipherSuitesCallback">
<TypeSignature Language="C#" Value="public delegate System.Collections.Generic.IEnumerable&lt;string&gt; CipherSuitesCallback(SecurityProtocolType protocol, IEnumerable&lt;string&gt; allCiphers);" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed CipherSuitesCallback extends System.MulticastDelegate" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Delegate</BaseTypeName>
</Base>
<Parameters>
<Parameter Name="protocol" Type="System.Net.SecurityProtocolType" />
<Parameter Name="allCiphers" Type="System.Collections.Generic.IEnumerable&lt;System.String&gt;" />
</Parameters>
<ReturnValue>
<ReturnType>System.Collections.Generic.IEnumerable&lt;System.String&gt;</ReturnType>
</ReturnValue>
<Docs>
<param name="protocol" preserve-mono="true">The SSL/TLS protocol version used for the connection.</param>
<param name="allCiphers" preserve-mono="true">The ordered list of all supported cipher suites.</param>
<summary preserve-mono="true">You can provide your own code to filter/re-order the cipher suites to be used for client and/or server side SSL/TLS support.</summary>
<returns preserve-mono="true">The ordered list of all cipher suites you wish to support.</returns>
<remarks preserve-mono="true">
<para>This type is only available in Mono and Xamarin products.</para>
<para>See the <see cref="P:System.Net.ServicePointManager.ClientCipherSuitesCallback"/> property for examples of how this is used.</para>
</remarks>
</Docs>
</Type>

611
mcs/class/System/Documentation/en/System.Net/Cookie.xml Normal file
View File

File diff suppressed because it is too large Load Diff

369
mcs/class/System/Documentation/en/System.Net/CookieCollection.xml Normal file
View File

@ -0,0 +1,369 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CookieCollection" FullName="System.Net.CookieCollection">
<TypeSignature Language="C#" Maintainer="auto" Value="public class CookieCollection : System.Collections.ICollection" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit CookieCollection extends System.Object implements class System.Collections.ICollection, class System.Collections.IEnumerable" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.3300.0</AssemblyVersion>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.Collections.ICollection</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Net.CookieCollection" /> class implements an <see cref="T:System.Collections.ICollection" /> interface to provide a general mechanism for handling collections of cookies. For example, this is useful in the case where an application is designed to store cookies for multiple servers.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides a collection container for instances of the <see cref="T:System.Net.Cookie" /> class.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CookieCollection ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The following table shows initial property values for an instance of <see cref="T:System.Net.CookieCollection" />.</para>
<list type="table">
<listheader>
<item>
<term>
<para>Property </para>
</term>
<description>
<para>Default </para>
</description>
</item>
</listheader>
<item>
<term>
<para>
<see cref="P:System.Net.CookieCollection.IsReadOnly" /> </para>
</term>
<description>
<para>true </para>
</description>
</item>
<item>
<term>
<para>
<see cref="P:System.Net.CookieCollection.Count" /> </para>
</term>
<description>
<para>0 </para>
</description>
</item>
<item>
<term>
<para>
<see cref="P:System.Net.CookieCollection.IsSynchronized" /> </para>
</term>
<description>
<para>false </para>
</description>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Net.CookieCollection" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Add">
<MemberSignature Language="C#" Value="public void Add (System.Net.Cookie cookie);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Add(class System.Net.Cookie cookie) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="cookie" Type="System.Net.Cookie" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds a <see cref="T:System.Net.Cookie" /> to a <see cref="T:System.Net.CookieCollection" />.</para>
</summary>
<param name="cookie">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Cookie" /> to be added to a <see cref="T:System.Net.CookieCollection" />. </param>
</Docs>
</Member>
<Member MemberName="Add">
<MemberSignature Language="C#" Value="public void Add (System.Net.CookieCollection cookies);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Add(class System.Net.CookieCollection cookies) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="cookies" Type="System.Net.CookieCollection" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Each <see cref="T:System.Net.Cookie" /> is read from the <see cref="T:System.Net.CookieCollection" /> <paramref name="cookies" /> parameter and added to the current instance.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds the contents of a <see cref="T:System.Net.CookieCollection" /> to the current instance.</para>
</summary>
<param name="cookies">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.CookieCollection" /> to be added. </param>
</Docs>
</Member>
<Member MemberName="CopyTo">
<MemberSignature Language="C#" Value="public void CopyTo (Array array, int index);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void CopyTo(class System.Array array, int32 index) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="array" Type="System.Array" />
<Parameter Name="index" Type="System.Int32" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Array" /> <paramref name="array" /> parameter must be one-dimensional with zero-based indexing.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Copies the elements of a <see cref="T:System.Net.CookieCollection" /> to an instance of the <see cref="T:System.Array" /> class, starting at a particular index.</para>
</summary>
<param name="array">
<attribution license="cc4" from="Microsoft" modified="false" />The target <see cref="T:System.Array" /> to which the <see cref="T:System.Net.CookieCollection" /> will be copied. </param>
<param name="index">
<attribution license="cc4" from="Microsoft" modified="false" />The zero-based index in the target <see cref="T:System.Array" /> where copying begins. </param>
</Docs>
</Member>
<Member MemberName="CopyTo">
<MemberSignature Language="C#" Value="public void CopyTo (System.Net.Cookie[] array, int index);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void CopyTo(class System.Net.Cookie[] array, int32 index) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="array" Type="System.Net.Cookie[]" />
<Parameter Name="index" Type="System.Int32" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Array" /> <paramref name="array" /> parameter must be one-dimensional with zero-based indexing.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Copies the elements of this <see cref="T:System.Net.CookieCollection" /> to a <see cref="T:System.Net.Cookie" /> array starting at the specified index of the target array.</para>
</summary>
<param name="array">
<attribution license="cc4" from="Microsoft" modified="false" />The target <see cref="T:System.Net.Cookie" /> array to which the <see cref="T:System.Net.CookieCollection" /> will be copied.</param>
<param name="index">
<attribution license="cc4" from="Microsoft" modified="false" />The zero-based index in the target <see cref="T:System.Array" /> where copying begins. </param>
</Docs>
</Member>
<Member MemberName="Count">
<MemberSignature Language="C#" Value="public int Count { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance int32 Count" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Docs>
<value>To be added: an object of type 'int'</value>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the number of cookies contained in a <see cref="T:System.Net.CookieCollection" />.</para>
</summary>
</Docs>
</Member>
<Member MemberName="GetEnumerator">
<MemberSignature Language="C#" Value="public System.Collections.IEnumerator GetEnumerator ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Collections.IEnumerator GetEnumerator() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.IEnumerator</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You should use an <see cref="T:System.Collections.IEnumerator" /> only to read data in the collection. Enumerators cannot be used to modify the underlying collection. The enumerator does not have exclusive access to the collection.</para>
<para>When an enumerator is created, it takes a snapshot of the current state of the collection. If changes are made to the collection, such as adding, modifying, or deleting elements, this snapshot gets out of sync and the enumerator throws an <see cref="T:System.InvalidOperationException" />. Two enumerators created from the same collection at the same time can produce different snapshots of the collection.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets an enumerator that can iterate through a <see cref="T:System.Net.CookieCollection" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An instance of an implementation of an <see cref="T:System.Collections.IEnumerator" /> interface that can iterate through a <see cref="T:System.Net.CookieCollection" />.</para>
</returns>
</Docs>
</Member>
<Member MemberName="IsReadOnly">
<MemberSignature Language="C#" Value="public bool IsReadOnly { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool IsReadOnly" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added: an object of type 'bool'</value>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a value that indicates whether a <see cref="T:System.Net.CookieCollection" /> is read-only.</para>
</summary>
</Docs>
</Member>
<Member MemberName="IsSynchronized">
<MemberSignature Language="C#" Value="public bool IsSynchronized { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool IsSynchronized" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added: an object of type 'bool'</value>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a value that indicates whether access to a <see cref="T:System.Net.CookieCollection" /> is thread safe.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Item">
<MemberSignature Language="C#" Value="public System.Net.Cookie this[int index] { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Net.Cookie Item(int32)" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.Cookie</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="index" Type="System.Int32" />
</Parameters>
<Docs>
<param name="index">To be added.</param>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="Item">
<MemberSignature Language="C#" Value="public System.Net.Cookie this[string name] { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Net.Cookie Item(string)" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.Cookie</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="name" Type="System.String" />
</Parameters>
<Docs>
<param name="name">To be added.</param>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="SyncRoot">
<MemberSignature Language="C#" Value="public object SyncRoot { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance object SyncRoot" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Docs>
<value>To be added: an object of type 'object'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.CookieCollection.SyncRoot" /> property returns an object that can be used to synchronize access to the <see cref="T:System.Net.CookieCollection" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets an object to synchronize access to the <see cref="T:System.Net.CookieCollection" />.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

513
mcs/class/System/Documentation/en/System.Net/CookieContainer.xml Normal file
View File

File diff suppressed because it is too large Load Diff

138
mcs/class/System/Documentation/en/System.Net/CookieException.xml Normal file
View File

@ -0,0 +1,138 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CookieException" FullName="System.Net.CookieException">
<TypeSignature Language="C#" Maintainer="auto" Value="public class CookieException : FormatException" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit CookieException extends System.FormatException implements class System.Runtime.Serialization.ISerializable" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.3300.0</AssemblyVersion>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.FormatException</BaseTypeName>
</Base>
<Interfaces>
</Interfaces>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This exception is thrown if an attempt is made to <see cref="M:System.Net.CookieContainer.Add(System.Net.Cookie)" /> a <see cref="T:System.Net.Cookie" /> with length greater than <see cref="P:System.Net.CookieContainer.MaxCookieSize" /> to a <see cref="T:System.Net.CookieContainer" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The exception that is thrown when an error is made adding a <see cref="T:System.Net.Cookie" /> to a <see cref="T:System.Net.CookieContainer" />.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CookieException ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The default constructor for <see cref="T:System.Net.CookieException" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Net.CookieException" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected CookieException (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor(class System.Runtime.Serialization.SerializationInfo serializationInfo, valuetype System.Runtime.Serialization.StreamingContext streamingContext) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="serializationInfo" Type="System.Runtime.Serialization.SerializationInfo" />
<Parameter Name="streamingContext" Type="System.Runtime.Serialization.StreamingContext" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Allows you to set up custom serialization.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Net.CookieException" /> class with specific values of <paramref name="serializationInfo" /> and <paramref name="streamingContext" />.</para>
</summary>
<param name="serializationInfo">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> to be used. </param>
<param name="streamingContext">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Serialization.StreamingContext" /> to be used. </param>
</Docs>
</Member>
<Member MemberName="GetObjectData">
<MemberSignature Language="C#" Value="public override void GetObjectData (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void GetObjectData(class System.Runtime.Serialization.SerializationInfo serializationInfo, valuetype System.Runtime.Serialization.StreamingContext streamingContext) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="serializationInfo" Type="System.Runtime.Serialization.SerializationInfo" />
<Parameter Name="streamingContext" Type="System.Runtime.Serialization.StreamingContext" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. For more information, see <format type="text/html"><a href="832AC524-21BC-419A-A27B-CA8BFC45840F">XML and SOAP Serialization</a></format>. Any objects included in the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> are automatically tracked and serialized by the formatter.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo" /> instance with the data needed to serialize the <see cref="T:System.Net.CookieException" />.</para>
</summary>
<param name="serializationInfo">
<attribution license="cc4" from="Microsoft" modified="false" />The object that holds the serialized object data. The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> to populate with data.</param>
<param name="streamingContext">
<attribution license="cc4" from="Microsoft" modified="false" />The contextual information about the source or destination. A <see cref="T:System.Runtime.Serialization.StreamingContext" /> that specifies the destination for this serialization.</param>
</Docs>
</Member>
<Member MemberName="System.Runtime.Serialization.ISerializable.GetObjectData">
<MemberSignature Language="C#" Value="void ISerializable.GetObjectData (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);" />
<MemberSignature Language="ILAsm" Value=".method hidebysig newslot virtual instance void System.Runtime.Serialization.ISerializable.GetObjectData(class System.Runtime.Serialization.SerializationInfo info, valuetype System.Runtime.Serialization.StreamingContext context) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="info" Type="System.Runtime.Serialization.SerializationInfo" />
<Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
</Parameters>
<Docs>
<param name="info">To be added.</param>
<param name="context">To be added.</param>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo" /> instance with the data needed to serialize the <see cref="T:System.Net.CookieException" />.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

419
mcs/class/System/Documentation/en/System.Net/CredentialCache.xml Normal file
View File

@ -0,0 +1,419 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CredentialCache" FullName="System.Net.CredentialCache" FullNameSP="System_Net_CredentialCache" Maintainer="ecma">
<TypeSignature Language="ILASM" Value=".class public CredentialCache extends System.Object implements System.Net.ICredentials, System.Collections.IEnumerable" />
<TypeSignature Language="C#" Value="public class CredentialCache : System.Collections.IEnumerable, System.Net.ICredentials, System.Net.ICredentialsByHost" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit CredentialCache extends System.Object implements class System.Collections.IEnumerable, class System.Net.ICredentials, class System.Net.ICredentialsByHost" />
<MemberOfLibrary>Networking</MemberOfLibrary>
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
<AssemblyVersion>1.0.x.x</AssemblyVersion>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.Collections.IEnumerable</InterfaceName>
</Interface>
<Interface>
<InterfaceName>System.Net.ICredentials</InterfaceName>
</Interface>
<Interface>
<InterfaceName>System.Net.ICredentialsByHost</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Net.CredentialCache" /> class stores credentials for multiple Internet resources. Applications that need to access multiple resources can store the credentials for those resources in a <see cref="T:System.Net.CredentialCache" /> instance that then provides the proper set of credentials to the Internet resource when required. When the <see cref="M:System.Net.CredentialCache.GetCredential(System.Uri,System.String)" /> method is called, it compares the Uniform Resource Identifier (URI) and authentication type provided with those stored in the cache and returns the first set of credentials that match.</para>
<para>The <see cref="P:System.Net.CredentialCache.DefaultCredentials" /> property contains the system credentials of the current security context. For client applications, these represent the user name, password, and domain of the user who is currently logged in. For ASP.NET applications, the default credentials are the user credentials of the logged-in user or the user being impersonated.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides storage for multiple credentials.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor()" />
<MemberSignature Language="C#" Value="public CredentialCache ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The constructor creates a <see cref="T:System.Net.CredentialCache" /> instance.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a new instance of the <see cref="T:System.Net.CredentialCache" /> class.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Add">
<MemberSignature Language="ILASM" Value=".method public hidebysig instance void Add(class System.Uri uriPrefix, string authType, class System.Net.NetworkCredential cred)" />
<MemberSignature Language="C#" Value="public void Add (Uri uriPrefix, string authType, System.Net.NetworkCredential cred);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Add(class System.Uri uriPrefix, string authType, class System.Net.NetworkCredential cred) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="uriPrefix" Type="System.Uri" />
<Parameter Name="authType" Type="System.String" />
<Parameter Name="cred" Type="System.Net.NetworkCredential" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentNullException">The <paramref name="uriPrefix" /> or <paramref name="authType" /> parameter is <see langword="null" />.</exception>
<exception cref="T:System.ArgumentException">The cache already contains a credential for the specified <paramref name="uriPrefix" /> and <paramref name="authType." /></exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.CredentialCache.Add(System.Uri,System.String,System.Net.NetworkCredential)" /> method places a <see cref="T:System.Net.NetworkCredential" /> instance for use with protocols other than SMTP into the <see cref="T:System.Net.CredentialCache" />. The cache stores credentials in the order in which they are added to it. When the <see cref="M:System.Net.CredentialCache.GetCredential(System.Uri,System.String)" /> method is called, it returns the proper matching <see cref="T:System.Net.NetworkCredential" /> instance.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds a <see cref="T:System.Net.NetworkCredential" /> instance to the credential cache for use with protocols other than SMTP and associates it with a Uniform Resource Identifier (URI) prefix and authentication protocol. </para>
</summary>
<param name="uriPrefix">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> that specifies the URI prefix of the resources that the credential grants access to. </param>
<param name="authType">
<attribution license="cc4" from="Microsoft" modified="false" />The authentication scheme used by the resource named in <paramref name="uriPrefix" />. </param>
<param name="cred">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.NetworkCredential" /> to add to the credential cache. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Add">
<MemberSignature Language="C#" Value="public void Add (string host, int port, string authenticationType, System.Net.NetworkCredential credential);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Add(string host, int32 port, string authenticationType, class System.Net.NetworkCredential credential) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="host" Type="System.String" />
<Parameter Name="port" Type="System.Int32" />
<Parameter Name="authenticationType" Type="System.String" />
<Parameter Name="credential" Type="System.Net.NetworkCredential" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method places a <see cref="T:System.Net.NetworkCredential" /> instance for use with SMTP into the <see cref="T:System.Net.CredentialCache" />. The cache stores credentials in the order in which they are added to it. When the <see cref="M:System.Net.CredentialCache.GetCredential(System.String,System.Int32,System.String)" /> method is called, it returns a <see cref="T:System.Net.NetworkCredential" /> instance that is selected by matching the <paramref name="host" />, <paramref name="port" />, and <paramref name="authType" />. The comparison is done case-insensitively.</para>
<para>The supported values for <paramref name="authType " />are "NTLM", "Digest", "Kerberos", and "Negotiate". </para>
<para>Credentials added with this method are only valid for use with SMTP. This method does not work for HTTP or FTP protocols.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds a <see cref="T:System.Net.NetworkCredential" /> instance for use with SMTP to the credential cache and associates it with a host computer, port, and authentication protocol. Credentials added using this method are valid for SMTP only. This method does not work for HTTP or FTP requests.</para>
</summary>
<param name="host">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that identifies the host computer.</param>
<param name="port">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Int32" /> that specifies the port to connect to on <paramref name="host" />.</param>
<param name="authenticationType">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that identifies the authentication scheme used when connecting to <paramref name="host" /> using <paramref name="cred" />. See Remarks.</param>
<param name="credential">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.NetworkCredential" /> to add to the credential cache. </param>
</Docs>
</Member>
<Member MemberName="DefaultCredentials">
<MemberSignature Language="ILASM" Value=".property class System.Net.ICredentials DefaultCredentials { public hidebysig static specialname class System.Net.ICredentials get_DefaultCredentials() }" />
<MemberSignature Language="C#" Value="public static System.Net.ICredentials DefaultCredentials { get; }" />
<MemberSignature Language="ILAsm" Value=".property class System.Net.ICredentials DefaultCredentials" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.MonoTODO("Need EnvironmentPermission implementation first")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Net.ICredentials</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.Net.ICredentials" /> instance that represents the system credentials in use for the current process.</para>
</value>
<permission cref="T:System.Security.Permissions.EnvironmentPermission">Requires read access to the environment variable that contains the user name. See <see cref="F:System.Security.Permissions.EnvironmentPermissionAccess.Read" />.</permission>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.CredentialCache.DefaultCredentials" /> property applies only to NTLM, negotiate, and Kerberos-based authentication.</para>
<para>
<see cref="P:System.Net.CredentialCache.DefaultCredentials" /> represents the system credentials for the current security context in which the application is running. For a client-side application, these are usually the Windows credentials (user name, password, and domain) of the user running the application. For ASP.NET applications, the default credentials are the user credentials of the logged-in user, or the user being impersonated.</para>
<para>To get the credentials as a <see cref="T:System.Net.NetworkCredential" /> instance, use the <see cref="P:System.Net.CredentialCache.DefaultNetworkCredentials" /> property.</para>
<para>The supported values for <paramref name="authType " />are "NTLM", "Digest", "Kerberos", and "Negotiate". This method does not work for HTTP or FTP protocols.</para>
<block subset="none" type="note">
<para>The <see cref="T:System.Net.ICredentials" /> instance returned by <see cref="P:System.Net.CredentialCache.DefaultCredentials" /> cannot be used to view the user name, password, or domain of the current security context.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the system credentials of the application.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="DefaultNetworkCredentials">
<MemberSignature Language="C#" Value="public static System.Net.NetworkCredential DefaultNetworkCredentials { get; }" />
<MemberSignature Language="ILAsm" Value=".property class System.Net.NetworkCredential DefaultNetworkCredentials" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.NetworkCredential</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The credentials returned by the <see cref="P:System.Net.CredentialCache.DefaultNetworkCredentials" /> property is applicable only for NTLM, negotiate, and Kerberos-based authentication.</para>
<para>The credentials returned by <see cref="P:System.Net.CredentialCache.DefaultNetworkCredentials" /> represents the authentication credentials for the current security context in which the application is running. For a client-side application, these are usually the Windows credentials (user name, password, and domain) of the user running the application. For ASP.NET applications, the default network credentials are the user credentials of the logged-in user, or the user being impersonated.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the network credentials of the current security context.</para>
</summary>
</Docs>
</Member>
<Member MemberName="GetCredential">
<MemberSignature Language="ILASM" Value=".method public final hidebysig virtual class System.Net.NetworkCredential GetCredential(class System.Uri uriPrefix, string authType)" />
<MemberSignature Language="C#" Value="public System.Net.NetworkCredential GetCredential (Uri uriPrefix, string authType);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Net.NetworkCredential GetCredential(class System.Uri uriPrefix, string authType) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.NetworkCredential</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="uriPrefix" Type="System.Uri" />
<Parameter Name="authType" Type="System.String" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentNullException">The <paramref name="uriPrefix" /> or <paramref name="authType" /> parameter is <see langword="null" />.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.CredentialCache.GetCredential(System.Uri,System.String)" /> method searches the <see cref="T:System.Net.CredentialCache" /> and returns the <see cref="T:System.Net.NetworkCredential" /> instance for the specified URI and authorization type. If the <see cref="T:System.Net.CredentialCache" /> contains no matching <see cref="T:System.Net.NetworkCredential" /> instance, null is returned.</para>
<para>
<see cref="M:System.Net.CredentialCache.GetCredential(System.Uri,System.String)" /> uses the longest matching URI prefix in the cache to determine which set of credentials to return for an authorization type. The following table shows examples.</para>
<list type="table">
<listheader>
<item>
<term>
<para>URI Prefix </para>
</term>
<description>
<para>Matches </para>
</description>
</item>
</listheader>
<item>
<term>
<para>http://www.contoso.com/portal/news.htm </para>
</term>
<description>
<para>Requests for the specific Web page news.htm. </para>
</description>
</item>
<item>
<term>
<para>http://www.contoso.com/portal/ </para>
</term>
<description>
<para>Requests for all content in the portal path, except the page news.htm. </para>
</description>
</item>
<item>
<term>
<para>http://www.contoso.com/ </para>
</term>
<description>
<para>Requests for all resources at www.contoso.com, except those in the portal path. </para>
</description>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns the <see cref="T:System.Net.NetworkCredential" /> instance associated with the specified Uniform Resource Identifier (URI) and authentication type.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Net.NetworkCredential" /> or, if there is no matching credential in the cache, null.</para>
</returns>
<param name="uriPrefix">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> that specifies the URI prefix of the resources that the credential grants access to. </param>
<param name="authType">
<attribution license="cc4" from="Microsoft" modified="false" />The authentication scheme used by the resource named in <paramref name="uriPrefix" />. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="GetCredential">
<MemberSignature Language="C#" Value="public System.Net.NetworkCredential GetCredential (string host, int port, string authenticationType);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Net.NetworkCredential GetCredential(string host, int32 port, string authenticationType) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.NetworkCredential</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="host" Type="System.String" />
<Parameter Name="port" Type="System.Int32" />
<Parameter Name="authenticationType" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method searches the <see cref="T:System.Net.CredentialCache" /> and returns the <see cref="T:System.Net.NetworkCredential" /> instance for the specified host, port, and authorization type. The <paramref name="host" />, <paramref name="port" />, and <paramref name="authType" /> values passed to this method are case-insensitively compared to the values specified when the credential was added to the <see cref="T:System.Net.CredentialCache" /> using the <see cref="Overload:System.Net.CredentialCache.Add" /> methods.</para>
<para>The supported values for <paramref name="authType" /> are "NTLM", "Digest", "Kerberos", and "Negotiate".</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns the <see cref="T:System.Net.NetworkCredential" /> instance associated with the specified host, port, and authentication protocol.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Net.NetworkCredential" /> or, if there is no matching credential in the cache, null.</para>
</returns>
<param name="host">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that identifies the host computer.</param>
<param name="port">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Int32" /> that specifies the port to connect to on <paramref name="host" />.</param>
<param name="authenticationType">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that identifies the authentication scheme used when connecting to <paramref name="host" />. See Remarks.</param>
</Docs>
</Member>
<Member MemberName="GetEnumerator">
<MemberSignature Language="ILASM" Value=".method public final hidebysig virtual class System.Collections.IEnumerator GetEnumerator()" />
<MemberSignature Language="C#" Value="public System.Collections.IEnumerator GetEnumerator ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Collections.IEnumerator GetEnumerator() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.IEnumerator</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns an enumerator that can iterate through the <see cref="T:System.Net.CredentialCache" /> instance.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Net.CredentialCache" />.</para>
</returns>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Remove">
<MemberSignature Language="ILASM" Value=".method public hidebysig instance void Remove(class System.Uri uriPrefix, string authType)" />
<MemberSignature Language="C#" Value="public void Remove (Uri uriPrefix, string authType);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Remove(class System.Uri uriPrefix, string authType) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="uriPrefix" Type="System.Uri" />
<Parameter Name="authType" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method removes a <see cref="T:System.Net.NetworkCredential" /> instance from the <see cref="T:System.Net.CredentialCache" /> if the specified URI prefix and authentication protocol match those associated with the credential. Multiple calls to the <see cref="M:System.Net.CredentialCache.Remove(System.Uri,System.String)" /> method for the same <see cref="T:System.Net.NetworkCredential" /> have no effect.</para>
<para>If <paramref name="authType" /> is null or <paramref name="uriPrefix" /> is null, or no matching credential is found in the cache, this method does nothing.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Deletes a <see cref="T:System.Net.NetworkCredential" /> instance from the cache if it is associated with the specified Uniform Resource Identifier (URI) prefix and authentication protocol.</para>
</summary>
<param name="uriPrefix">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> that specifies the URI prefix of the resources that the credential is used for. </param>
<param name="authType">
<attribution license="cc4" from="Microsoft" modified="false" />The authentication scheme used by the host named in <paramref name="uriPrefix" />. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Remove">
<MemberSignature Language="C#" Value="public void Remove (string host, int port, string authenticationType);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Remove(string host, int32 port, string authenticationType) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="host" Type="System.String" />
<Parameter Name="port" Type="System.Int32" />
<Parameter Name="authenticationType" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method removes a <see cref="T:System.Net.NetworkCredential" /> instance from the <see cref="T:System.Net.CredentialCache" /> if the specified host, port, and authentication protocol match those associated with the credential. Multiple calls to the <see cref="M:System.Net.CredentialCache.Remove(System.String,System.Int32,System.String)" /> method for the same <see cref="T:System.Net.NetworkCredential" /> have no effect.</para>
<para>If <paramref name="authType" /> is null or <paramref name="uriPrefix" /> is null, or no matching credential is found in the cache, this method does nothing.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Deletes a <see cref="T:System.Net.NetworkCredential" /> instance from the cache if it is associated with the specified host, port, and authentication protocol.</para>
</summary>
<param name="host">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that identifies the host computer.</param>
<param name="port">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Int32" /> that specifies the port to connect to on <paramref name="host" />.</param>
<param name="authenticationType">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that identifies the authentication scheme used when connecting to <paramref name="host" />. See Remarks.</param>
</Docs>
</Member>
</Members>
<TypeExcluded>0</TypeExcluded>
</Type>

81
mcs/class/System/Documentation/en/System.Net/DecompressionMethods.xml Normal file
View File

@ -0,0 +1,81 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DecompressionMethods" FullName="System.Net.DecompressionMethods">
<TypeSignature Language="C#" Value="public enum DecompressionMethods" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed DecompressionMethods extends System.Enum" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Attributes>
<Attribute>
<AttributeName>System.Flags</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the file compression and decompression encoding format to be used to compress the data received in response to an <see cref="T:System.Net.HttpWebRequest" />.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Deflate">
<MemberSignature Language="C#" Value="Deflate" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Net.DecompressionMethods Deflate = int32(2)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.DecompressionMethods</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the deflate compression-decompression algorithm.</para>
</summary>
</Docs>
</Member>
<Member MemberName="GZip">
<MemberSignature Language="C#" Value="GZip" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Net.DecompressionMethods GZip = int32(1)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.DecompressionMethods</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the gZip compression-decompression algorithm.</para>
</summary>
</Docs>
</Member>
<Member MemberName="None">
<MemberSignature Language="C#" Value="None" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Net.DecompressionMethods None = int32(0)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.DecompressionMethods</ReturnType>
</ReturnValue>
<Docs>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Do not use compression.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

934
mcs/class/System/Documentation/en/System.Net/Dns.xml Normal file
View File

File diff suppressed because it is too large Load Diff

227
mcs/class/System/Documentation/en/System.Net/DnsEndPoint.xml Normal file
View File

@ -0,0 +1,227 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DnsEndPoint" FullName="System.Net.DnsEndPoint">
<TypeSignature Language="C#" Value="public class DnsEndPoint : System.Net.EndPoint" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit DnsEndPoint extends System.Net.EndPoint" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Net.EndPoint</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Net.DnsEndPoint" /> class contains a host name or an IP address and remote port information needed by an application to connect to a service on a host. By combining the host name or IP address and port number of a service, the <see cref="T:System.Net.DnsEndPoint" /> class forms a connection point to a service.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents a network endpoint as a host name or a string representation of an IP address and a port number.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DnsEndPoint (string host, int port);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string host, int32 port) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="host" Type="System.String" />
<Parameter Name="port" Type="System.Int32" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.DnsEndPoint.#ctor(System.String,System.Int32)" /> constructor can be used to initialize a <see cref="T:System.Net.DnsEndPoint" /> class using either a host name or a string that represents an IP address and a port. This constructor sets the <see cref="P:System.Net.DnsEndPoint.AddressFamily" /> property to <see cref="F:System.Net.Sockets.AddressFamily.Unknown" />. </para>
<para>When using this constructor with a host name rather than a string representation of an IP address, the address family of the <see cref="T:System.Net.DnsEndPoint" /> will remain <see cref="F:System.Net.Sockets.AddressFamily.Unknown" /> even after use. The <see cref="P:System.Net.DnsEndPoint.AddressFamily" /> property of any <see cref="T:System.Net.Sockets.Socket" /> that is created by calls to the <see cref="M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs)" /> method will be the address family of the first address to which a connection can be successfully established (not necessarily the first address to be resolved).</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Net.DnsEndPoint" /> class with the host name or string representation of an IP address and a port number.</para>
</summary>
<param name="host">
<attribution license="cc4" from="Microsoft" modified="false" />The host name or a string representation of the IP address.</param>
<param name="port">
<attribution license="cc4" from="Microsoft" modified="false" />The port number associated with the address, or 0 to specify any available port. <paramref name="port" /> is in host order.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DnsEndPoint (string host, int port, System.Net.Sockets.AddressFamily addressFamily);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string host, int32 port, valuetype System.Net.Sockets.AddressFamily addressFamily) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="host" Type="System.String" />
<Parameter Name="port" Type="System.Int32" />
<Parameter Name="addressFamily" Type="System.Net.Sockets.AddressFamily" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.DnsEndPoint.#ctor(System.String,System.Int32,System.Net.Sockets.AddressFamily)" /> constructor can be used to initialize a <see cref="T:System.Net.DnsEndPoint" /> class using either a host name or a string that represents an IP address, a port, and an address family. </para>
<para>When using the constructor with a host name rather than a string representation of an IP address, the address family restricts DNS resolution to prefer addresses of the specified address family value. When using the constructor with the address family specified as <see cref="F:System.Net.Sockets.AddressFamily.Unknown" />, the address family of the <see cref="T:System.Net.DnsEndPoint" /> will remain <see cref="F:System.Net.Sockets.AddressFamily.Unknown" /> even after use. The <see cref="P:System.Net.DnsEndPoint.AddressFamily" /> property of any <see cref="T:System.Net.Sockets.Socket" /> that is created by calls to the <see cref="M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs)" /> method will be the address family of the first address to which a connection can be successfully established (not necessarily the first address to be resolved).</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Net.DnsEndPoint" /> class with the host name or string representation of an IP address, a port number, and an address family.</para>
</summary>
<param name="host">
<attribution license="cc4" from="Microsoft" modified="false" />The host name or a string representation of the IP address.</param>
<param name="port">
<attribution license="cc4" from="Microsoft" modified="false" />The port number associated with the address, or 0 to specify any available port. <paramref name="port" /> is in host order.</param>
<param name="addressFamily">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Net.Sockets.AddressFamily" /> values.</param>
</Docs>
</Member>
<Member MemberName="AddressFamily">
<MemberSignature Language="C#" Value="public override System.Net.Sockets.AddressFamily AddressFamily { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Net.Sockets.AddressFamily AddressFamily" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.Sockets.AddressFamily</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.DnsEndPoint.AddressFamily" /> property indicates the address family for an instance of the <see cref="T:System.Net.DnsEndPoint" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the Internet Protocol (IP) address family.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Equals">
<MemberSignature Language="C#" Value="public override bool Equals (object comparand);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance bool Equals(object comparand) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="comparand" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.DnsEndPoint.Equals(System.Object)" /> method compares the current <see cref="T:System.Net.DnsEndPoint" /> instance with the <paramref name="comparand" /> parameter and returns true if the two instances contain the same endpoint.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Compares two <see cref="T:System.Net.DnsEndPoint" /> objects.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the two <see cref="T:System.Net.DnsEndPoint" /> instances are equal; otherwise, false.</para>
</returns>
<param name="comparand">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.DnsEndPoint" /> instance to compare to the current instance.</param>
</Docs>
</Member>
<Member MemberName="GetHashCode">
<MemberSignature Language="C#" Value="public override int GetHashCode ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 GetHashCode() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.DnsEndPoint.GetHashCode" /> method returns a hash code of the <see cref="T:System.Net.DnsEndPoint" />. This value can be used as a key in hash tables.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a hash value for a <see cref="T:System.Net.DnsEndPoint" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An integer hash value for the <see cref="T:System.Net.DnsEndPoint" />.</para>
</returns>
</Docs>
</Member>
<Member MemberName="Host">
<MemberSignature Language="C#" Value="public string Host { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Host" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.DnsEndPoint.Host" /> property indicates the host name or string representation of the IP address for an instance of the <see cref="T:System.Net.DnsEndPoint" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the host name or string representation of the Internet Protocol (IP) address of the host.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Port">
<MemberSignature Language="C#" Value="public int Port { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance int32 Port" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the port number of the <see cref="T:System.Net.DnsEndPoint" />.</para>
</summary>
</Docs>
</Member>
<Member MemberName="ToString">
<MemberSignature Language="C#" Value="public override string ToString ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance string ToString() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.DnsEndPoint.ToString" /> method returns a string that contains the address family, the host name or IP address string, and the port number.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns the host name or string representation of the IP address and port number of the <see cref="T:System.Net.DnsEndPoint" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A string containing the address family, host name or IP address string, and the port number of the specified <see cref="T:System.Net.DnsEndPoint" />.</para>
</returns>
</Docs>
</Member>
</Members>
</Type>

299
mcs/class/System/Documentation/en/System.Net/DnsPermission.xml Normal file
View File

@ -0,0 +1,299 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DnsPermission" FullName="System.Net.DnsPermission" FullNameSP="System_Net_DnsPermission" Maintainer="ecma">
<TypeSignature Language="ILASM" Value=".class public serializable DnsPermission extends System.Security.CodeAccessPermission" />
<TypeSignature Language="C#" Value="public sealed class DnsPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable sealed beforefieldinit DnsPermission extends System.Security.CodeAccessPermission implements class System.Security.Permissions.IUnrestrictedPermission" />
<MemberOfLibrary>Networking</MemberOfLibrary>
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
<AssemblyVersion>1.0.x.x</AssemblyVersion>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
<Base>
<BaseTypeName>System.Security.CodeAccessPermission</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.Security.Permissions.IUnrestrictedPermission</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The default permissions allow all local and Intranet zone applications to access DNS services, and no DNS permission for Internet zone applications.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Controls rights to access Domain Name System (DNS) servers on the network.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(valuetype System.Security.Permissions.PermissionState state)" />
<MemberSignature Language="C#" Value="public DnsPermission (System.Security.Permissions.PermissionState state);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(valuetype System.Security.Permissions.PermissionState state) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="state" Type="System.Security.Permissions.PermissionState" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentException">
<paramref name="state" /> is not a valid <see cref="T:System.Security.Permissions.PermissionState" /> value.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If <paramref name="state" /> is <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" />, the <see cref="T:System.Net.DnsPermission" /> instance passes all demands. If <paramref name="state" /> contains any other value, the <see cref="T:System.Net.DnsPermission" /> instance fails all demands.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a new instance of the <see cref="T:System.Net.DnsPermission" /> class that either allows unrestricted DNS access or disallows DNS access.</para>
</summary>
<param name="state">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Permissions.PermissionState" /> values. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Copy">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual class System.Security.IPermission Copy()" />
<MemberSignature Language="C#" Value="public override System.Security.IPermission Copy ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Security.IPermission Copy() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.IPermission</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A copy of a <see cref="T:System.Net.DnsPermission" /> instance provides the same access to DNS servers as the original permission instance.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates an identical copy of the current permission instance.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A new instance of the <see cref="T:System.Net.DnsPermission" /> class that is an identical copy of the current instance.</para>
</returns>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="FromXml">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual void FromXml(class System.Security.SecurityElement securityElement)" />
<MemberSignature Language="C#" Value="public override void FromXml (System.Security.SecurityElement securityElement);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void FromXml(class System.Security.SecurityElement securityElement) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="securityElement" Type="System.Security.SecurityElement" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentNullException">
<para>
<paramref name="securityElement " />is <see langword="null" /></para>
</exception>
<exception cref="T:System.ArgumentException">
<para>
<paramref name="securityElement " />is not a <see cref="T:System.Net.DnsPermission" /> element.</para>
</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.DnsPermission.FromXml(System.Security.SecurityElement)" /> method reconstructs a <see cref="T:System.Net.DnsPermission" /> instance from an XML encoding defined by the <see cref="T:System.Security.SecurityElement" /> class.</para>
<para>Use the <see cref="M:System.Net.DnsPermission.ToXml" /> method to XML-encode the <see cref="T:System.Net.DnsPermission" /> instance, including state information.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reconstructs a <see cref="T:System.Net.DnsPermission" /> instance from an XML encoding.</para>
</summary>
<param name="securityElement">
<attribution license="cc4" from="Microsoft" modified="false" />The XML encoding to use to reconstruct the <see cref="T:System.Net.DnsPermission" /> instance. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Intersect">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual class System.Security.IPermission Intersect(class System.Security.IPermission target)" />
<MemberSignature Language="C#" Value="public override System.Security.IPermission Intersect (System.Security.IPermission target);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Security.IPermission Intersect(class System.Security.IPermission target) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.IPermission</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="target" Type="System.Security.IPermission" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentNullException">
<paramref name="target " />is <see langword="null" />.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.DnsPermission.Intersect(System.Security.IPermission)" /> method returns a <see cref="T:System.Net.DnsPermission" /> instance that allows the access defined by both the current <see cref="T:System.Net.DnsPermission" /> instance and the specified <see cref="T:System.Net.DnsPermission" /> instance. Any demand must pass both permissions to pass their intersection.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a permission instance that is the intersection of the current permission instance and the specified permission instance.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Net.DnsPermission" /> instance that represents the intersection of the current <see cref="T:System.Net.DnsPermission" /> instance with the specified <see cref="T:System.Net.DnsPermission" /> instance, or null if the intersection is empty. If both the current instance and <paramref name="target" /> are unrestricted, this method returns a new <see cref="T:System.Net.DnsPermission" /> instance that is unrestricted; otherwise, it returns null.</para>
</returns>
<param name="target">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.DnsPermission" /> instance to intersect with the current instance. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="IsSubsetOf">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual bool IsSubsetOf(class System.Security.IPermission target)" />
<MemberSignature Language="C#" Value="public override bool IsSubsetOf (System.Security.IPermission target);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance bool IsSubsetOf(class System.Security.IPermission target) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="target" Type="System.Security.IPermission" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The current <see cref="T:System.Net.DnsPermission" /> instance is a subset of the specified <see cref="T:System.Net.DnsPermission" /> instance if the current <see cref="T:System.Net.DnsPermission" /> instance specifies a set of operations that is wholly contained by the specified <see cref="T:System.Net.DnsPermission" /> instance.</para>
<para>If the <see cref="M:System.Net.DnsPermission.IsSubsetOf(System.Security.IPermission)" /> method returns true, the current <see cref="T:System.Net.DnsPermission" /> instance allows no more access to DNS servers than does the specified <see cref="T:System.Net.DnsPermission" /> instance.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether the current permission instance is a subset of the specified permission instance.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>false if the current instance is unrestricted and <paramref name="target" /> is either null or unrestricted; otherwise, true.</para>
</returns>
<param name="target">
<attribution license="cc4" from="Microsoft" modified="false" />The second <see cref="T:System.Net.DnsPermission" /> instance to be tested for the subset relationship. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="IsUnrestricted">
<MemberSignature Language="C#" Value="public bool IsUnrestricted ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance bool IsUnrestricted() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Checks the overall permission state of the object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the <see cref="T:System.Net.DnsPermission" /> instance was created with <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" />; otherwise, false.</para>
</returns>
</Docs>
</Member>
<Member MemberName="ToXml">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual class System.Security.SecurityElement ToXml()" />
<MemberSignature Language="C#" Value="public override System.Security.SecurityElement ToXml ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Security.SecurityElement ToXml() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.SecurityElement</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.DnsPermission.ToXml" /> method creates a <see cref="T:System.Security.SecurityElement" /> instance to XML-encode a representation of the <see cref="T:System.Net.DnsPermission" /> instance, including state information.</para>
<para>Use the <see cref="M:System.Net.DnsPermission.FromXml(System.Security.SecurityElement)" /> method to restore the state information from a <see cref="T:System.Security.SecurityElement" /> instance.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates an XML encoding of a <see cref="T:System.Net.DnsPermission" /> instance and its current state.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Security.SecurityElement" /> instance that contains an XML-encoded representation of the security object, including state information.</para>
</returns>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Union">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual class System.Security.IPermission Union(class System.Security.IPermission target)" />
<MemberSignature Language="C#" Value="public override System.Security.IPermission Union (System.Security.IPermission target);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Security.IPermission Union(class System.Security.IPermission target) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.IPermission</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="target" Type="System.Security.IPermission" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentNullException">
<paramref name="target " />is <see langword="null" />.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.DnsPermission.Union(System.Security.IPermission)" /> method returns a <see cref="T:System.Net.DnsPermission" /> instance that allows the access defined by either the current <see cref="T:System.Net.DnsPermission" /> instance or the specified <see cref="T:System.Net.DnsPermission" /> instance. Any demand that passes either permission passes their union.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a permission instance that is the union of the current permission instance and the specified permission instance.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Net.DnsPermission" /> instance that represents the union of the current <see cref="T:System.Net.DnsPermission" /> instance with the specified <see cref="T:System.Net.DnsPermission" /> instance. If <paramref name="target" /> is null, this method returns a copy of the current instance. If the current instance or <paramref name="target" /> is unrestricted, this method returns a <see cref="T:System.Net.DnsPermission" /> instance that is unrestricted; otherwise, it returns a <see cref="T:System.Net.DnsPermission" /> instance that is restricted.</para>
</returns>
<param name="target">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.DnsPermission" /> instance to combine with the current instance. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
</Members>
<TypeExcluded>0</TypeExcluded>
</Type>

102
mcs/class/System/Documentation/en/System.Net/DnsPermissionAttribute.xml Normal file
View File

@ -0,0 +1,102 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DnsPermissionAttribute" FullName="System.Net.DnsPermissionAttribute" FullNameSP="System_Net_DnsPermissionAttribute" Maintainer="ecma">
<TypeSignature Language="ILASM" Value=".class public sealed serializable DnsPermissionAttribute extends System.Security.Permissions.CodeAccessSecurityAttribute" />
<TypeSignature Language="C#" Value="public sealed class DnsPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable sealed beforefieldinit DnsPermissionAttribute extends System.Security.Permissions.CodeAccessSecurityAttribute" />
<MemberOfLibrary>Networking</MemberOfLibrary>
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
<AssemblyVersion>1.0.x.x</AssemblyVersion>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
<Base>
<BaseTypeName>System.Security.Permissions.CodeAccessSecurityAttribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Struct | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.All, AllowMultiple=true, Inherited=false)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The security information declared by <see cref="T:System.Net.DnsPermissionAttribute" /> is stored in the metadata of the attribute target, which is the class to which the <see cref="T:System.Net.DnsPermissionAttribute" /> is applied. The system then accesses this information at run time. The <see cref="T:System.Security.Permissions.SecurityAction" /> that is passed to the constructor determines the allowable DNS targets.</para>
<para>These security attributes are used only for <format type="text/html"><a href="97E21EFD-6E89-4115-90D5-AD239513DAD8">[&lt;topic://cpcondeclarativesecurity&gt;]</a></format>. For <format type="text/html"><a href="15AAB1E1-6B7D-41AD-B102-C1ED7BEDEA27">[&lt;topic://cpconimperativesecurity&gt;]</a></format>, use the corresponding <see cref="T:System.Net.DnsPermission" /> class.</para>
<para>Security access is either fully restricted or fully unrestricted. Set the <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" /> property to true to grant access, or false for no access. Set this property as a named parameter.</para>
<para>For more information about using attributes, see <format type="text/html"><a href="30386922-1E00-4602-9EBF-526B271A8B87">[&lt;topic://cpconExtendingMetadataUsingAttributes&gt;]</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies permission to request information from Domain Name Servers.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(valuetype System.Security.Permissions.SecurityAction action)" />
<MemberSignature Language="C#" Value="public DnsPermissionAttribute (System.Security.Permissions.SecurityAction action);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(valuetype System.Security.Permissions.SecurityAction action) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="action" Type="System.Security.Permissions.SecurityAction" />
</Parameters>
<Docs>
<exception cref="T:System.ArgumentException">
<paramref name="action" /> is not a valid <see cref="T:System.Security.Permissions.SecurityAction" /> value. </exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Security.Permissions.SecurityAction" /> value that is passed to this constructor specifies the allowable <see cref="T:System.Net.DnsPermissionAttribute" /> targets.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Net.DnsPermissionAttribute" /> class with the specified <see cref="T:System.Security.Permissions.SecurityAction" /> value.</para>
</summary>
<param name="action">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Permissions.SecurityAction" /> values. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="CreatePermission">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual class System.Security.IPermission CreatePermission()" />
<MemberSignature Language="C#" Value="public override System.Security.IPermission CreatePermission ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Security.IPermission CreatePermission() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Security.IPermission</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The CreatePermission method is called by the security system, not by application code.</para>
<para>The security information described by <see cref="T:System.Net.DnsPermissionAttribute" /> is stored in the metadata of the attribute target, which is the class to which <see cref="T:System.Net.DnsPermissionAttribute" /> is applied. The system then accesses the information at run time and calls <see cref="M:System.Net.DnsPermissionAttribute.CreatePermission" />. The system uses the returned <see cref="T:System.Security.IPermission" /> to enforce the specified security requirements.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates and returns a new instance of the <see cref="T:System.Net.DnsPermission" /> class.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Net.DnsPermission" /> that corresponds to the security declaration.</para>
</returns>
</Docs>
<Excluded>0</Excluded>
</Member>
</Members>
<TypeExcluded>0</TypeExcluded>
</Type>

51
mcs/class/System/Documentation/en/System.Net/DownloadDataCompletedEventArgs.xml Normal file
View File

@ -0,0 +1,51 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DownloadDataCompletedEventArgs" FullName="System.Net.DownloadDataCompletedEventArgs">
<TypeSignature Language="C#" Value="public class DownloadDataCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit DownloadDataCompletedEventArgs extends System.ComponentModel.AsyncCompletedEventArgs" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.ComponentModel.AsyncCompletedEventArgs</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Instances of this class are passed to the <see cref="T:System.Net.DownloadDataCompletedEventHandler" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides data for the <see cref="E:System.Net.WebClient.DownloadDataCompleted" /> event.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Result">
<MemberSignature Language="C#" Value="public byte[] Result { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance unsigned int8[] Result" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Byte[]</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You should check the <see cref="P:System.ComponentModel.AsyncCompletedEventArgs.Error" /> and <see cref="P:System.ComponentModel.AsyncCompletedEventArgs.Cancelled" /> properties before using the data that is returned by this property. If the <see cref="P:System.ComponentModel.AsyncCompletedEventArgs.Error" /> property's value is an <see cref="T:System.Exception" /> object or the <see cref="P:System.ComponentModel.AsyncCompletedEventArgs.Cancelled" /> property's value is true, the asynchronous operation did not complete correctly and the <see cref="P:System.Net.DownloadDataCompletedEventArgs.Result" /> property's value will not be valid.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the data that is downloaded by a <see cref="Overload:System.Net.WebClient.DownloadDataAsync" /> method.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

33
mcs/class/System/Documentation/en/System.Net/DownloadDataCompletedEventHandler.xml Normal file
View File

@ -0,0 +1,33 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DownloadDataCompletedEventHandler" FullName="System.Net.DownloadDataCompletedEventHandler">
<TypeSignature Language="C#" Value="public delegate void DownloadDataCompletedEventHandler(object sender, DownloadDataCompletedEventArgs e);" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed DownloadDataCompletedEventHandler extends System.MulticastDelegate" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Delegate</BaseTypeName>
</Base>
<Parameters>
<Parameter Name="sender" Type="System.Object" />
<Parameter Name="e" Type="System.Net.DownloadDataCompletedEventArgs" />
</Parameters>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Docs>
<param name="sender">To be added.</param>
<param name="e">To be added.</param>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When you create a <see cref="T:System.Net.DownloadDataCompletedEventHandler" /> delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event handler delegates, see <format type="text/html"><a href="D98FD58B-FA4F-4598-8378-ADDF4355A115"></a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the method that will handle the <see cref="E:System.Net.WebClient.DownloadDataCompleted" /> event of a <see cref="T:System.Net.WebClient" />.</para>
</summary>
</Docs>
</Type>

76
mcs/class/System/Documentation/en/System.Net/DownloadProgressChangedEventArgs.xml Normal file
View File

@ -0,0 +1,76 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DownloadProgressChangedEventArgs" FullName="System.Net.DownloadProgressChangedEventArgs">
<TypeSignature Language="C#" Value="public class DownloadProgressChangedEventArgs : System.ComponentModel.ProgressChangedEventArgs" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit DownloadProgressChangedEventArgs extends System.ComponentModel.ProgressChangedEventArgs" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.ComponentModel.ProgressChangedEventArgs</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Instances of this class are passed to the <see cref="T:System.Net.DownloadProgressChangedEventHandler" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides data for the <see cref="E:System.Net.WebClient.DownloadProgressChanged" /> event of a <see cref="T:System.Net.WebClient" />.</para>
</summary>
</Docs>
<Members>
<Member MemberName="BytesReceived">
<MemberSignature Language="C#" Value="public long BytesReceived { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance int64 BytesReceived" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int64</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To determine what percentage of the transfer has occurred, use the <see cref="P:System.ComponentModel.ProgressChangedEventArgs.ProgressPercentage" /> property.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the number of bytes received.</para>
</summary>
</Docs>
</Member>
<Member MemberName="TotalBytesToReceive">
<MemberSignature Language="C#" Value="public long TotalBytesToReceive { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance int64 TotalBytesToReceive" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int64</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To determine the number of bytes already received, use the <see cref="P:System.Net.DownloadProgressChangedEventArgs.BytesReceived" /> property.</para>
<para>To determine what percentage of the transfer has occurred, use the <see cref="P:System.ComponentModel.ProgressChangedEventArgs.ProgressPercentage" /> property.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the total number of bytes in a <see cref="T:System.Net.WebClient" /> data download operation.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

36
mcs/class/System/Documentation/en/System.Net/DownloadProgressChangedEventHandler.xml Normal file
View File

@ -0,0 +1,36 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DownloadProgressChangedEventHandler" FullName="System.Net.DownloadProgressChangedEventHandler">
<TypeSignature Language="C#" Value="public delegate void DownloadProgressChangedEventHandler(object sender, DownloadProgressChangedEventArgs e);" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed DownloadProgressChangedEventHandler extends System.MulticastDelegate" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Delegate</BaseTypeName>
</Base>
<Parameters>
<Parameter Name="sender" Type="System.Object" />
<Parameter Name="e" Type="System.Net.DownloadProgressChangedEventArgs" />
</Parameters>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Docs>
<param name="sender">To be added.</param>
<param name="e">To be added.</param>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When you create a <see cref="T:System.Net.DownloadProgressChangedEventHandler" /> delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event handler delegates, see <format type="text/html"><a href="d98fd58b-fa4f-4598-8378-addf4355a115">Events and Delegates</a></format>. <format type="text/html"><a href="D98FD58B-FA4F-4598-8378-ADDF4355A115"></a></format></para>
<block subset="none" type="note">
<para>If the server does not send the size of the downloaded file (such as in the case of a passive FTP connection), <see cref="P:System.ComponentModel.ProgressChangedEventArgs.ProgressPercentage" /> may always be zero.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the method that will handle the <see cref="E:System.Net.WebClient.DownloadProgressChanged" /> event of a <see cref="T:System.Net.WebClient" />.</para>
</summary>
</Docs>
</Type>

Some files were not shown because too many files have changed in this diff Show More