WebServiceBindingAttribute Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendeklarasikan pengikatan yang menentukan satu atau beberapa metode layanan Web XML. Kelas ini tidak dapat diwariskan.
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
- Warisan
- Atribut
Contoh
Layanan Web XML berikut menerapkan operasi dari empat pengikatan. Secara khusus, layanan Web XML mendeklarasikan tiga pengikatan yang diimplementasikan operasinya, dengan menerapkan tiga WebServiceBindingAttribute atribut ke layanan Web XML.
Untuk menentukan metode layanan Web XML yang mengikat yang mengimplementasikan operasi, SoapDocumentMethodAttribute diterapkan ke setiap metode layanan Web XML, kecuali DefaultBindingMethod
. Dengan tidak menentukan pengikatan untuk DefaultBindingMethod
, ini menerapkan operasi pada pengikatan default untuk layanan 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
Keterangan
Pengikatan, seperti yang didefinisikan oleh Web Services Description Language (WSDL), mirip dengan antarmuka, karena mendefinisikan serangkaian operasi konkret. Setiap metode layanan Web XML adalah operasi dalam pengikatan tertentu. Metode layanan Web XML adalah anggota pengikatan default untuk layanan Web XML atau pengikatan yang ditentukan dalam diterapkan WebServiceBindingAttribute ke kelas yang menerapkan layanan Web XML. Layanan Web XML dapat menerapkan beberapa pengikatan, dengan menerapkan beberapa WebServiceBindingAttribute atribut ke layanan Web XML.
Setelah satu atau beberapa WebServiceAttribute atribut diterapkan ke layanan Web XML, SoapDocumentMethodAttribute atau SoapRpcMethodAttribute dapat diterapkan ke metode layanan Web XML individual untuk menunjukkan operasi pengikatan yang diterapkan oleh metode layanan Web XML tertentu. Atur Binding properti dari SoapDocumentMethodAttribute atau SoapRpcMethodAttribute untuk menentukan pengikatan metode layanan Web XML yang mengimplementasikan operasi.
Konstruktor
WebServiceBindingAttribute() |
Menginisialisasi instans baru kelas WebServiceBindingAttribute. |
WebServiceBindingAttribute(String) |
Menginisialisasi instans baru dari WebServiceBindingAttribute pengaturan kelas nama pengikatan yang diterapkan metode layanan Web XML. |
WebServiceBindingAttribute(String, String) |
Menginisialisasi instans baru kelas WebServiceBindingAttribute. |
WebServiceBindingAttribute(String, String, String) |
Menginisialisasi instans baru kelas WebServiceBindingAttribute. |
Properti
ConformsTo |
Mendapatkan atau mengatur spesifikasi Interoperabilitas Layanan Web (WSI) yang klaim pengikatannya sesuai. |
EmitConformanceClaims |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengikatan memancarkan klaim kesesuaian. |
Location |
Mendapatkan atau mengatur lokasi tempat pengikatan ditentukan. |
Name |
Mendapatkan atau mengatur nama pengikatan. |
Namespace |
Mendapatkan atau mengatur namespace yang terkait dengan pengikatan. |
TypeId |
Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute) |
Metode
Equals(Object) |
Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute) |
GetHashCode() |
Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute) |
GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
IsDefaultAttribute() |
Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute) |
Match(Object) |
Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute) |
MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Implementasi Antarmuka Eksplisit
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Memetakan sekumpulan nama ke sekumpulan pengidentifikasi pengiriman yang sesuai. (Diperoleh dari Attribute) |
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Mengambil informasi jenis untuk objek, yang dapat digunakan untuk mendapatkan informasi jenis untuk antarmuka. (Diperoleh dari Attribute) |
_Attribute.GetTypeInfoCount(UInt32) |
Mengambil jumlah antarmuka informasi jenis yang disediakan objek (baik 0 atau 1). (Diperoleh dari Attribute) |
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Menyediakan akses ke properti dan metode yang diekspos oleh objek. (Diperoleh dari Attribute) |