SoapHeaderException Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Die SOAP-Darstellung eines Serverfehlers.
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- Vererbung
- Attribute
Beispiele
Im folgenden Beispiel ruft ein XML-Webdienstclient die MyWebMethod XML-Webdienstmethode auf, indem er einen SOAP-Header vom Typ MyHeader mit dem MustUnderstand Eigenschaftssatz angibt true. Wenn die XML-Webdienstmethode die DidUnderstand Eigenschaft des MyHeader SOAP-Headers truenicht auf legt, wird eine SoapHeaderException ausgelöst.
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
Hinweise
Wenn ein XML-Webdienstclient einen SOAP-Header zu einem XML-Webdienstmethodenaufruf mit dem MustUnderstand Eigenschaftssatz truehinzufügt, muss die XML-Webdienstmethode die DidUnderstand Eigenschaft trueauf ; andernfalls wird eine SoapHeaderException ausgelöst.
Die Detail Eigenschaft kann nicht gemäß der SOAP-Spezifikation für eine SoapHeaderExceptionfestgelegt werden.
Hinweis
Anwendungen, die die SOAP 1.1-Spezifikation verwenden, da das Dienstprotokoll den SoapHeaderException Zugriff auf SOAP-Fehler verwenden kann. Anwendungen, die die SOAP 1.2-Spezifikation verwenden, müssen jedoch den SoapException Zugriff auf SOAP-Fehler verwenden.
Konstruktoren
Eigenschaften
| Actor |
Ruft den Codeabschnitt ab, der die Ausnahme verursacht hat. (Geerbt von SoapException) |
| Code |
Ruft den Typ des SOAP-Fehlercodes ab. (Geerbt von SoapException) |
| Data |
Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception) |
| Detail |
Ruft einen XmlNode ab, der die Einzelheiten von anwendungsspezifischen Fehlerinformationen darstellt. (Geerbt von SoapException) |
| HelpLink |
Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest. (Geerbt von Exception) |
| HResult |
Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist. (Geerbt von Exception) |
| InnerException |
Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception) |
| Lang |
Ruft die der Ausnahme zugeordnete menschliche Sprache ab. (Geerbt von SoapException) |
| Message |
Ruft eine Meldung ab, mit der die aktuelle Ausnahme beschrieben wird. (Geerbt von Exception) |
| Node |
Ruft einen URI ab, der den für die Ausnahme verantwortlichen Codeabschnitt angibt. (Geerbt von SoapException) |
| Role |
Ruft einen URI ab, der die Funktion des XML-Webdiensts bei der Verarbeitung der SOAP-Nachricht darstellt. (Geerbt von SoapException) |
| Source |
Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest. (Geerbt von Exception) |
| StackTrace |
Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab. (Geerbt von Exception) |
| SubCode |
Ruft die optionalen Fehlerinformationen ab, die im XML-Element vom Typ |
| TargetSite |
Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception) |
Methoden
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetBaseException() |
Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die Grundursache für eine oder mehrere nachfolgende Ausnahmen ist. (Geerbt von Exception) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Legt SerializationInfo mit Informationen zur Ausnahme fest. (Geerbt von SoapException) |
| GetType() |
Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| ToString() |
Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück. (Geerbt von Exception) |
Ereignisse
| SerializeObjectState |
Veraltet.
Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen. (Geerbt von Exception) |