WebException 类

定义

通过可插接协议访问网络期间出错时引发的异常。The exception that is thrown when an error occurs while accessing the network through a pluggable protocol.

public ref class WebException : InvalidOperationException
[System.Serializable]
public class WebException : InvalidOperationException
type WebException = class
    inherit InvalidOperationException
    interface ISerializable
Public Class WebException
Inherits InvalidOperationException
继承
属性
实现

注解

类由从WebRequestWebResponse实现可插入协议以便访问 Internet 的类引发。 WebExceptionThe WebException class is thrown by classes descended from WebRequest and WebResponse that implement pluggable protocols for accessing the Internet.

WebExceptionWebRequest类的子代引发时, Response属性提供对应用程序的 Internet 响应。When WebException is thrown by a descendant of the WebRequest class, the Response property provides the Internet response to the application.

相关提示Associated Tips

检查异常的 Response 属性以确定请求失败的原因。Check the Response property of the exception to determine why the request failed.
如果 WebException 异常是由 WebRequest 类的派生类引发的,则 Response 属性向应用程序提供 Internet 响应。When a WebException exception is thrown by a descendent of the WebRequest class, the Response property provides the Internet response to the application.

检查异常的 Status 属性以确定请求失败的原因。Check the Status property of the exception to determine why the request failed.
异常的 Status 属性提供错误的状态信息。The Status property of the exception provides status information for the error. 有关详细信息,请参阅 WebExceptionStatusFor more information, see WebExceptionStatus.

如果单步执行 XML Web Services 时超时,请将 XML Web Services 调用的超时值设置为无限。If you are timing out when stepping into an XML Web Service, set the timeout value for the XML Web Service call to infinite.
有关详细信息,请参阅 Error: Timeout While Debugging Web ServicesFor more information, see Error: Timeout While Debugging Web Services.

构造函数

WebException()

初始化 WebException 类的新实例。Initializes a new instance of the WebException class.

WebException(SerializationInfo, StreamingContext)

根据指定的 SerializationInfoStreamingContext 实例初始化 WebException 类的新实例。Initializes a new instance of the WebException class from the specified SerializationInfo and StreamingContext instances.

WebException(String)

使用指定的错误消息初始化 WebException 类的新实例。Initializes a new instance of the WebException class with the specified error message.

WebException(String, Exception)

用指定的错误信息和嵌套异常初始化 WebException 类的新实例。Initializes a new instance of the WebException class with the specified error message and nested exception.

WebException(String, Exception, WebExceptionStatus, WebResponse)

用指定的错误信息、嵌套异常、状态和响应初始化 WebException 类的新实例。Initializes a new instance of the WebException class with the specified error message, nested exception, status, and response.

WebException(String, WebExceptionStatus)

用指定的错误信息和状态初始化 WebException 类的新实例。Initializes a new instance of the WebException class with the specified error message and status.

属性

Data

获取提供有关异常的其他用户定义信息的键/值对集合。Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(继承自 Exception)
HelpLink

获取或设置指向与此异常关联的帮助文件链接。Gets or sets a link to the help file associated with this exception.

(继承自 Exception)
HResult

获取或设置 HRESULT(一个分配给特定异常的编码数字值)。Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(继承自 Exception)
InnerException

获取导致当前异常的 Exception 实例。Gets the Exception instance that caused the current exception.

(继承自 Exception)
Message

获取描述当前异常的消息。Gets a message that describes the current exception.

(继承自 Exception)
Response

获取远程主机返回的响应。Gets the response that the remote host returned.

Source

获取或设置导致错误的应用程序或对象的名称。Gets or sets the name of the application or the object that causes the error.

(继承自 Exception)
StackTrace

获取调用堆栈上的即时框架字符串表示形式。Gets a string representation of the immediate frames on the call stack.

(继承自 Exception)
Status

获取响应的状态。Gets the status of the response.

TargetSite

获取引发当前异常的方法。Gets the method that throws the current exception.

(继承自 Exception)

方法

Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)
GetBaseException()

当在派生类中重写时,返回 Exception,它是一个或多个并发的异常的根源。When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(继承自 Exception)
GetHashCode()

用作默认哈希函数。Serves as the default hash function.

(继承自 Object)
GetObjectData(SerializationInfo, StreamingContext)

用序列化 SerializationInfo 所需的数据填充 WebException 实例。Populates a SerializationInfo instance with the data needed to serialize the WebException.

GetType()

获取当前实例的运行时类型。Gets the runtime type of the current instance.

(继承自 Exception)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
ToString()

创建并返回当前异常的字符串表示形式。Creates and returns a string representation of the current exception.

(继承自 Exception)

事件

SerializeObjectState

当异常被序列化用来创建包含有关该异常的徐列出数据的异常状态对象时会出现该问题。Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(继承自 Exception)

显式界面实现

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

将此实例序列化到指定的 SerializationInfo 对象中。Serializes this instance into the specified SerializationInfo object.

适用于

另请参阅