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 truesur . Si la méthode de service Web XML ne définit pas la DidUnderstand propriété de l’en-tête MyHeader trueSOAP, 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.
Notes
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
| Actor |
Obtient la partie du code qui a provoqué l'exception. (Hérité de SoapException) |
| Code |
Obtient le type du code d'erreur SOAP. (Hérité de SoapException) |
| Data |
Obtient une collection de paires clé/valeur qui fournissent des informations définies par l'utilisateur supplémentaires 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 qui est assigné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é à cette exception. (Hérité de SoapException) |
| Message |
Obtient un message qui décrit l'exception active. (Hérité de Exception) |
| Node |
Obtient un URI qui représente la partie du code ayant provoqué l'exception. (Hérité de SoapException) |
| Role |
Obtient un URI représentant la fonction du service Web XML dans le traitement du message SOAP. (Hérité de SoapException) |
| Source |
Obtient ou définit le nom de l'application ou de l'objet qui est à l'origine de l'erreur. (Hérité de Exception) |
| StackTrace |
Obtient une représentation sous forme de chaîne des frames immédiats sur la pile des appels. (Hérité de Exception) |
| SubCode |
Obtient les informations sur l’erreur facultatives contenues dans l’élément XML |
| TargetSite |
Obtient la méthode qui lève l'exception actuelle. (Hérité de Exception) |
Méthodes
| 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 qui est à l'origine d'une ou de plusieurs exceptions ultérieures. (Hérité de Exception) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Définit SerializationInfo avec des informations concernant l'exception. (Hérité de SoapException) |
| GetType() |
Obtient le type au moment de l'exécution de l'instance actuelle. (Hérité de Exception) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| ToString() |
Crée et retourne une chaîne représentant l'exception actuelle. (Hérité de Exception) |
Événements
| SerializeObjectState |
Obsolète.
Se produit quand une exception est sérialisée pour créer un objet d'état d'exception qui contient des données sérialisées concernant l'exception. (Hérité de Exception) |