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::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
- Vererbung
- Attribute
Beispiele
Im folgenden Beispiel ruft ein XML-Webdienstclient die MyWebMethod XML-Webdienstmethode auf und übergibt einen SOAP-Header vom Typ MyHeader mit dem MustUnderstand Eigenschaftensatz auf true. Wenn die XML-Webdienstmethode die DidUnderstand Eigenschaft des MyHeader SOAP-Headers nicht auf true"" festgelegt hat, wird ein SoapHeaderException Fehler 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 hinzufügt, auf den die MustUnderstand Eigenschaft festgelegt ist true, muss die XML-Webdienstmethode die DidUnderstand Eigenschaft truefestlegen; andernfalls wird ein SoapHeaderException Fehler ausgelöst.
Die Detail Eigenschaft kann nicht gemäß der SOAP-Spezifikation für ein SoapHeaderException.
Hinweis
Anwendungen, die die SOAP 1.1-Spezifikation als Dienstprotokoll verwenden, können für den SoapHeaderException Zugriff auf SOAP-Fehler verwendet werden. Anwendungen, die die SOAP 1.2-Spezifikation verwenden, müssen jedoch den SoapException Zugriff auf SOAP-Fehler verwenden.
Konstruktoren
Eigenschaften
| Name | Beschreibung |
|---|---|
| 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 ein XmlNode , das die anwendungsspezifischen Fehlerinformationen details darstellt. (Geerbt von SoapException) |
| HelpLink |
Dient zum Abrufen oder Festlegen eines Links zur Hilfedatei, die dieser Ausnahme zugeordnet ist. (Geerbt von Exception) |
| HResult |
Dient zum Abrufen oder Festlegen von HRESULT, einem codierten numerischen Wert, der einer bestimmten Ausnahme zugewiesen ist. (Geerbt von Exception) |
| InnerException |
Ruft die Exception Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception) |
| Lang |
Ruft die menschliche Sprache ab, die der Ausnahme zugeordnet ist. (Geerbt von SoapException) |
| Message |
Ruft eine Nachricht ab, die die aktuelle Ausnahme beschreibt. (Geerbt von Exception) |
| Node |
Ruft einen URI, der den Codeabschnitt darstellt, der die Ausnahme verursacht hat. (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 |
Dient zum Abrufen oder Festlegen des Namens der Anwendung oder des Objekts, das den Fehler verursacht. (Geerbt von Exception) |
| StackTrace |
Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames im Aufrufstapel ab. (Geerbt von Exception) |
| SubCode |
Ruft die optionalen Fehlerinformationen ab, die |
| TargetSite |
Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception) |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetBaseException() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Exception Ursache einer oder mehrerer nachfolgenden Ausnahmen zurückgegeben. (Geerbt von Exception) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Legt die 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 der aktuellen Object. (Geerbt von Object) |
| ToString() |
Erstellt und gibt eine Zeichenfolgendarstellung der aktuellen Ausnahme zurück. (Geerbt von Exception) |
Ereignisse
| Name | Beschreibung |
|---|---|
| SerializeObjectState |
Veraltet.
Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmestatusobjekt zu erstellen, das serialisierte Daten zu der Ausnahme enthält. (Geerbt von Exception) |