linux-packaging-mono/mcs/class/System/Documentation/en/System.Net/GlobalProxySelection.xml

<?xml version="1.0" encoding="utf-8"?>
<Type Name="GlobalProxySelection" FullName="System.Net.GlobalProxySelection" FullNameSP="System_Net_GlobalProxySelection" Maintainer="ecma">
  <TypeSignature Language="ILASM" Value=".class public GlobalProxySelection extends System.Object" />
  <TypeSignature Language="C#" Value="public class GlobalProxySelection" />
  <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit GlobalProxySelection 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 />
  <Attributes>
    <Attribute>
      <AttributeName>System.Obsolete("Use WebRequest.DefaultProxy instead")</AttributeName>
    </Attribute>
  </Attributes>
  <Docs>
    <remarks>
      <attribution license="cc4" from="Microsoft" modified="false" />
      <para>The <see cref="T:System.Net.GlobalProxySelection" /> stores the proxy settings for the default proxy that <see cref="T:System.Net.WebRequest" /> instances use to contact Internet sites beyond the local network. The default proxy setting is initialized from the global or application configuration file, and can be overridden for individual requests or disabled by setting the <see cref="P:System.Net.HttpWebRequest.Proxy" /> property to the result of the <see cref="M:System.Net.GlobalProxySelection.GetEmptyWebProxy" /> method.</para>
      <para>The proxy settings stored in <see cref="T:System.Net.GlobalProxySelection" /> are used by any <see cref="T:System.Net.WebRequest" /> derived objects that support proxies and have their <see cref="P:System.Net.WebRequest.Proxy" /> property value set to null (the default). Proxies are currently supported by <see cref="T:System.Net.FtpWebRequest" />, <see cref="T:System.Net.HttpWebRequest" />, and <see cref="T:System.Net.WebClient" />.</para>
      <para>Note   Changes to the <see cref="T:System.Net.GlobalProxySelection" /> after a request is made are not reflected in a <see cref="T:System.Net.WebRequest" />.</para>
    </remarks>
    <summary>
      <attribution license="cc4" from="Microsoft" modified="false" />
      <para>Contains a global default proxy instance for all HTTP requests.</para>
    </summary>
  </Docs>
  <Members>
    <Member MemberName=".ctor">
      <MemberSignature Language="ILASM" Value="family specialname instance void .ctor()" />
      <MemberSignature Language="C#" Value="public GlobalProxySelection ();" />
      <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>To be added.</remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Initializes a new instance of the <see cref="T:System.Net.GlobalProxySelection" /> class.</para>
        </summary>
      </Docs>
      <Excluded>0</Excluded>
    </Member>
    <Member MemberName="GetEmptyWebProxy">
      <MemberSignature Language="ILASM" Value=".method public hidebysig static class System.Net.IWebProxy GetEmptyWebProxy()" />
      <MemberSignature Language="C#" Value="public static System.Net.IWebProxy GetEmptyWebProxy ();" />
      <MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Net.IWebProxy GetEmptyWebProxy() 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.IWebProxy</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The <see cref="M:System.Net.GlobalProxySelection.GetEmptyWebProxy" /> method returns a blank <see cref="T:System.Net.IWebProxy" /> instance to indicate that no proxy is used to access an Internet resource.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Returns an empty proxy instance.</para>
        </summary>
        <returns>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>An <see cref="T:System.Net.IWebProxy" /> that contains no information.</para>
        </returns>
      </Docs>
      <Excluded>0</Excluded>
    </Member>
    <Member MemberName="Select">
      <MemberSignature Language="ILASM" Value=".property class System.Net.IWebProxy Select { public hidebysig static specialname class System.Net.IWebProxy get_Select() public hidebysig static specialname void set_Select(class System.Net.IWebProxy value) }" />
      <MemberSignature Language="C#" Value="public static System.Net.IWebProxy Select { get; set; }" />
      <MemberSignature Language="ILAsm" Value=".property class System.Net.IWebProxy Select" />
      <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.IWebProxy</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <value>
          <para> A <see cref="T:System.Net.IWebProxy" />
that identifies the proxy server used by the <see cref="M:System.Net.HttpWebRequest.GetResponse" qualify="true" /> method if no proxy information is
specified. </para>
        </value>
        <exception cref="T:System.Security.SecurityException">The caller does not have permission for the requested operation.</exception>
        <permission cref="!:System.Security.Permissions.WebPermission">Requires full <see cref="T:System.Net.WebPermission" /> access. See <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" />.</permission>
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The <see cref="P:System.Net.GlobalProxySelection.Select" /> property sets the proxy that all <see cref="T:System.Net.WebRequest" /> instances use if the request supports proxies and no proxy is set explicitly using the <see cref="P:System.Net.HttpWebRequest.Proxy" /> property. Proxies are currently supported by <see cref="T:System.Net.FtpWebRequest" /> and <see cref="T:System.Net.HttpWebRequest" />.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the global HTTP proxy.</para>
        </summary>
      </Docs>
      <Excluded>0</Excluded>
    </Member>
  </Members>
  <TypeExcluded>0</TypeExcluded>
</Type>