Partager via

SoapDocumentServiceAttribute Classe

Définition

Espace de noms:
System.Web.Services.Protocols
Assembly:
System.Web.Services.dll

L’application de la SoapDocumentServiceAttribute facultative à un service Web XML définit le format par défaut des requêtes et réponses SOAP envoyées aux méthodes de service Web XML au sein du service Web XML.

public ref class SoapDocumentServiceAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class SoapDocumentServiceAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Class)>]
type SoapDocumentServiceAttribute = class
    inherit Attribute
Public NotInheritable Class SoapDocumentServiceAttribute
Inherits Attribute
Héritage
Object
Attribute
SoapDocumentServiceAttribute
Attributs
AttributeUsageAttribute

Exemples

<%@ WebService Language="c#" Class="SumService" %>

using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Services.Description;

    [SoapDocumentService(SoapBindingUse.Literal,
                         SoapParameterStyle.Wrapped,
                         RoutingStyle=SoapServiceRoutingStyle.SoapAction)]
    public class SumService : System.Web.Services.WebService
    {
        [WebMethod]
        public int Add(int a, int b)
        {
            return a + b;
        }
    }

<%@ WebService Language="VB" Class="SumService" %>

Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Web.Services.Description

    <SoapDocumentService(SoapBindingUse.Literal, _
                             SoapParameterStyle.Wrapped, _
                             RoutingStyle := SoapServiceRoutingStyle.SoapAction)> _
    Public Class SumService 
          Inherits System.Web.Services.WebService
    
        <WebMethod> _
        Public Function Add(a As Integer, b as Integer)
           return a + b
        End Function
    End Class

Remarques

Vous SoapDocumentServiceAttribute pouvez définir les styles de mise en forme par défaut pour les méthodes de service Web XML au sein d’un service Web XML. Si une méthode de service web XML individuelle doit modifier ces valeurs par défaut, appliquez-la SoapDocumentMethodAttribute à cette méthode de service Web XML.

Web Services Description Language (WSDL) définit deux styles pour la façon dont une méthode de service Web XML, qu’elle appelle une opération, peut être mise en forme dans une requête SOAP ou une réponse SOAP : RPC et Document. Comment les parties de message individuelles sont déterminées par les propriétés et ParameterStyle les Use propriétés. La Use propriété détermine si les paramètres sont mis en forme Encoded ou Literal. Détermine ParameterStyle si les paramètres sont encapsulés dans une partie de message unique sous l’élément Body , ou si chaque paramètre est une partie de message individuelle.

Pour définir la mise en forme au niveau de la méthode par défaut, appliquez une SoapRpcServiceAttribute à la classe implémentant RPCle service Web XML.

Pour plus d’informations, consultez Personnalisation de la mise en forme des messages SOAP.

Cet attribut peut être appliqué à une classe implémentant un service Web XML.

Constructeurs

Nom Description
SoapDocumentServiceAttribute()

Initialise une nouvelle instance de la SoapDocumentServiceAttribute classe définissant toutes les propriétés sur leurs valeurs par défaut.
SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)

Initialise une nouvelle instance de la SoapDocumentServiceAttribute classe qui définit la mise en forme des paramètres et définit si les paramètres sont encapsulés dans un seul élément XML, sous l’élément Body , dans les messages SOAP.
SoapDocumentServiceAttribute(SoapBindingUse)

Initialise une nouvelle instance de la SoapDocumentServiceAttribute classe définissant la mise en forme des paramètres.

Propriétés

Nom Description
ParameterStyle

Obtient ou définit le paramètre par défaut qui contrôle si les paramètres sont encapsulés dans un seul élément suivant l’élément <Body> dans la partie XML d’un message SOAP pour les méthodes de service Web XML du service Web XML.
RoutingStyle

Obtient ou définit la façon dont les messages SOAP sont routés vers le service Web XML.
TypeId

En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute.

(Hérité de Attribute)
Use

Obtient ou définit la mise en forme de paramètre par défaut pour un service Web XML.

Méthodes

Nom Description
Equals(Object)

Retourne une valeur qui indique si cette instance est égale à un objet spécifié.

(Hérité de Attribute)
GetHashCode()

Retourne le code de hachage pour cette instance.

(Hérité de Attribute)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
IsDefaultAttribute()

En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut de la classe dérivée.

(Hérité de Attribute)
Match(Object)

En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié.

(Hérité de Attribute)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

Implémentations d’interfaces explicites

Nom Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.

(Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Récupère les informations de type d’un objet, qui peuvent être utilisées pour obtenir les informations de type d’une interface.

(Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1).

(Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fournit l’accès aux propriétés et méthodes exposées par un objet.

(Hérité de Attribute)

S’applique à

Voir aussi