WebServiceBindingAttribute WebServiceBindingAttribute WebServiceBindingAttribute WebServiceBindingAttribute Class

Определение

Указывает привязку, определяющую один или несколько методов веб-службы XML.Declares a binding that defines one or more XML Web service methods. Этот класс не наследуется.This class cannot be inherited.

public ref class WebServiceBindingAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true, Inherited=true)]
[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true)]
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true)]
public sealed class WebServiceBindingAttribute : Attribute
type WebServiceBindingAttribute = class
    inherit Attribute
Public NotInheritable Class WebServiceBindingAttribute
Inherits Attribute
Наследование
WebServiceBindingAttributeWebServiceBindingAttributeWebServiceBindingAttributeWebServiceBindingAttribute
Атрибуты

Примеры

Следующая веб-служба XML реализует операции из четырех привязок.The following XML Web service implements operations from four bindings. В частности, веб-служба XML объявляет три привязки, для которых она реализует операции, применяя к веб-службе XML три WebServiceBindingAttribute атрибута.Specifically, the XML Web service declares three bindings it implements operations for, by applying three WebServiceBindingAttribute attributes to the XML Web service.

Чтобы указать, в какой привязке метод веб-службы XML реализует операцию для, SoapDocumentMethodAttribute применяется к каждому методу веб-службы XML, за исключением. DefaultBindingMethodTo specify which binding an XML Web service method is implementing an operation for, a SoapDocumentMethodAttribute is applied to each of the XML Web service methods, except DefaultBindingMethod. Не указывая привязку для DefaultBindingMethod, она реализует операцию с привязкой по умолчанию для веб-службы XML.By not specifying a binding for DefaultBindingMethod, it is implementing an operation on the default binding for the XML Web service.

<%@ 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

Комментарии

Привязка, определенная с помощью языка описания веб-служб (WSDL), аналогична интерфейсу, в которой он определяет конкретный набор операций.A binding, as defined by Web Services Description Language (WSDL), is similar to an interface, in that it defines a concrete set of operations. Каждый метод веб-службы XML является операцией в определенной привязке.Each XML Web service method is an operation within a particular binding. Методы веб-службы XML являются членами либо привязки по умолчанию для веб-службы XML, либо привязки, заданной в, WebServiceBindingAttribute примененном к классу, реализующему веб-службу XML.XML Web service methods are members of either the default binding for an XML Web service or a binding specified within a WebServiceBindingAttribute applied to a class implementing an XML Web service. Веб-служба XML может реализовать несколько привязок, применяя WebServiceBindingAttribute несколько атрибутов к веб-службе XML.An XML Web service can implement multiple bindings, by applying multiple WebServiceBindingAttribute attributes to an XML Web service.

После применения к веб WebServiceAttribute -службе XML одного или нескольких атрибутов можно применить SoapDocumentMethodAttribute или SoapRpcMethodAttribute к отдельным методам веб-службы XML, чтобы указать операцию привязки, реализуемую определенным методом веб-службы XML.Once one or more WebServiceAttribute attributes are applied to an XML Web service, a SoapDocumentMethodAttribute or SoapRpcMethodAttribute can be applied to individual XML Web service methods to indicate the binding operation implemented by a particular XML Web service method. Задайте свойство объекта SoapDocumentMethodAttribute илиSoapRpcMethodAttribute , чтобы указать привязку, для которой метод веб-службы XML реализует операцию для. BindingSet the Binding property of SoapDocumentMethodAttribute or SoapRpcMethodAttribute to specify the binding an XML Web service method is implementing an operation for.

Конструкторы

WebServiceBindingAttribute() WebServiceBindingAttribute() WebServiceBindingAttribute() WebServiceBindingAttribute()

Инициализирует новый экземпляр класса WebServiceBindingAttribute.Initializes a new instance of the WebServiceBindingAttribute class.

WebServiceBindingAttribute(String) WebServiceBindingAttribute(String) WebServiceBindingAttribute(String) WebServiceBindingAttribute(String)

Инициализирует новый экземпляр класса WebServiceBindingAttribute, задавая имя привязки, реализуемой методом веб-службы XML.Initializes a new instance of the WebServiceBindingAttribute class setting the name of the binding the XML Web service method is implementing.

WebServiceBindingAttribute(String, String) WebServiceBindingAttribute(String, String) WebServiceBindingAttribute(String, String) WebServiceBindingAttribute(String, String)

Инициализирует новый экземпляр класса WebServiceBindingAttribute.Initializes a new instance of the WebServiceBindingAttribute class.

WebServiceBindingAttribute(String, String, String) WebServiceBindingAttribute(String, String, String) WebServiceBindingAttribute(String, String, String) WebServiceBindingAttribute(String, String, String)

Инициализирует новый экземпляр класса WebServiceBindingAttribute.Initializes a new instance of the WebServiceBindingAttribute class.

Свойства

ConformsTo ConformsTo ConformsTo ConformsTo

Получает или задает спецификацию совместимости веб-служб (WSI), которой должна соответствовать данная привязка.Gets or sets the Web Services Interoperability (WSI) specification to which the binding claims to conform.

EmitConformanceClaims EmitConformanceClaims EmitConformanceClaims EmitConformanceClaims

Получает или задает значение, указывающее, требует ли привязка соответствия какой-либо спецификации.Gets or sets a value that indicates whether the binding emits conformance claims.

Location Location Location Location

Получает или задает расположение, где определена привязка.Gets or sets the location where the binding is defined.

Name Name Name Name

Получает или задает имя привязки.Gets or sets the name of the binding.

Namespace Namespace Namespace Namespace

Получает или задает пространство имен, связанное с привязкой.Gets or sets the namespace associated with the binding.

TypeId TypeId TypeId TypeId

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Возвращает значение, показывающее, равен ли экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-код данного экземпляра.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

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

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Применяется к

Дополнительно