SoapHeaderException Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
A representação de SOAP de um erro de servidor.
public ref class SoapHeaderException : System::Web::Services::Protocols::SoapExceptionpublic class SoapHeaderException : System.Web.Services.Protocols.SoapException[System.Serializable]
public class SoapHeaderException : System.Web.Services.Protocols.SoapExceptiontype SoapHeaderException = class
inherit SoapException[<System.Serializable>]
type SoapHeaderException = class
inherit SoapExceptionPublic 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
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 |
| 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) |