Binding Classe

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v8.0.0

Source:

Binding.cs

Contient les éléments de liaison spécifiant les protocoles, les transports et les encodeurs de message utilisés pour la communication entre les clients et les services.

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

Héritage

Object

Binding

Dérivé

System.ServiceModel.Channels.CustomBinding

System.ServiceModel.HttpBindingBase

System.ServiceModel.MsmqBindingBase

System.ServiceModel.NetNamedPipeBinding

System.ServiceModel.NetPeerTcpBinding

System.ServiceModel.NetTcpBinding

System.ServiceModel.UdpBinding

System.ServiceModel.UnixDomainSocketBinding

System.ServiceModel.WebHttpBinding

System.ServiceModel.WSDualHttpBinding

System.ServiceModel.WSHttpBindingBase

Implémente

IDefaultCommunicationTimeouts

Exemples

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

Remarques

Représente une collection d’éléments de liaison qui décrivent chacun un aspect de la façon dont un point de terminaison communique avec d’autres points de terminaison et qui sont générés de manière régulière dans une fabrique de canal sur le client et dans un écouteur de canal sur le service. Une liaison contient une collection d'éléments de liaison qui correspondent aux canaux de protocole, aux canaux de transport et aux encodeurs de message. Les canaux de protocole peuvent avoir n’importe quel nombre d’éléments de liaison, mais le transport et l’encodeur de message ne peuvent en avoir qu’un. Il y a généralement six couches d’éléments de liaison dans une liaison. Seuls les éléments de transport et d'encodage de liaison du bas de la pile sont requis. Étant donné qu’un encodage est requis pour chaque liaison, si aucun encodage n’est spécifié, Windows Communication Foundation (WCF) ajoute un encodage par défaut pour vous. La valeur par défaut est Text/XML pour les transports HTTP et HTTPS, et Binary pour les autres transports.

Le tableau suivant récapitule les options de chaque couche.

Couche	Options	Obligatoire
Flux de transaction	TransactionFlowBindingElement	Non
Fiabilité	ReliableSessionBindingElement	Non
Sécurité	Symétrique, asymétrique, au niveau du transport	Non
Modification de la forme	CompositeDuplexBindingElement	Non
Mises à niveau de transport	Flux SSL, flux Windows, programme de résolution d'homologue	Non
Encodage	Text, Binary, MTOM, Custom	Oui
Transport	TCP, Named Pipes, HTTP, HTTPS, MSMQ, Custom	Oui

Chaque élément de liaison fournit la spécification permettant de générer une fabrique de canal sur le client et un écouteur de canal sur le service. Une fois que la pile de fabriques de canaux est construite, par exemple, il existe une fabrique de canal dans la pile pour chaque élément de liaison dans la liaison. Le même type de mappage s'applique aux écouteurs de canal dans la pile sur le service. La cohérence sur le client et le service est primordiale à l'établissement d'une la connexion basée sur canal entre ces points de terminaison. Chaque fabrique et écouteur procèdent, à tour de rôle, à l'émission et l'acceptation des canaux correspondants dans la pile de canaux qui les connecte et ces canaux peuvent ensuite envoyer et recevoir les messages utilisés pour communiquer.

Chaque instance d'une classe Binding a une propriété Name et une propriété Namespace qui l'identifient de façon unique dans les métadonnées du service. Si aucun nom ou espace de noms n’est spécifié, WCF ajoute des valeurs par défaut pour vous. Le nom par défaut est null et l’espace de noms par défaut est http://tempuri.org/. Le nom d’utilisateur de cette liaison est différent de celui qui est précisé dans la spécification du nom de protocole, effectuée par la propriété Scheme. Si vous souhaitez ajouter plus de liaisons HTTP, par exemple, vous avez la possibilité de leur attribuer un nom de votre choix et de définir leurs modèles sur "http". Il n'existe pas d'application inhérente ou de répartition d'ordinateurs basées sur la propriété Scheme. Vous évitez ainsi le problème fréquent de ne pas pouvoir enregistrer de gestionnaires supplémentaires aux protocoles connus. Vous pouvez également facilement travailler côte à côte avec plusieurs versions différentes d’une même liaison en attribuant un nom différent à chacune d’entre elles.

La classe Binding implémente l'interface IDefaultCommunicationTimeouts afin de limiter les attaques par déni de service (DOS) qui monopolisent les ressources dans le but d'allonger les intervalles de temps. L'implémentation spécifie les valeurs des délais d'attente de communication pour l'ouverture et la fermeture des connexions et pour la lecture et l'écriture des opérations associées à la réception et l'envoi de messages. Les propriétés utilisées pour obtenir et définir ces délais d'attente ainsi que les opérations se basant sur leurs valeurs par défaut sont résumées dans le tableau suivant.

Propriété du délai d'attente	Valeur par défaut
OpenTimeout	1 minute
CloseTimeout	1 minute
SendTimeout	1 minute
ReceiveTimeout	10 minutes

Lorsque vous créez une liaison en héritant de l’objet Binding, vous devez remplacer la méthode CreateBindingElements.

De plus, vous pouvez définir vos propres éléments de liaison et les insérer entre chacune des couches définies dans le tableau précédent. Pour plus d'informations, consultez la classe CustomBinding.

Constructeurs

Binding()	Initialise une nouvelle instance de la classe Binding avec un nom et un espace de noms par défaut.
Binding(String, String)	Initialise une nouvelle instance de la classe Binding à partir d’une liaison spécifiée du service.

Propriétés

CloseTimeout	Obtient ou définit l'intervalle de temps attribué à une connexion pour qu'elle se ferme avant que le transport lève une exception.
MessageVersion	Obtient la version de message utilisée par les clients et les services configurés avec la liaison.
Name	Obtient ou définit le nom de la liaison.
Namespace	Obtient ou définit l’espace de noms XML de la liaison.
OpenTimeout	Obtient ou définit l'intervalle de temps attribué à une connexion pour qu'elle s'ouvre avant que le transport lève une exception.
ReceiveTimeout	Obtient ou définit la durée d’inactivité d’une connexion. Si aucun message d’application n’est reçu pendant ce laps de temps, la connexion est abandonnée.
Scheme	En cas d’implémentation dans une classe dérivée, définit le modèle URI qui spécifie le transport utilisé par les fabriques de canaux et d’écouteurs générées par les liaisons.
SendTimeout	Obtient ou définit l'intervalle de temps attribué à une opération d'écriture pour qu'elle se termine avant que le transport lève une exception.

Méthodes

BuildChannelFactory<TChannel>(BindingParameterCollection)	Génère la pile de fabriques de canaux sur le client qui crée un type de canal donné et est conforme aux fonctionnalités spécifiées par une collection de paramètres de liaison.
BuildChannelFactory<TChannel>(Object[])	Génère la pile de fabriques de canaux sur le client qui crée un type de canal donné et est conforme aux fonctionnalités spécifiées par un tableau d’objets.
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Retourne une valeur qui indique si la liaison actuelle peut générer sur le client une pile de fabriques de canaux conforme à la collection de paramètres de liaison spécifiée.
CanBuildChannelFactory<TChannel>(Object[])	Retourne une valeur qui indique si la liaison actuelle peut générer sur le client une pile de fabriques de canaux conforme aux exigences définies par un tableau d’objets.
CreateBindingElements()	Dans le cas d'un remplacement au sein d'une classe dérivée, crée une collection qui contient les éléments de liaison qui font partie de la liaison actuelle.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetProperty<T>(BindingParameterCollection)	Retourne un objet typé demandé (s’il existe) à partir de la couche appropriée dans la pile de liaison.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)