SoapDocumentServiceAttribute Classe

Référence

Définition

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

Assembly:: System.Web.Services.dll

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.

L'application de SoapDocumentServiceAttribute, attribut facultatif, à un service Web XML définit le format par défaut des demandes et réponses SOAP en provenance et en direction des méthodes de service Web XML dans le 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

Le vous permet de définir les styles de mise en forme par défaut pour les SoapDocumentServiceAttribute 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 un SoapDocumentMethodAttribute à cette méthode de service Web XML.

WSDL (Web Services Description Language) 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. Exactement la façon dont les parties de message individuelles sont déterminées par les Use propriétés et ParameterStyle . 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 seule partie de message 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 sur RPC, appliquez un SoapRpcServiceAttribute à la classe implémentant le 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

SoapDocumentServiceAttribute()	Initialise une nouvelle instance de la classe SoapDocumentServiceAttribute et affecte à toutes les propriétés leurs valeurs par défaut.
SoapDocumentServiceAttribute(SoapBindingUse)	Initialise une nouvelle instance de la classe SoapDocumentServiceAttribute et définit la mise en forme des paramètres.
SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)	Initialise une nouvelle instance de la classe SoapDocumentServiceAttribute, qui définit la mise en forme des paramètres et la façon dont les paramètres sont encapsulés dans un seul et même élément XML, sous l'élément `Body`, dans les messages SOAP.

Propriétés

ParameterStyle	Obtient ou définit le paramètre par défaut qui contrôle si les paramètres sont encapsulés dans un seul et même élément placé après l'élément `<Body>` dans la portion 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	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)
Use	Obtient ou définit la mise en forme par défaut des paramètres d'un service Web XML.

Méthodes

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 de cette instance. (Hérité de Attribute)
GetType()	Obtient le 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 pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

_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 pour 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 aux méthodes exposées par un objet. (Hérité de Attribute)

S’applique à