SoapHeaderException Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
SOAP-representationen av ett serverfel.
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
- Arv
- Attribut
Exempel
I följande exempel anropar MyWebMethod en XML-webbtjänstklient XML-webbtjänstmetoden och skickar in ett SOAP-huvud av typen MyHeader med MustUnderstand egenskapen inställd på true. Om XML-webbtjänstmetoden inte anger DidUnderstand egenskapen MyHeader för SOAP-huvudet till truegenereras en SoapHeaderException .
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
Kommentarer
När en XML-webbtjänstklient lägger till ett SOAP-huvud i ett XML-webbtjänstmetodanrop med MustUnderstand egenskapen inställd på truemåste XML-webbtjänstmetoden ange DidUnderstand egenskapen till true, annars genereras en SoapHeaderException .
Egenskapen Detail kan inte anges enligt SOAP-specifikationen för en SoapHeaderException.
Note
Program som använder SOAP 1.1-specifikationen som tjänstprotokoll kan använda SoapHeaderException för att komma åt SOAP-fel. Program som använder SOAP 1.2-specifikationen SoapException måste dock använda för att komma åt SOAP-fel.
Konstruktorer
Egenskaper
| Name | Description |
|---|---|
| Actor |
Hämtar den kod som orsakade undantaget. (Ärvd från SoapException) |
| Code |
Hämtar typen av SOAP-felkod. (Ärvd från SoapException) |
| Data |
Hämtar en samling nyckel/värde-par som ger ytterligare användardefinierad information om undantaget. (Ärvd från Exception) |
| Detail |
Hämtar en XmlNode som representerar information om programspecifik felinformation. (Ärvd från SoapException) |
| HelpLink |
Hämtar eller anger en länk till hjälpfilen som är associerad med det här undantaget. (Ärvd från Exception) |
| HResult |
Hämtar eller anger HRESULT, ett kodat numeriskt värde som har tilldelats ett specifikt undantag. (Ärvd från Exception) |
| InnerException |
Hämtar den Exception instans som orsakade det aktuella undantaget. (Ärvd från Exception) |
| Lang |
Hämtar det mänskliga språket som är associerat med undantaget. (Ärvd från SoapException) |
| Message |
Hämtar ett meddelande som beskriver det aktuella undantaget. (Ärvd från Exception) |
| Node |
Hämtar en URI som representerar den koddel som orsakade undantaget. (Ärvd från SoapException) |
| Role |
Hämtar en URI som representerar XML-webbtjänstens funktion vid bearbetning av SOAP-meddelandet. (Ärvd från SoapException) |
| Source |
Hämtar eller anger namnet på programmet eller objektet som orsakar felet. (Ärvd från Exception) |
| StackTrace |
Hämtar en strängrepresentation av de omedelbara ramarna i anropsstacken. (Ärvd från Exception) |
| SubCode |
Hämtar den valfria felinformationen |
| TargetSite |
Hämtar den metod som utlöser det aktuella undantaget. (Ärvd från Exception) |
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetBaseException() |
När den åsidosätts i en härledd klass returnerar den Exception som är rotorsaken till ett eller flera efterföljande undantag. (Ärvd från Exception) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
SerializationInfo Anger med information om undantaget. (Ärvd från SoapException) |
| GetType() |
Hämtar körningstypen för den aktuella instansen. (Ärvd från Exception) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ToString() |
Skapar och returnerar en strängrepresentation av det aktuella undantaget. (Ärvd från Exception) |
Händelser
| Name | Description |
|---|---|
| SerializeObjectState |
Föråldrad.
Inträffar när ett undantag serialiseras för att skapa ett undantagstillståndsobjekt som innehåller serialiserade data om undantaget. (Ärvd från Exception) |