Freigeben über


SoapHeaderException Klasse

Definition

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, 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

SoapHeaderException()

Initialisiert eine neue Instanz der SoapHeaderException-Klasse.

SoapHeaderException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der SoapHeaderException-Klasse mit Parametern zum Steuern der Serialisierung.

SoapHeaderException(String, XmlQualifiedName)

Initialisiert eine neue Instanz der SoapHeaderException-Klasse.

SoapHeaderException(String, XmlQualifiedName, Exception)

Initialisiert eine neue Instanz der SoapHeaderException-Klasse.

SoapHeaderException(String, XmlQualifiedName, String)

Initialisiert eine neue Instanz der SoapHeaderException-Klasse.

SoapHeaderException(String, XmlQualifiedName, String, Exception)

Initialisiert eine neue Instanz der SoapHeaderException-Klasse.

SoapHeaderException(String, XmlQualifiedName, String, String, SoapFaultSubCode, Exception)

Initialisiert eine neue Instanz der SoapHeaderException-Klasse mit den zugeordneten Daten.

SoapHeaderException(String, XmlQualifiedName, String, String, String, SoapFaultSubCode, Exception)

Initialisiert eine neue Instanz der SoapHeaderException-Klasse mit den zugeordneten Daten.

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 subcode eines SOAP-Fehlers enthalten sind.

(Geerbt von SoapException)
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)

Gilt für

Siehe auch