SoapHeaderException Třída

Reference

Definice

Obor názvů:: System.Web.Services.Protocols

Sestavení:: System.Web.Services.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Reprezentace protokolu SOAP chyby serveru.

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

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 MyHeader hlavičky SOAP na true, 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 PROTOKOLU SOAP pro SoapHeaderException.

Poznámka

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

Konstruktory

SoapHeaderException()	Inicializuje novou instanci SoapHeaderException třídy.
SoapHeaderException(SerializationInfo, StreamingContext)	Inicializuje novou instanci SoapHeaderException třídy s parametry pro řízení serializace.
SoapHeaderException(String, XmlQualifiedName)	Inicializuje novou instanci SoapHeaderException třídy.
SoapHeaderException(String, XmlQualifiedName, Exception)	Inicializuje novou instanci SoapHeaderException třídy.
SoapHeaderException(String, XmlQualifiedName, String)	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.

Vlastnosti

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 přiřazenou 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 xml elementu `subcode` chyby SOAP. (Zděděno od SoapException)
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí Exception hodnotu, která je hlavní 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ří použádnou kopii aktuálního souboru 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

SerializeObjectState

Zastaralé.

Nastane, když je výjimka serializována k vytvoření objektu stavu výjimky, který obsahuje serializovaná data o výjimce.

(Zděděno od Exception)

Platí pro