WebException Classe

Definição

Espaço de Nomes:
System.Net
Assemblagens:
System.dll, System.Net.Requests.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

A exceção que é lançada quando ocorre um erro ao aceder à rede através de um protocolo pluggable.

public ref class WebException : InvalidOperationException
public class WebException : InvalidOperationException
[System.Serializable]
public class WebException : InvalidOperationException
type WebException = class
    inherit InvalidOperationException
[<System.Serializable>]
type WebException = class
    inherit InvalidOperationException
    interface ISerializable
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

Observações

A WebException classe é lançada por classes descendentes de WebRequest e WebResponse que implementam protocolos pluggáveis para aceder à Internet.

Quando WebException é lançada por um descendente da WebRequest classe, a Response propriedade fornece a resposta da Internet à aplicação.

Dicas Associadas

Verifique a propriedade Resposta da exceção para determinar porque é que o pedido falhou. Quando uma WebException exceção é lançada por um descendente da WebRequest classe, a Response propriedade fornece a resposta da Internet à aplicação.

Verifique a propriedade Estado da exceção para determinar porque é que o pedido falhou. A Status propriedade da exceção fornece informação de estado para o erro. Para obter mais informações, veja WebExceptionStatus.

Se estiveres a fazer um timeout ao entrar num Serviço Web XML, define o valor de tempo limite para a chamada do Serviço Web XML para infinito. Para mais informações, veja Erro: Tempo de Expiração Durante a Depuração de Serviços Web.

Construtores

Name Description
WebException()

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

Inicializa uma nova instância da WebException classe a partir das instâncias e StreamingContext especificadasSerializationInfo.
WebException(String, Exception, WebExceptionStatus, WebResponse)

Inicializa uma nova instância da WebException classe com a mensagem de erro especificada, exceção aninhada, estado 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 estado especificados.
WebException(String)

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

Propriedades

Name Description
Data

Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção.

(Herdado de Exception)
HelpLink

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

(Herdado de Exception)
HResult

Recebe 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

Recebe uma mensagem que descreve a exceção atual.

(Herdado de Exception)
Response

Recebe a resposta que o anfitrião remoto devolveu.
Source

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

(Herdado de Exception)
StackTrace

Obtém uma representação string dos frames imediatos na stack de chamadas.

(Herdado de Exception)
Status

Percebe o estado da resposta.
TargetSite

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

(Herdado de Exception)

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetBaseException()

Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes.

(Herdado de Exception)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)

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

Quando sobreposto numa classe derivada, define a SerializationInfo informação com sobre a exceção.

(Herdado de Exception)
GetType()

Obtém o tipo de execução da instância atual.

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Cria e devolve uma representação string da exceção atual.

(Herdado de Exception)

evento

Name Description
SerializeObjectState

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)

Implementações de Interface Explícita

Name Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Serializa esta instância no objeto especificado SerializationInfo .

Aplica-se a

Ver também