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

Name Beschreibung
SoapHeaderException()

Initialisiert eine neue Instanz der SoapHeaderException-Klasse.

SoapHeaderException(SerializationInfo, StreamingContext)

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

SoapHeaderException(String, XmlQualifiedName, Exception)

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 zugehörigen Daten.

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

Initialisiert eine neue Instanz der SoapHeaderException Klasse mit den zugehörigen Daten.

SoapHeaderException(String, XmlQualifiedName, String)

Initialisiert eine neue Instanz der SoapHeaderException-Klasse.

SoapHeaderException(String, XmlQualifiedName)

Initialisiert eine neue Instanz der SoapHeaderException-Klasse.

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

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

Gilt für:

Weitere Informationen