SoapHeaderException Třída

Definice

Obor názvů:

System.Web.Services.Protocols

Sestavení:

System.Web.Services.dll

Reprezentace protokolu SOAP chyby serveru.

public ref class SoapHeaderException : System::Web::Services::Protocols::SoapException

[System.Serializable]
public class SoapHeaderException : System.Web.Services.Protocols.SoapException

[<System.Serializable>]
type SoapHeaderException = class
    inherit SoapException

Public Class SoapHeaderException
Inherits SoapException

Dědičnost

Object

Exception

SystemException

SoapException

SoapHeaderException

Atributy

SerializableAttribute

Příklady

V následujícím příkladu klient webové služby XML volá metodu MyWebMethod webové služby XML a předává hlavičku SOAP typu MyHeader s vlastností nastavenou MustUnderstand na true. Pokud metoda webové služby XML nenastaví DidUnderstand vlastnost hlavičky MyHeadertrueSOAP , SoapHeaderException je vyvolán.

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

Poznámky

Když klient webové služby XML přidá hlavičku SOAP do volání metody webové služby XML s vlastností nastavenou MustUnderstand na true, musí metoda webové služby XML nastavit DidUnderstand vlastnost na true; jinak SoapHeaderException je vyvolán.

Vlastnost Detail nelze nastavit podle specifikace SOAP pro .SoapHeaderException

Poznámka:

Aplikace, které jako protokol služby používají specifikaci SOAP 1.1, můžou používat SoapHeaderException přístup k chybám SOAP. Aplikace, které používají specifikaci SOAP 1.2, však musí používat SoapException přístup k chybám PROTOKOLU SOAP.

Konstruktory

Name	Description
SoapHeaderException()	Inicializuje novou instanci SoapHeaderException třídy.
SoapHeaderException(SerializationInfo, StreamingContext)	Inicializuje novou instanci SoapHeaderException třídy s parametry pro řízení serializace.
SoapHeaderException(String, XmlQualifiedName, Exception)	Inicializuje novou instanci SoapHeaderException třídy.
SoapHeaderException(String, XmlQualifiedName, String, Exception)	Inicializuje novou instanci SoapHeaderException třídy.
SoapHeaderException(String, XmlQualifiedName, String, String, SoapFaultSubCode, Exception)	Inicializuje novou instanci SoapHeaderException třídy s přidruženými daty.
SoapHeaderException(String, XmlQualifiedName, String, String, String, SoapFaultSubCode, Exception)	Inicializuje novou instanci SoapHeaderException třídy s přidruženými daty.
SoapHeaderException(String, XmlQualifiedName, String)	Inicializuje novou instanci SoapHeaderException třídy.
SoapHeaderException(String, XmlQualifiedName)	Inicializuje novou instanci SoapHeaderException třídy.

Vlastnosti

Name	Description
Actor	Získá část kódu, která způsobila výjimku. (Zděděno od SoapException)
Code	Získá typ kódu chyby SOAP. (Zděděno od SoapException)
Data	Získá kolekci párů klíč/hodnota, které poskytují další uživatelem definované informace o výjimce. (Zděděno od Exception)
Detail	XmlNode Získá, který představuje podrobnosti o chybě specifické pro aplikaci. (Zděděno od SoapException)
HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružený k této výjimce. (Zděděno od Exception)
HResult	Získá nebo nastaví HRESULT, kódovanou číselnou hodnotu, která je přiřazena ke konkrétní výjimce. (Zděděno od Exception)
InnerException	Exception Získá instanci, která způsobila aktuální výjimku. (Zděděno od Exception)
Lang	Získá lidský jazyk přidružený k výjimce. (Zděděno od SoapException)
Message	Získá zprávu, která popisuje aktuální výjimku. (Zděděno od Exception)
Node	Získá identifikátor URI, který představuje část kódu, která způsobila výjimku. (Zděděno od SoapException)
Role	Získá identifikátor URI, který představuje funkci webové služby XML při zpracování zprávy SOAP. (Zděděno od SoapException)
Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno od Exception)
StackTrace	Získá řetězcové znázornění okamžitých rámců v zásobníku volání. (Zděděno od Exception)
SubCode	Získá volitelné informace o chybě obsažené v subcode XML elementu SOAP chyba. (Zděděno od SoapException)
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí Exception to, že je původní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	SerializationInfo Nastaví informace o výjimce. (Zděděno od SoapException)
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky. (Zděděno od Exception)

Událost

Name	Description
SerializeObjectState	Nastane, když je výjimka serializována vytvořit objekt stavu výjimky, který obsahuje serializovaná data o výjimce. (Zděděno od Exception)

Viz také

• MustUnderstand
• DidUnderstand
• SoapHeader
• SoapException