SoapHeaderException Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresentazione SOAP di un errore del server.
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- Ereditarietà
- Attributi
Esempio
Nell'esempio seguente un client del servizio Web XML chiama il MyWebMethod metodo del servizio Web XML, passando un'intestazione SOAP di tipo MyHeader con la MustUnderstand proprietà impostata su true. Se il metodo del servizio Web XML non imposta la DidUnderstand proprietà dell'intestazione MyHeader SOAP su true, viene generata un'eccezione SoapHeaderException .
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
Commenti
Quando un client del servizio Web XML aggiunge un'intestazione SOAP a una chiamata al metodo del servizio Web XML con la MustUnderstand proprietà impostata su true, il metodo del servizio Web XML deve impostare la DidUnderstand proprietà su true; in caso contrario, viene generata un'eccezione SoapHeaderException .
La Detail proprietà non può essere impostata in base alla specifica SOAP per un oggetto SoapHeaderException.
Nota
Le applicazioni che usano la specifica SOAP 1.1 come protocollo di servizio possono usare SoapHeaderException per accedere agli errori SOAP. Tuttavia, le applicazioni che usano la specifica SOAP 1.2 devono usare per SoapException accedere agli errori SOAP.
Costruttori
Proprietà
| Actor |
Recupera la porzione di codice che ha causato l'eccezione. (Ereditato da SoapException) |
| Code |
Recupera il tipo di codice SOAP con errori. (Ereditato da SoapException) |
| Data |
Ottiene una raccolta di coppie chiave/valore che forniscono informazioni definite dall'utente aggiuntive sull'eccezione. (Ereditato da Exception) |
| Detail |
Ottiene un oggetto XmlNode che rappresenta i dettagli sull'errore specifici dell'applicazione. (Ereditato da SoapException) |
| HelpLink |
Ottiene o imposta un collegamento al file della Guida associato all'eccezione. (Ereditato da Exception) |
| HResult |
Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica. (Ereditato da Exception) |
| InnerException |
Ottiene l'istanza di Exception che ha causato l'eccezione corrente. (Ereditato da Exception) |
| Lang |
Ottiene la lingua associata all'eccezione. (Ereditato da SoapException) |
| Message |
Ottiene un messaggio che descrive l'eccezione corrente. (Ereditato da Exception) |
| Node |
Ottiene un URI che rappresenta il codice che ha causato l'eccezione. (Ereditato da SoapException) |
| Role |
Ottiene un URI che rappresenta la funzione del servizio Web XML nell'elaborazione del messaggio SOAP. (Ereditato da SoapException) |
| Source |
Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore. (Ereditato da Exception) |
| StackTrace |
Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate. (Ereditato da Exception) |
| SubCode |
Ottiene le informazioni facoltative sull'errore contenute nell'elemento |
| TargetSite |
Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception) |
Metodi
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetBaseException() |
Quando ne viene eseguito l'override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive. (Ereditato da Exception) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Imposta l'oggetto SerializationInfo con le informazioni sull'eccezione. (Ereditato da SoapException) |
| GetType() |
Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| ToString() |
Crea e restituisce una rappresentazione di stringa dell'eccezione corrente. (Ereditato da Exception) |
Eventi
| SerializeObjectState |
Obsoleta.
Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione. (Ereditato da Exception) |