SoapHeaderException Třída
Definice
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
- Atributy
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
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 |
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) |