SoapHeaderException Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représentation SOAP d’une erreur de serveur.
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- Héritage
- Attributs
Exemples
Dans l’exemple suivant, un client de service Web XML appelle la MyWebMethod méthode de service Web XML, en passant un en-tête SOAP de type MyHeader avec la MustUnderstand propriété définie sur true. Si la méthode de service Web XML ne définit pas la DidUnderstand propriété de l’en-tête MyHeadertrueSOAP sur , une SoapHeaderException valeur est levée.
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
Remarques
Lorsqu’un client de service web XML ajoute un en-tête SOAP à un appel de méthode de service Web XML avec la MustUnderstand propriété définie truesur , la méthode de service Web XML doit définir la DidUnderstand propriété truesur ; sinon, une SoapHeaderException exception est levée.
La Detail propriété ne peut pas être définie en fonction de la spécification SOAP d’un SoapHeaderException.
Note
Les applications qui utilisent la spécification SOAP 1.1 comme protocole de service peuvent utiliser les SoapHeaderException erreurs SOAP pour accéder aux erreurs SOAP. Toutefois, les applications qui utilisent la spécification SOAP 1.2 doivent utiliser les SoapException erreurs SOAP pour accéder aux erreurs SOAP.
Constructeurs
Propriétés
| Nom | Description |
|---|---|
| Actor |
Obtient l’élément de code qui a provoqué l’exception. (Hérité de SoapException) |
| Code |
Obtient le type de code d’erreur SOAP. (Hérité de SoapException) |
| Data |
Obtient une collection de paires clé/valeur qui fournissent des informations supplémentaires définies par l’utilisateur sur l’exception. (Hérité de Exception) |
| Detail |
Obtient un XmlNode qui représente les informations d’erreur spécifiques à l’application. (Hérité de SoapException) |
| HelpLink |
Obtient ou définit un lien vers le fichier d’aide associé à cette exception. (Hérité de Exception) |
| HResult |
Obtient ou définit HRESULT, valeur numérique codée affectée à une exception spécifique. (Hérité de Exception) |
| InnerException |
Obtient l’instance Exception qui a provoqué l’exception actuelle. (Hérité de Exception) |
| Lang |
Obtient le langage humain associé à l’exception. (Hérité de SoapException) |
| Message |
Obtient un message qui décrit l’exception actuelle. (Hérité de Exception) |
| Node |
Obtient un URI qui représente l’élément de code qui a provoqué l’exception. (Hérité de SoapException) |
| Role |
Obtient un URI qui représente la fonction du service Web XML lors du traitement du message SOAP. (Hérité de SoapException) |
| Source |
Obtient ou définit le nom de l’application ou de l’objet qui provoque l’erreur. (Hérité de Exception) |
| StackTrace |
Obtient une représentation sous forme de chaîne des images immédiates sur la pile des appels. (Hérité de Exception) |
| SubCode |
Obtient les informations d’erreur facultatives contenues dans l’élément |
| TargetSite |
Obtient la méthode qui lève l’exception actuelle. (Hérité de Exception) |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetBaseException() |
En cas de substitution dans une classe dérivée, retourne la Exception cause racine d’une ou plusieurs exceptions ultérieures. (Hérité de Exception) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Définit les SerializationInfo informations avec sur l’exception. (Hérité de SoapException) |
| GetType() |
Obtient le type d’exécution de l’instance actuelle. (Hérité de Exception) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Crée et retourne une représentation sous forme de chaîne de l’exception actuelle. (Hérité de Exception) |
Événements
| Nom | Description |
|---|---|
| SerializeObjectState |
Obsolète.
Se produit lorsqu’une exception est sérialisée pour créer un objet d’état d’exception qui contient des données sérialisées sur l’exception. (Hérité de Exception) |
