WebServiceBindingAttribute Classe

Définition

Espace de noms:

System.Web.Services

Assembly:

System.Web.Services.dll

Déclare une liaison qui définit une ou plusieurs méthodes de service Web XML. Cette classe ne peut pas être héritée.

public ref class WebServiceBindingAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true)]
public sealed class WebServiceBindingAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true)>]
type WebServiceBindingAttribute = class
    inherit Attribute

Public NotInheritable Class WebServiceBindingAttribute
Inherits Attribute

Héritage

Object

Attribute

WebServiceBindingAttribute

Attributs

AttributeUsageAttribute

Exemples

Le service web XML suivant implémente des opérations à partir de quatre liaisons. Plus précisément, le service Web XML déclare trois liaisons pour laquelle il implémente des opérations, en appliquant trois WebServiceBindingAttribute attributs au service Web XML.

Pour spécifier la liaison d’une méthode de service Web XML pour laquelle une opération est implémentée, elle SoapDocumentMethodAttribute est appliquée à chacune des méthodes de service Web XML, à l’exception DefaultBindingMethodde . En ne spécifiant pas de liaison pour DefaultBindingMethod, il implémente une opération sur la liaison par défaut pour le service Web XML.

<%@ WebService Language="C#" class="BindingSample" %>
 using System;
 using System.Web.Services;
 using System.Web.Services.Protocols;

 // Binding is defined in this XML Web service and uses the default namespace.
 [ WebServiceBinding(Name="LocalBinding")]

 // Binding is defined in this XML Web service, but it is not a part of the default namespace.
 [ WebServiceBinding(Name="LocalBindingNonDefaultNamespace", 
             Namespace="http://www.contoso.com/MyBinding" )]

 // Binding is defined on a remote server, but this XML Web service implements at least one operation in that binding.
 [ WebServiceBinding(Name="RemoteBinding", 
          Namespace="http://www.contoso.com/MyBinding",
          Location="http://www.contoso.com/MySevice.asmx?wsdl")]
 public class BindingSample  {

      [ SoapDocumentMethod(Binding="LocalBinding")]
      [ WebMethod() ]
      public string LocalBindingMethod() {
               return "Member of binding defined in this XML Web service and member of the default namespace";
      }
      [ SoapDocumentMethod(Binding="LocalBindingNonDefaultNamespace")] 
      [ WebMethod() ]
      public string LocalBindingNonDefaultNamespaceMethod() {
              return "Member of binding defined in this XML Web service, but a part of a different namespace";
      }

     [ SoapDocumentMethod(Binding="RemoteBinding")] 
     [ WebMethod() ]
      public string RemoteBindingMethod() {
              return "Member of a binding defined on another server";
      }

      [ WebMethod() ]
      public string DefaultBindingMethod() {
              return "Member of the default binding";
      }
 
 }

<%@ WebService Language="VB" class="BindingSample" %>
Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols

' Binding is defined in this XML Web service and uses the default namespace.
' Binding is defined in this XML Web service, but it is not a part of the default
' namespace.
' Binding is defined on a remote server, but this XML Web service implements at
' least one operation in that binding.
<WebServiceBinding(Name := "LocalBinding"), _ 
 WebServiceBinding(Name := "LocalBindingNonDefaultNamespace", _ 
                   Namespace := "http://www.contoso.com/MyBinding"), _     
 WebServiceBinding(Name := "RemoteBinding", _ 
                   Namespace := "http://www.contoso.com/MyBinding", _
                   Location := "http://www.contoso.com/MySevice.asmx?wsdl")> _
Public Class BindingSample
    
    <SoapDocumentMethod(Binding := "LocalBinding"), WebMethod()> _
    Public Function LocalBindingMethod() As String
        
        Return "Member of binding defined in this XML Web service and member of the default namespace"
    End Function
    
    <SoapDocumentMethod(Binding := "LocalBindingNonDefaultNamespace"), WebMethod()> _
    Public Function LocalBindingNonDefaultNamespaceMethod() As String
    
        Return "Member o1f binding defined in this XML Web service, but a part of a different namespace"
    End Function    
    
    <SoapDocumentMethod(Binding := "RemoteBinding"), WebMethod()> _
    Public Function RemoteBindingMethod() As String
    
        Return "Member of a binding defined on another server"
    End Function    
    
    <WebMethod()> _
    Public Function DefaultBindingMethod() As String
    
        Return "Member of the default binding"
    End Function
End Class

Remarques

Une liaison, telle que définie par le langage WSDL (Web Services Description Language), est similaire à une interface, dans laquelle elle définit un ensemble concret d’opérations. Chaque méthode de service web XML est une opération au sein d’une liaison particulière. Les méthodes de service web XML sont membres de la liaison par défaut d’un service Web XML ou d’une liaison spécifiée dans une WebServiceBindingAttribute classe qui implémente un service Web XML. Un service web XML peut implémenter plusieurs liaisons, en appliquant plusieurs WebServiceBindingAttribute attributs à un service Web XML.

Une fois qu’un ou plusieurs WebServiceAttribute attributs sont appliqués à un service Web XML, un SoapDocumentMethodAttribute ou SoapRpcMethodAttribute peut être appliqué à des méthodes de service Web XML individuelles pour indiquer l’opération de liaison implémentée par une méthode de service Web XML particulière. Définissez la Binding propriété ou SoapRpcMethodAttributeSoapDocumentMethodAttribute spécifiez la liaison pour laquelle une méthode de service Web XML implémente une opération.

Constructeurs

Nom	Description
WebServiceBindingAttribute()	Initialise une nouvelle instance de la classe WebServiceBindingAttribute.
WebServiceBindingAttribute(String, String, String)	Initialise une nouvelle instance de la classe WebServiceBindingAttribute.
WebServiceBindingAttribute(String, String)	Initialise une nouvelle instance de la classe WebServiceBindingAttribute.
WebServiceBindingAttribute(String)	Initialise une nouvelle instance de la WebServiceBindingAttribute classe définissant le nom de la liaison que la méthode de service Web XML implémente.

Propriétés

Nom	Description
ConformsTo	Obtient ou définit la spécification WSI (Web Services Interopérabilité) sur laquelle les revendications de liaison doivent être conformes.
EmitConformanceClaims	Obtient ou définit une valeur qui indique si la liaison émet des revendications de conformité.
Location	Obtient ou définit l’emplacement où la liaison est définie.
Name	Obtient ou définit le nom de la liaison.
Namespace	Obtient ou définit l’espace de noms associé à la liaison.
TypeId	En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute)

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)

Voir aussi

• SoapDocumentMethodAttribute
• SoapRpcMethodAttribute