Binding Classe

Definizione

public ref class Binding abstract : System::ServiceModel::IDefaultCommunicationTimeouts

public abstract class Binding : System.ServiceModel.IDefaultCommunicationTimeouts

type Binding = class
    interface IDefaultCommunicationTimeouts

Public MustInherit Class Binding
Implements IDefaultCommunicationTimeouts

Ereditarietà

Object

Binding

Derivato

System.ServiceModel.BasicHttpBinding

System.ServiceModel.Channels.CustomBinding

System.ServiceModel.HttpBindingBase

System.ServiceModel.MsmqBindingBase

System.ServiceModel.NetNamedPipeBinding

Altro…

Implementazioni

IDefaultCommunicationTimeouts

Esempio

BasicHttpBinding binding = new BasicHttpBinding();

binding.Name = "binding1";

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

// Create a ServiceHost for the CalculatorService type and provide the base address.
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))
{
    serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, address);

    // 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();
}

Commenti

Rappresenta una raccolta di elementi di associazione, ognuno dei quali descrive un aspetto del modo in cui un endpoint comunica con altri endpoint e che vengono compilati, in modo coerente, in una channel factory nel client e in un listener di canale nel servizio. Un'associazione contiene una raccolta di elementi di associazione che corrispondono a canali di protocollo, canali di trasporto e codificatori di messaggi. Possono essere presenti un numero qualsiasi di elementi di associazione per i canali del protocollo, ma uno e un solo elemento di associazione per ogni codificatore di trasporto e messaggio. In un'associazione sono in genere presenti sei livelli di elementi di associazione. Sono necessari solo gli elementi di associazione di trasporto e codifica nella parte inferiore dello stack. Poiché per ogni associazione è necessaria una codifica, se non viene specificata una codifica, Windows Communication Foundation (WCF) aggiunge automaticamente una codifica predefinita. Il valore predefinito è Text/XML per i trasporti HTTP e HTTPS e Binary per altri trasporti.

La tabella seguente riepiloga le opzioni per ogni livello.

Ogni elemento di associazione fornisce la specifica per la compilazione di una channel factory nel client e di un listener del canale nel servizio. Quando lo stack della channel factory viene costruito, ad esempio, è presente una channel factory nello stack per ogni elemento di associazione nell'associazione. Lo stesso tipo di mapping si applica ai listener di canale nello stack nel servizio. La coerenza nel client e nel servizio è fondamentale per stabilire la connessione basata su canale tra questi endpoint. Ogni factory e listener, a sua volta, elabora l'invio e l'accettazione dei canali corrispondenti nello stack di canali che li connette e questi canali possono quindi inviare e ricevere i messaggi usati per comunicare.

Ogni istanza di un oggetto Binding ha un Name oggetto e Namespace che insieme lo identificano in modo univoco nei metadati del servizio. Se non viene specificato alcun nome o spazio dei nomi, WCF aggiunge automaticamente i valori predefiniti. Il nome predefinito è null e lo spazio dei nomi predefinito è http://tempuri.org/. Questo nome utente per l'associazione è distinto dalla specifica del nome del protocollo, specificato dalla Scheme proprietà . Se si desidera aggiungere altre associazioni HTTP, ad esempio, è possibile denominarle qualsiasi elemento desiderato e impostare tutti i relativi schemi su "http". Non esiste un'applicazione o un invio del computer intrinseco basato su Scheme. Quindi si evita il problema comune di non essere in grado di registrare gestori aggiuntivi per protocolli noti. È anche possibile usare facilmente più versioni di un binding side-by-side assegnando a ogni versione un nome diverso.

La Binding classe implementa l'interfaccia IDefaultCommunicationTimeouts per attenuare gli attacchi Denial of Service (DOS) che si basano sull'associazione delle risorse per intervalli di tempo prolungati. L'implementazione specifica i valori di timeout di comunicazione per l'apertura e la chiusura delle connessioni e per le operazioni di lettura e scrittura associate alla ricezione e all'invio di messaggi. Le proprietà usate per ottenere e impostare questi timeout e le relative operazioni di valori predefiniti sono riepilogate nella tabella seguente.

Quando si crea un'associazione ereditando da Binding, è necessario eseguire l'override di CreateBindingElements.

Inoltre, è possibile definire elementi di associazione personalizzati e inserirli tra uno dei livelli definiti nella tabella precedente. Per altre informazioni, vedere la classe CustomBinding.