WebException Classe

Definição

Namespace:
System.Net
Assemblies:
System.dll, System.Net.Requests.dll
Assemblies:
netstandard.dll, System.Net.Requests.dll
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origem:
WebException.cs
Origem:
WebException.cs
Origem:
WebException.cs
Origem:
WebException.cs
Origem:
WebException.cs

A exceção gerada quando ocorre um erro ao acessar a rede por meio de um protocolo pluggável.

public ref class WebException : InvalidOperationException
public class WebException : InvalidOperationException
[System.Serializable]
public class WebException : InvalidOperationException
type WebException = class
    inherit InvalidOperationException
type WebException = class
    inherit InvalidOperationException
    interface ISerializable
[<System.Serializable>]
type WebException = class
    inherit InvalidOperationException
    interface ISerializable
Public Class WebException
Inherits InvalidOperationException
Herança
Object
Exception
InvalidOperationException
WebException
Herança
Object
Exception
SystemException
InvalidOperationException
WebException
Atributos
SerializableAttribute
Implementações
ISerializable

Comentários

A WebException classe é gerada por classes decrescentes WebRequest e WebResponse que implementam protocolos pluggáveis para acessar a Internet.

Quando WebException é gerada por um descendente da WebRequest classe, a Response propriedade fornece a resposta da Internet ao aplicativo.

Dicas associadas

Verifique a propriedade Response da exceção para determinar por que a solicitação falhou. Quando uma WebException exceção é gerada por um descendente da WebRequest classe, a Response propriedade fornece a resposta da Internet ao aplicativo.

Verifique a propriedade Status da exceção para determinar por que a solicitação falhou. A Status propriedade da exceção fornece informações de status para o erro. Para obter mais informações, consulte WebExceptionStatus.

Se você estiver atingindo o tempo limite ao entrar em um Serviço Web XML, defina o valor de tempo limite da chamada do Serviço Web XML como infinito.

Construtores

Nome Description
WebException()

Inicializa uma nova instância da classe WebException.
WebException(SerializationInfo, StreamingContext)
Obsoleto.

Inicializa uma nova instância da classe das WebException instâncias e SerializationInfo especificadasStreamingContext.
WebException(String, Exception, WebExceptionStatus, WebResponse)

Inicializa uma nova instância da WebException classe com a mensagem de erro especificada, exceção aninhada, status e resposta.
WebException(String, Exception)

Inicializa uma nova instância da WebException classe com a mensagem de erro especificada e a exceção aninhada.
WebException(String, WebExceptionStatus)

Inicializa uma nova instância da WebException classe com a mensagem de erro e o status especificados.
WebException(String)

Inicializa uma nova instância da WebException classe com a mensagem de erro especificada.

Propriedades

Nome Description
Data

Obtém uma coleção de pares chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção.

(Herdado de Exception)
HelpLink

Obtém ou define um link para o arquivo de ajuda associado a essa exceção.

(Herdado de Exception)
HResult

Obtém ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica.

(Herdado de Exception)
InnerException

Obtém a Exception instância que causou a exceção atual.

(Herdado de Exception)
Message

Obtém uma mensagem que descreve a exceção atual.

(Herdado de Exception)
Response

Obtém a resposta retornada pelo host remoto.
Source

Obtém ou define o nome do aplicativo ou do objeto que causa o erro.

(Herdado de Exception)
StackTrace

Obtém uma representação de cadeia de caracteres dos quadros imediatos na pilha de chamadas.

(Herdado de Exception)
Status

Obtém o status da resposta.
TargetSite

Obtém o método que gera a exceção atual.

(Herdado de Exception)

Métodos

Nome Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetBaseException()

Quando substituído em uma classe derivada, retorna a Exception causa raiz de uma ou mais exceções subsequentes.

(Herdado de Exception)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)
Obsoleto.

Popula uma SerializationInfo instância com os dados necessários para serializar o WebException.
GetObjectData(SerializationInfo, StreamingContext)
Obsoleto.

Quando substituído em uma classe derivada, define o SerializationInfo com informações sobre a exceção.

(Herdado de Exception)
GetType()

Obtém o tipo de runtime da instância atual.

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ToString()

Cria e retorna uma representação de cadeia de caracteres da exceção atual.

(Herdado de Exception)

Eventos

Nome Description
SerializeObjectState
Obsoleto.

Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção.

(Herdado de Exception)

Implantações explícitas de interface

Nome Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Serializa essa instância no objeto especificado SerializationInfo .

Aplica-se a

Confira também