SoapHeaderException Klass

Definition

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

Name Description
SoapHeaderException()

Initierar en ny instans av SoapHeaderException klassen.

SoapHeaderException(SerializationInfo, StreamingContext)

Initierar en ny instans av SoapHeaderException klassen med parametrar för att kontrollera serialisering.

SoapHeaderException(String, XmlQualifiedName, Exception)

Initierar en ny instans av SoapHeaderException klassen.

SoapHeaderException(String, XmlQualifiedName, String, Exception)

Initierar en ny instans av SoapHeaderException klassen.

SoapHeaderException(String, XmlQualifiedName, String, String, SoapFaultSubCode, Exception)

Initierar en ny instans av SoapHeaderException klassen med associerade data.

SoapHeaderException(String, XmlQualifiedName, String, String, String, SoapFaultSubCode, Exception)

Initierar en ny instans av SoapHeaderException klassen med associerade data.

SoapHeaderException(String, XmlQualifiedName, String)

Initierar en ny instans av SoapHeaderException klassen.

SoapHeaderException(String, XmlQualifiedName)

Initierar en ny instans av SoapHeaderException klassen.

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 subcode i XML-elementet för ett SOAP-fel.

(Ärvd från SoapException)
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)

Gäller för

Se även