Partilhar via


SoapHeaderException Classe

Definição

A representação de SOAP de um erro de servidor.

public ref class SoapHeaderException : System::Web::Services::Protocols::SoapException
public class SoapHeaderException : System.Web.Services.Protocols.SoapException
[System.Serializable]
public class SoapHeaderException : System.Web.Services.Protocols.SoapException
type SoapHeaderException = class
    inherit SoapException
[<System.Serializable>]
type SoapHeaderException = class
    inherit SoapException
Public Class SoapHeaderException
Inherits SoapException
Herança
Atributos

Exemplos

No exemplo a seguir, um cliente de serviço Web XML chama o MyWebMethod método de serviço Web XML, passando um cabeçalho SOAP do tipo MyHeader com a MustUnderstand propriedade definida como true. Se o método de serviço Web XML não definir a DidUnderstand propriedade do MyHeader cabeçalho SOAP como true, um SoapHeaderException será lançado.

int main()
{
   MyWebService^ ws = gcnew MyWebService;
   try
   {
      MyHeader^ customHeader = gcnew MyHeader;
      customHeader->MyValue = "Header Value for MyValue";
      customHeader->MustUnderstand = true;
      ws->myHeader = customHeader;
      int results = ws->MyWebMethod( 3, 5 );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e );
   }

}
using System;

public class Sample {

    public static void Main() {
        MyWebService ws = new MyWebService();

        try {
            MyHeader customHeader = new MyHeader();
            customHeader.MyValue = "Header Value for MyValue";
            customHeader.MustUnderstand = true;
            ws.myHeader = customHeader;

        int results = ws.MyWebMethod(3,5);
        }
        catch (Exception e) {
            Console.WriteLine ("Exception: {0}", e.ToString());
        }
    }
}
Public Class Sample
    
    Public Shared Sub Main()
        Dim ws As New MyWebService()

        Try
            Dim customHeader As New MyHeader1()

            customHeader.MyValue = "Header Value for MyValue"
            customHeader.MustUnderstand = True

            ws.myHeader = customHeader

        Dim results As Integer

            results = ws.MyWebMethod(3,5)
        Catch e As Exception
            Console.WriteLine("Exception: {0}", e.ToString())
        End Try
    End Sub
End Class

Comentários

Quando um cliente de serviço Web XML adiciona um cabeçalho SOAP a uma chamada de método de serviço Web XML com a MustUnderstand propriedade definida como true, o método de serviço Web XML deve definir a DidUnderstand propriedade como true; caso contrário, um SoapHeaderException é gerado.

A Detail propriedade não pode ser definida de acordo com a especificação SOAP de um SoapHeaderException.

Observação

Aplicativos que usam a especificação SOAP 1.1 como o protocolo de serviço podem usar para SoapHeaderException acessar falhas SOAP. No entanto, os aplicativos que usam a especificação SOAP 1.2 devem usar para SoapException acessar falhas SOAP.

Construtores

SoapHeaderException()

Inicializa uma nova instância da classe SoapHeaderException.

SoapHeaderException(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe SoapHeaderException com parâmetros para controle da serialização.

SoapHeaderException(String, XmlQualifiedName)

Inicializa uma nova instância da classe SoapHeaderException.

SoapHeaderException(String, XmlQualifiedName, Exception)

Inicializa uma nova instância da classe SoapHeaderException.

SoapHeaderException(String, XmlQualifiedName, String)

Inicializa uma nova instância da classe SoapHeaderException.

SoapHeaderException(String, XmlQualifiedName, String, Exception)

Inicializa uma nova instância da classe SoapHeaderException.

SoapHeaderException(String, XmlQualifiedName, String, String, SoapFaultSubCode, Exception)

Inicializa uma nova instância da classe SoapHeaderException com os dados associados.

SoapHeaderException(String, XmlQualifiedName, String, String, String, SoapFaultSubCode, Exception)

Inicializa uma nova instância da classe SoapHeaderException com os dados associados.

Propriedades

Actor

Obtém o trecho de código que causou a exceção.

(Herdado de SoapException)
Code

Obtém o tipo de código de falha de SOAP.

(Herdado de SoapException)
Data

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

(Herdado de Exception)
Detail

Obtém um XmlNode que representa os detalhes de informações de erro específicas do aplicativo.

(Herdado de SoapException)
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 que é atribuído a uma exceção específica.

(Herdado de Exception)
InnerException

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

(Herdado de Exception)
Lang

Obtém a linguagem humana associada à exceção.

(Herdado de SoapException)
Message

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

(Herdado de Exception)
Node

Obtém um URI que representa o trecho de código que causou a exceção.

(Herdado de SoapException)
Role

Obtém um URI que representa a função do serviço Web XML no processamento da mensagem SOAP.

(Herdado de SoapException)
Source

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

(Herdado de Exception)
StackTrace

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

(Herdado de Exception)
SubCode

Obtém as informações de erro opcionais contidas no elemento XML subcode de uma falha SOAP.

(Herdado de SoapException)
TargetSite

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

(Herdado de Exception)

Métodos

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 que é a 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)

Define o SerializationInfo com informações sobre a exceção.

(Herdado de SoapException)
GetType()

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

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

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

(Herdado de Exception)

Eventos

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)

Aplica-se a

Confira também