WebServiceBindingAttribute Classe

Definizione

Spazio dei nomi:

System.Web.Services

Assembly:

System.Web.Services.dll

Dichiara un'associazione che definisce uno o più metodi del servizio Web XML. Questa classe non può essere ereditata.

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

Ereditarietà

Object

Attribute

WebServiceBindingAttribute

Attributi

AttributeUsageAttribute

Esempio

Il servizio Web XML seguente implementa le operazioni da quattro associazioni. In particolare, il servizio Web XML dichiara tre associazioni per cui implementa le operazioni applicando tre WebServiceBindingAttribute attributi al servizio Web XML.

Per specificare l'associazione di un metodo di servizio Web XML che implementa un'operazione per , un SoapDocumentMethodAttribute oggetto viene applicato a ognuno dei metodi del servizio Web XML, ad eccezione DefaultBindingMethoddi . Non specificando un'associazione per DefaultBindingMethod, implementa un'operazione sull'associazione predefinita per il servizio 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

Commenti

Un'associazione, come definito da Web Services Description Language (WSDL), è simile a un'interfaccia, in quanto definisce un set concreto di operazioni. Ogni metodo di servizio Web XML è un'operazione all'interno di un'associazione specifica. I metodi del servizio Web XML sono membri dell'associazione predefinita per un servizio Web XML o di un'associazione specificata all'interno di una WebServiceBindingAttribute classe applicata all'implementazione di un servizio Web XML. Un servizio Web XML può implementare più associazioni applicando più WebServiceBindingAttribute attributi a un servizio Web XML.

Una volta applicati uno o più WebServiceAttribute attributi a un servizio Web XML, un SoapDocumentMethodAttribute oggetto o SoapRpcMethodAttribute può essere applicato ai singoli metodi del servizio Web XML per indicare l'operazione di associazione implementata da un particolare metodo di servizio Web XML. Impostare la Binding proprietà di SoapDocumentMethodAttribute o SoapRpcMethodAttribute per specificare l'associazione di un metodo di servizio Web XML per l'implementazione di un'operazione.

Costruttori

Nome	Descrizione
WebServiceBindingAttribute()	Inizializza una nuova istanza della classe WebServiceBindingAttribute.
WebServiceBindingAttribute(String, String, String)	Inizializza una nuova istanza della classe WebServiceBindingAttribute.
WebServiceBindingAttribute(String, String)	Inizializza una nuova istanza della classe WebServiceBindingAttribute.
WebServiceBindingAttribute(String)	Inizializza una nuova istanza della WebServiceBindingAttribute classe impostando il nome dell'associazione che il metodo del servizio Web XML sta implementando.

Proprietà

Nome	Descrizione
ConformsTo	Ottiene o imposta la specifica WSI (Web Services Interoperability) a cui devono essere conformi le attestazioni di associazione.
EmitConformanceClaims	Ottiene o imposta un valore che indica se l'associazione genera attestazioni di conformità.
Location	Ottiene o imposta la posizione in cui è definita l'associazione.
Name	Ottiene o imposta il nome dell'associazione.
Namespace	Ottiene o imposta lo spazio dei nomi associato all'associazione.
TypeId	Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute. (Ereditato da Attribute)

Metodi

Nome	Descrizione
Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per questa istanza. (Ereditato da Attribute)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	Quando sottoposto a override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch. (Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera le informazioni sul tipo per un oggetto, che può essere utilizzato per ottenere le informazioni sul tipo per un'interfaccia. (Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornisce l'accesso alle proprietà e ai metodi esposti da un oggetto . (Ereditato da Attribute)

Vedi anche

• SoapDocumentMethodAttribute
• SoapRpcMethodAttribute