WebServiceBindingAttribute Clase

Referencia

Definición

Espacio de nombres:: System.Web.Services

Ensamblado:: System.Web.Services.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Declara un enlace que define uno o más métodos de servicios Web XML. Esta clase no puede heredarse.

public ref class WebServiceBindingAttribute sealed : Attribute

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

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

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

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

Public NotInheritable Class WebServiceBindingAttribute
Inherits Attribute

Herencia: Object

Attribute
WebServiceBindingAttribute

Atributos: AttributeUsageAttribute

Ejemplos

El siguiente servicio web XML implementa operaciones de cuatro enlaces. En concreto, el servicio web XML declara tres enlaces para los que implementa operaciones mediante la aplicación de tres WebServiceBindingAttribute atributos al servicio web XML.

Para especificar el enlace de un método de servicio web XML para el que se implementa una operación, SoapDocumentMethodAttribute se aplica a cada uno de los métodos de servicio web XML, excepto DefaultBindingMethod. Al no especificar un enlace para DefaultBindingMethod, está implementando una operación en el enlace predeterminado para el servicio 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

Comentarios

Un enlace, tal como se define en el Lenguaje de descripción de servicios web (WSDL), es similar a una interfaz, en que define un conjunto concreto de operaciones. Cada método de servicio web XML es una operación dentro de un enlace determinado. Los métodos de servicio web XML son miembros del enlace predeterminado para un servicio web XML o un enlace especificado dentro de una WebServiceBindingAttribute clase que implementa un servicio web XML. Un servicio web XML puede implementar varios enlaces aplicando varios WebServiceBindingAttribute atributos a un servicio web XML.

Una vez que uno o varios WebServiceAttribute atributos se aplican a un servicio web XML, SoapDocumentMethodAttribute o SoapRpcMethodAttribute se pueden aplicar a métodos de servicio web XML individuales para indicar la operación de enlace implementada por un método de servicio web XML determinado. Establezca la Binding propiedad de SoapDocumentMethodAttribute o SoapRpcMethodAttribute para especificar el enlace de un método de servicio web XML para el que está implementando una operación.

Constructores

WebServiceBindingAttribute()	Inicializa una nueva instancia de la clase WebServiceBindingAttribute.
WebServiceBindingAttribute(String)	Inicializa una nueva instancia de la clase WebServiceBindingAttribute estableciendo el nombre del enlace que el método de servicios Web XML está implementando.
WebServiceBindingAttribute(String, String)	Inicializa una nueva instancia de la clase WebServiceBindingAttribute.
WebServiceBindingAttribute(String, String, String)	Inicializa una nueva instancia de la clase WebServiceBindingAttribute.

Propiedades

ConformsTo	Obtiene o establece la especificación de la interoperabilidad de los servicios Web (WSI) a la que el enlace solicita su conformidad.
EmitConformanceClaims	Obtiene o establece un valor que indica si el enlace emite las solicitudes de conformidad.
Location	Obtiene o establece la ubicación donde se define el enlace.
Name	Obtiene o establece el nombre del enlace.
Namespace	Obtiene o establece el espacio de nombres asociado al enlace.
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). (Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Proporciona acceso a las propiedades y los métodos expuestos por un objeto. (Heredado de Attribute)

Se aplica a

Compartir vía