SoapHeaderException Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentacja protokołu SOAP błędu serwera.
public ref class SoapHeaderException : System::Web::Services::Protocols::SoapExceptionpublic class SoapHeaderException : System.Web.Services.Protocols.SoapException[System.Serializable]
public class SoapHeaderException : System.Web.Services.Protocols.SoapExceptiontype SoapHeaderException = class
inherit SoapException[<System.Serializable>]
type SoapHeaderException = class
inherit SoapExceptionPublic Class SoapHeaderException
Inherits SoapException- Dziedziczenie
- Atrybuty
Przykłady
W poniższym przykładzie klient usługi sieci Web XML wywołuje MyWebMethod metodę usługi sieci Web XML, przekazując nagłówek protokołu SOAP typu MyHeader z właściwością ustawioną MustUnderstand na true. Jeśli metoda usługi sieci Web XML nie ustawia DidUnderstand właściwości nagłówka MyHeader SOAP na true, SoapHeaderException zostanie zgłoszony.
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
Uwagi
Gdy klient usługi sieci Web XML dodaje nagłówek SOAP do wywołania metody usługi sieci Web XML z MustUnderstand właściwością ustawioną na true, metoda usługi sieci Web XML musi ustawić DidUnderstand właściwość na true; w przeciwnym razie SoapHeaderException jest zgłaszany.
Nie Detail można ustawić właściwości zgodnie ze specyfikacją protokołu SOAP dla elementu SoapHeaderException.
Uwaga
Aplikacje korzystające ze specyfikacji PROTOKOŁU SOAP 1.1 jako protokołu usługi mogą używać parametru SoapHeaderException w celu uzyskania dostępu do błędów protokołu SOAP. Jednak aplikacje korzystające ze specyfikacji protokołu SOAP 1.2 muszą używać parametru SoapException w celu uzyskania dostępu do błędów protokołu SOAP.
Konstruktory
Właściwości
| Actor |
Pobiera fragment kodu, który spowodował wyjątek. (Odziedziczone po SoapException) |
| Code |
Pobiera typ kodu błędu protokołu SOAP. (Odziedziczone po SoapException) |
| Data |
Pobiera kolekcję par klucz/wartość, które zapewniają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku. (Odziedziczone po Exception) |
| Detail |
Pobiera element XmlNode reprezentujący szczegóły informacji o błędach specyficznych dla aplikacji. (Odziedziczone po SoapException) |
| HelpLink |
Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem. (Odziedziczone po Exception) |
| HResult |
Pobiera lub ustawia HRESULT, zakodowaną wartość liczbową przypisaną do określonego wyjątku. (Odziedziczone po Exception) |
| InnerException |
Exception Pobiera wystąpienie, które spowodowało bieżący wyjątek. (Odziedziczone po Exception) |
| Lang |
Pobiera język ludzki skojarzony z wyjątkiem. (Odziedziczone po SoapException) |
| Message |
Pobiera komunikat opisujący bieżący wyjątek. (Odziedziczone po Exception) |
| Node |
Pobiera identyfikator URI reprezentujący fragment kodu, który spowodował wyjątek. (Odziedziczone po SoapException) |
| Role |
Pobiera identyfikator URI reprezentujący funkcję usługi sieci Web XML w przetwarzaniu komunikatu SOAP. (Odziedziczone po SoapException) |
| Source |
Pobiera lub ustawia nazwę aplikacji lub obiektu, który powoduje błąd. (Odziedziczone po Exception) |
| StackTrace |
Pobiera reprezentację ciągu natychmiastowych ramek w stosie wywołań. (Odziedziczone po Exception) |
| SubCode |
Pobiera opcjonalne informacje o błędzie zawarte w |
| TargetSite |
Pobiera metodę, która zgłasza bieżący wyjątek. (Odziedziczone po Exception) |
Metody
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| GetBaseException() |
Po przesłonięciu w klasie pochodnej funkcja zwraca Exception główną przyczynę co najmniej jednego kolejnego wyjątku. (Odziedziczone po Exception) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Ustawia element SerializationInfo z informacjami o wyjątku. (Odziedziczone po SoapException) |
| GetType() |
Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia. (Odziedziczone po Exception) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| ToString() |
Tworzy i zwraca reprezentację ciągu bieżącego wyjątku. (Odziedziczone po Exception) |
Zdarzenia
| SerializeObjectState |
Nieaktualne.
Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku zawierającego serializowane dane o wyjątku. (Odziedziczone po Exception) |