a575963da9
Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
331 lines
23 KiB
XML
331 lines
23 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<Type Name="WebException" FullName="System.Net.WebException" FullNameSP="System_Net_WebException" Maintainer="ecma">
|
|
<TypeSignature Language="ILASM" Value=".class public serializable WebException extends System.InvalidOperationException" />
|
|
<TypeSignature Language="C#" Value="public class WebException : InvalidOperationException" />
|
|
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit WebException extends System.InvalidOperationException implements class System.Runtime.Serialization.ISerializable" />
|
|
<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.InvalidOperationException</BaseTypeName>
|
|
</Base>
|
|
<Interfaces />
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The <see cref="T:System.Net.WebException" /> class is thrown by classes descended from <see cref="T:System.Net.WebRequest" /> and <see cref="T:System.Net.WebResponse" /> that implement pluggable protocols for accessing the Internet.</para>
|
|
<para>When <see cref="T:System.Net.WebException" /> is thrown by a descendant of the <see cref="T:System.Net.WebRequest" /> class, the <see cref="P:System.Net.WebException.Response" /> property provides the Internet response to the application.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The exception that is thrown when an error occurs while accessing the network through a pluggable protocol.</para>
|
|
</summary>
|
|
</Docs>
|
|
<Members>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor()" />
|
|
<MemberSignature Language="C#" Value="public WebException ();" />
|
|
<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 initializes a new instance of the <see cref="T:System.Net.WebException" /> class. The <see cref="P:System.Exception.Message" /> property is initialized to a system-supplied message that describes the error. This message takes into account the current system culture. The <see cref="P:System.Exception.InnerException" /> and <see cref="P:System.Net.WebException.Response" /> properties are initialized to null. The <see cref="P:System.Net.WebException.Status" /> property is initialized to <see cref="F:System.Net.WebExceptionStatus.RequestCanceled" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Net.WebException" /> class.</para>
|
|
</summary>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string message)" />
|
|
<MemberSignature Language="C#" Value="public WebException (string message);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string message) 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="message" Type="System.String" />
|
|
</Parameters>
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The <see cref="T:System.Net.WebException" /> instance is initialized with the <see cref="P:System.Exception.Message" /> property set to the value of <paramref name="message" />. If <paramref name="message" /> is null, the <see cref="P:System.Exception.Message" /> property is initialized to a system-supplied message. The <see cref="P:System.Exception.InnerException" /> and <see cref="P:System.Net.WebException.Response" /> properties are initialized to null. The <see cref="P:System.Net.WebException.Status" /> property is initialized to <see cref="F:System.Net.WebExceptionStatus.RequestCanceled" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Net.WebException" /> class with the specified error message.</para>
|
|
</summary>
|
|
<param name="message">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The text of the error message. </param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="C#" Value="protected WebException (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>
|
|
<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 implements the <see cref="T:System.Runtime.Serialization.ISerializable" /> interface for the <see cref="T:System.Net.WebException" /> class.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Net.WebException" /> class from the specified <see cref="T:System.Runtime.Serialization.SerializationInfo" /> and <see cref="T:System.Runtime.Serialization.StreamingContext" /> instances.</para>
|
|
</summary>
|
|
<param name="serializationInfo">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.Serialization.SerializationInfo" /> that contains the information required to serialize the new <see cref="T:System.Net.WebException" />. </param>
|
|
<param name="streamingContext">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.Serialization.StreamingContext" /> that contains the source of the serialized stream that is associated with the new <see cref="T:System.Net.WebException" />. </param>
|
|
</Docs>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string message, class System.Exception innerException)" />
|
|
<MemberSignature Language="C#" Value="public WebException (string message, Exception innerException);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string message, class System.Exception innerException) 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="message" Type="System.String" />
|
|
<Parameter Name="innerException" Type="System.Exception" />
|
|
</Parameters>
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The <see cref="T:System.Net.WebException" /> instance is initialized with the <see cref="P:System.Exception.Message" /> property set to the value of <paramref name="message" /> and the <see cref="P:System.Exception.InnerException" /> property set to the value of <paramref name="innerException" />. If <paramref name="message" /> is null, the <see cref="P:System.Exception.Message" /> property is initialized to a system-supplied message. The <see cref="P:System.Exception.InnerException" /> and <see cref="P:System.Net.WebException.Response" /> properties are initialized to null. The <see cref="P:System.Net.WebException.Status" /> property is initialized to <see cref="F:System.Net.WebExceptionStatus.RequestCanceled" />.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Net.WebException" /> class with the specified error message and nested exception.</para>
|
|
</summary>
|
|
<param name="message">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The text of the error message. </param>
|
|
<param name="innerException">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />A nested exception. </param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string message, valuetype System.Net.WebExceptionStatus status)" />
|
|
<MemberSignature Language="C#" Value="public WebException (string message, System.Net.WebExceptionStatus status);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string message, valuetype System.Net.WebExceptionStatus status) 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="message" Type="System.String" />
|
|
<Parameter Name="status" Type="System.Net.WebExceptionStatus" />
|
|
</Parameters>
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The <see cref="T:System.Net.WebException" /> instance is initialized with the <see cref="P:System.Exception.Message" /> property set to the value of <paramref name="message" /> and the <see cref="P:System.Net.WebException.Status" /> property set to the value of <paramref name="status" />. If <paramref name="message" /> is null, the <see cref="P:System.Exception.Message" /> property is initialized to a system-supplied message. The <see cref="P:System.Exception.InnerException" /> and <see cref="P:System.Net.WebException.Response" /> properties are initialized to null.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Net.WebException" /> class with the specified error message and status.</para>
|
|
</summary>
|
|
<param name="message">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The text of the error message. </param>
|
|
<param name="status">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Net.WebExceptionStatus" /> values. </param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName=".ctor">
|
|
<MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string message, class System.Exception innerException, valuetype System.Net.WebExceptionStatus status, class System.Net.WebResponse response)" />
|
|
<MemberSignature Language="C#" Value="public WebException (string message, Exception innerException, System.Net.WebExceptionStatus status, System.Net.WebResponse response);" />
|
|
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string message, class System.Exception innerException, valuetype System.Net.WebExceptionStatus status, class System.Net.WebResponse response) 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="message" Type="System.String" />
|
|
<Parameter Name="innerException" Type="System.Exception" />
|
|
<Parameter Name="status" Type="System.Net.WebExceptionStatus" />
|
|
<Parameter Name="response" Type="System.Net.WebResponse" />
|
|
</Parameters>
|
|
<Docs>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The <see cref="T:System.Net.WebException" /> instance is initialized with the <see cref="P:System.Exception.Message" /> property set to the value of <paramref name="message" />, the <see cref="P:System.Exception.InnerException" /> property set to the value of <paramref name="innerException" />, the <see cref="P:System.Net.WebException.Status" /> property set to the value of <paramref name="status" />, and the <see cref="P:System.Net.WebException.Response" /> property set to the value of <paramref name="response" />. If <paramref name="message" /> is null, the <see cref="P:System.Exception.Message" /> property is initialized to a system-supplied message.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Initializes a new instance of the <see cref="T:System.Net.WebException" /> class with the specified error message, nested exception, status, and response.</para>
|
|
</summary>
|
|
<param name="message">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />The text of the error message. </param>
|
|
<param name="innerException">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />A nested exception. </param>
|
|
<param name="status">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Net.WebExceptionStatus" /> values. </param>
|
|
<param name="response">
|
|
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.WebResponse" /> instance that contains the response from the remote host. </param>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</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>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.WebException" />.</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="Response">
|
|
<MemberSignature Language="ILASM" Value=".property class System.Net.WebResponse Response { public hidebysig specialname instance class System.Net.WebResponse get_Response() }" />
|
|
<MemberSignature Language="C#" Value="public System.Net.WebResponse Response { get; }" />
|
|
<MemberSignature Language="ILAsm" Value=".property instance class System.Net.WebResponse Response" />
|
|
<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.WebResponse</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<value>
|
|
<para> A <see cref="T:System.Net.WebResponse" /> instance containing the
|
|
error response if one is available; otherwise, <see langword="null" />
|
|
.</para>
|
|
</value>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Some Internet protocols, such as HTTP, return otherwise valid responses indicating that an error has occurred at the protocol level. When the response to an Internet request indicates an error, <see cref="M:System.Net.WebRequest.GetResponse" /> sets the <see cref="P:System.Net.WebException.Status" /> property to <see cref="F:System.Net.WebExceptionStatus.ProtocolError" /> and provides the <see cref="T:System.Net.WebResponse" /> that contains the error message in the <see cref="P:System.Net.WebException.Response" /> property of the <see cref="T:System.Net.WebException" /> that was thrown. The application can examine the <see cref="T:System.Net.WebResponse" /> to determine the actual error.</para>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the response that the remote host returned.</para>
|
|
</summary>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</Member>
|
|
<Member MemberName="Status">
|
|
<MemberSignature Language="ILASM" Value=".property valuetype System.Net.WebExceptionStatus Status { public hidebysig specialname instance valuetype System.Net.WebExceptionStatus get_Status() }" />
|
|
<MemberSignature Language="C#" Value="public System.Net.WebExceptionStatus Status { get; }" />
|
|
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Net.WebExceptionStatus Status" />
|
|
<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.WebExceptionStatus</ReturnType>
|
|
</ReturnValue>
|
|
<Parameters />
|
|
<Docs>
|
|
<value>
|
|
<para> A <see cref="T:System.Net.WebExceptionStatus" /> value that indicates the status of the
|
|
response.</para>
|
|
</value>
|
|
<remarks>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>The <see cref="P:System.Net.WebException.Status" /> property indicates the reason for the <see cref="T:System.Net.WebException" />.</para>
|
|
<para>The value of <see cref="P:System.Net.WebException.Status" /> is one of the <see cref="T:System.Net.WebExceptionStatus" /> values.</para>
|
|
<block subset="none" type="note">
|
|
<para>The <see cref="F:System.Net.WebExceptionStatus.ProxyNameResolutionFailure" /> error is not returned to win8_appname_long apps.</para>
|
|
</block>
|
|
</remarks>
|
|
<summary>
|
|
<attribution license="cc4" from="Microsoft" modified="false" />
|
|
<para>Gets the status of the response.</para>
|
|
</summary>
|
|
</Docs>
|
|
<Excluded>0</Excluded>
|
|
</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>Serializes this instance into the specified <see cref="T:System.Runtime.Serialization.SerializationInfo" /> object.</para>
|
|
</summary>
|
|
</Docs>
|
|
</Member>
|
|
</Members>
|
|
<TypeExcluded>0</TypeExcluded>
|
|
</Type> |