SoapHeaderException Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representación SOAP de un error 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- Herencia
- Atributos
Ejemplos
En el ejemplo siguiente, un cliente de servicio web XML llama al MyWebMethod método de servicio web XML, pasando un encabezado SOAP de tipo MyHeader con la MustUnderstand propiedad establecida trueen . Si el método de servicio web XML no establece la DidUnderstand propiedad del MyHeader encabezado trueSOAP en , se produce una SoapHeaderException excepción .
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
Comentarios
Cuando un cliente de servicio web XML agrega un encabezado SOAP a una llamada de método de servicio web XML con la MustUnderstand propiedad establecida trueen , el método de servicio web XML debe establecer la DidUnderstand propiedad trueen ; de lo contrario, se produce una SoapHeaderException excepción .
La Detail propiedad no se puede establecer según la especificación SOAP de .SoapHeaderException
Nota
Las aplicaciones que usan la especificación SOAP 1.1 como protocolo de servicio pueden usar para SoapHeaderException acceder a errores de SOAP. Sin embargo, las aplicaciones que usan la especificación SOAP 1.2 deben usar para SoapException acceder a errores de SOAP.
Constructores
Propiedades
| Actor |
Obtiene el fragmento de código que provocó la excepción. (Heredado de SoapException) |
| Code |
Obtiene el tipo de código de error de SOAP. (Heredado de SoapException) |
| Data |
Obtiene una colección de pares clave/valor que proporciona información definida por el usuario adicional sobre la excepción. (Heredado de Exception) |
| Detail |
Obtiene un objeto XmlNode que representa la información detallada sobre el error, específica de la aplicación. (Heredado de SoapException) |
| HelpLink |
Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción. (Heredado de Exception) |
| HResult |
Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica. (Heredado de Exception) |
| InnerException |
Obtiene la instancia Exception que produjo la excepción actual. (Heredado de Exception) |
| Lang |
Obtiene el idioma asociado a la excepción. (Heredado de SoapException) |
| Message |
Obtiene un mensaje que describe la excepción actual. (Heredado de Exception) |
| Node |
Identificador URI que representa el fragmento de código que provocó la excepción. (Heredado de SoapException) |
| Role |
Obtiene un identificador URI que representa la función del servicio Web XML para procesar el mensaje SOAP. (Heredado de SoapException) |
| Source |
Devuelve o establece el nombre de la aplicación o del objeto que generó el error. (Heredado de Exception) |
| StackTrace |
Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas. (Heredado de Exception) |
| SubCode |
Obtiene la información de error opcional incluida en el elemento XML |
| TargetSite |
Obtiene el método que produjo la excepción actual. (Heredado de Exception) |
Métodos
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetBaseException() |
Cuando se invalida en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores. (Heredado de Exception) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Establece el objeto SerializationInfo con información sobre la excepción. (Heredado de SoapException) |
| GetType() |
Obtiene el tipo de tiempo de ejecución de la instancia actual. (Heredado de Exception) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| ToString() |
Crea y devuelve una representación de cadena de la excepción actual. (Heredado de Exception) |
Eventos
| SerializeObjectState |
Obsoleto.
Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción. (Heredado de Exception) |