CustomBinding Kelas

Definisi

public ref class CustomBinding : System::ServiceModel::Channels::Binding

public class CustomBinding : System.ServiceModel.Channels.Binding

[System.Windows.Markup.ContentProperty("Elements")]
public class CustomBinding : System.ServiceModel.Channels.Binding

type CustomBinding = class
    inherit Binding

[<System.Windows.Markup.ContentProperty("Elements")>]
type CustomBinding = class
    inherit Binding

Public Class CustomBinding
Inherits Binding

Warisan

Object

Binding

CustomBinding

Atribut

ContentPropertyAttribute

Contoh

Contoh berikut menunjukkan cara membuat CustomBinding objek menggunakan ReliableSessionBindingElement dan HttpTransportBindingElement

Uri baseAddress = new Uri("http://localhost:8000/servicemodelsamples/service");

// Create a ServiceHost for the CalculatorService type and provide the base address.
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))
{
    // Create a custom binding that contains two binding elements.
    ReliableSessionBindingElement reliableSession = new ReliableSessionBindingElement();
    reliableSession.Ordered = true;

    HttpTransportBindingElement httpTransport = new HttpTransportBindingElement();
    httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous;
    httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;

    CustomBinding binding = new CustomBinding(reliableSession, httpTransport);

    // Add an endpoint using that binding.
    serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, "");

    // Add a MEX endpoint.
    ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
    smb.HttpGetEnabled = true;
    smb.HttpGetUrl = new Uri("http://localhost:8001/servicemodelsamples");
    serviceHost.Description.Behaviors.Add(smb);

    // Open the ServiceHostBase to create listeners and start listening for messages.
    serviceHost.Open();

    // The service can now be accessed.
    Console.WriteLine("The service is ready.");
    Console.WriteLine("Press <ENTER> to terminate service.");
    Console.WriteLine();
    Console.ReadLine();

    // Close the ServiceHostBase to shutdown the service.
    serviceHost.Close();
}

Dim baseAddress As New Uri("http://localhost:8000/servicemodelsamples/service")

' Create a ServiceHost for the CalculatorService type and provide the base address.
Using serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)
    ' Create a custom binding that contains two binding elements.
    Dim reliableSession As New ReliableSessionBindingElement()
    reliableSession.Ordered = True

    Dim httpTransport As New HttpTransportBindingElement()
    httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous
    httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard

    Dim binding As New CustomBinding(reliableSession, httpTransport)

    ' Add an endpoint using that binding.
    serviceHost.AddServiceEndpoint(GetType(ICalculator), binding, "")

    ' Add a MEX endpoint.
    Dim smb As New ServiceMetadataBehavior()
    smb.HttpGetEnabled = True
    smb.HttpGetUrl = New Uri("http://localhost:8001/servicemodelsamples")
    serviceHost.Description.Behaviors.Add(smb)

    ' Open the ServiceHostBase to create listeners and start listening for messages.
    serviceHost.Open()

    ' The service can now be accessed.
    Console.WriteLine("The service is ready.")
    Console.WriteLine("Press <ENTER> to terminate service.")
    Console.WriteLine()
    Console.ReadLine()

    ' Close the ServiceHostBase to shutdown the service.
    serviceHost.Close()
End Using

Keterangan

Gunakan pengikatan kustom saat salah satu pengikatan yang disediakan sistem tidak memenuhi persyaratan layanan Anda. Pengikatan kustom dapat digunakan, misalnya, untuk mengaktifkan penggunaan transportasi baru atau encoder baru di titik akhir layanan.

Pengikatan kustom dibangun menggunakan salah CustomBinding satu dari kumpulan elemen pengikatan yang "ditumpuk" dalam urutan tertentu:

• Di bagian atas adalah opsional TransactionFlowBindingElement yang memungkinkan transaksi yang mengalir.

• Selanjutnya adalah opsional ReliableSessionBindingElement yang menyediakan sesi dan mekanisme pemesanan seperti yang didefinisikan dalam spesifikasi WS-ReliableMessaging. Gagasan sesi ini dapat melintasi SOAP dan perantara transportasi.

• Selanjutnya adalah elemen pengikatan keamanan opsional yang menyediakan fitur keamanan seperti otorisasi, autentikasi, perlindungan, dan kerahasiaan. Elemen pengikatan keamanan berikut disediakan oleh Windows Communication Foundation (WCF):

  • SecurityBindingElement

  • AsymmetricSecurityBindingElement

  • SymmetricSecurityBindingElement

  • TransportSecurityBindingElement

• Selanjutnya adalah pola pesan opsional yang ditentukan oleh elemen pengikatan:

• CompositeDuplexBindingElement

• Selanjutnya adalah elemen pengikatan peningkatan/pembantu transportasi opsional:

  • PnrpPeerResolverBindingElement

  • SslStreamSecurityBindingElement

  • WindowsStreamSecurityBindingElement

• Selanjutnya adalah elemen pengikatan pengodean pesan yang diperlukan. Anda dapat menggunakan transportasi Anda sendiri atau menggunakan salah satu pengodean pesan berikut:

  • TextMessageEncodingBindingElement

  • BinaryMessageEncodingBindingElement

  • MtomMessageEncodingBindingElement

• Di bagian bawah adalah elemen transportasi yang diperlukan. Anda dapat menggunakan transportasi Anda sendiri atau menggunakan salah satu elemen pengikatan transportasi yang disediakan oleh Windows Communication Foundation (WCF):

  • TcpTransportBindingElement

  • NamedPipeTransportBindingElement

  • HttpTransportBindingElement

  • HttpsTransportBindingElement

  • MsmqTransportBindingElement

  • MsmqIntegrationBindingElement

  • PeerTransportBindingElement

Tabel berikut ini meringkas opsi untuk setiap lapisan.

Selain itu, Anda dapat menentukan elemen pengikatan Anda sendiri dan menyisipkannya di antara salah satu lapisan yang ditentukan sebelumnya.

Untuk diskusi tentang cara menggunakan pengikatan kustom untuk memodifikasi pengikatan yang disediakan sistem, lihat Cara: Menyesuaikan pengikatan System-Provided.