NetNamedPipeBinding NetNamedPipeBinding NetNamedPipeBinding NetNamedPipeBinding Class

Définition

Fournit une liaison sécurisée et fiable, optimisée pour la communication sur l’ordinateur.Provides a secure and reliable binding that is optimized for on-machine communication.

public ref class NetNamedPipeBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences
public class NetNamedPipeBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences
type NetNamedPipeBinding = class
    inherit Binding
    interface IBindingRuntimePreferences
Public Class NetNamedPipeBinding
Inherits Binding
Implements IBindingRuntimePreferences
Héritage
NetNamedPipeBindingNetNamedPipeBindingNetNamedPipeBindingNetNamedPipeBinding
Implémente

Exemples

L'exemple suivant montre la partie du fichier de configuration qui contient la section réservée à la NetNamedPipeBinding avec les valeurs par défaut définies.The following example shows the part of the configuration file that contains the section for the NetNamedPipeBinding with values set to defaults.

L'exemple suivant montre comment utiliser la classe NetNamedPipeBinding par programme.The following example shows how to programmatically use the NetNamedPipeBinding class.

   [ServiceContract(Namespace = "http://UE.Samples")]
   public interface ICalculator
   {
       [OperationContract]
       double Add(double n1, double n2);
   }

   // Service class which implements the service contract.
   public class CalculatorService : ICalculator
   {
       public double Add(double n1, double n2)
       {
           return n1 + n2;
       }

       public static void Main()
       {
           Uri baseAddress = new Uri("http://localhost:8000/uesamples/service");
           string address = "net.pipe://localhost/uesamples/calc";

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

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

	long maxBufferPoolSize = binding.MaxBufferPoolSize;

	int maxBufferSize = binding.MaxBufferSize;

	int maxConnections = binding.MaxConnections;

	long maxReceivedMessageSize =
	    binding.MaxReceivedMessageSize;

	NetNamedPipeSecurity security = binding.Security;

	string scheme = binding.Scheme;

	XmlDictionaryReaderQuotas readerQuotas =
		binding.ReaderQuotas;

	BindingElementCollection bCollection = binding.CreateBindingElements();

	HostNameComparisonMode hostNameComparisonMode =
		binding.HostNameComparisonMode;

	bool TransactionFlow = binding.TransactionFlow;

	TransactionProtocol transactionProtocol =
		binding.TransactionProtocol;

	EnvelopeVersion envelopeVersion =
		binding.EnvelopeVersion;

	TransferMode transferMode =
		binding.TransferMode;


			
               serviceHost.Open();
       
               Console.WriteLine("The service is ready.");
               Console.WriteLine("Press <ENTER> to terminate service.");
               Console.WriteLine();
               Console.ReadLine();

               serviceHost.Close();
           }
       }

static void SnippetReceiveSynchronously ()
{

	NetNamedPipeBinding binding = new NetNamedPipeBinding();
	IBindingRuntimePreferences s  =
	       binding.GetProperty<IBindingRuntimePreferences>
	       (new BindingParameterCollection());
	bool receiveSynchronously = s.ReceiveSynchronously;


}
   }

Remarques

NetNamedPipeBinding génère par défaut une pile de communication au moment de l'exécution, qui utilise la sécurité de transport, des canaux nommés pour la remise des messages et un encodage de message binaire.The NetNamedPipeBinding generates a run-time communication stack by default, which uses transport security, named pipes for message delivery, and a binary message encoding. Cette liaison est une solution fournie par le système WCF (Windows Communication Foundation) adaptée à la communication sur les ordinateurs.This binding is an appropriate Windows Communication Foundation (WCF) system-provided choice for on-machine communication. Elle prend en outre en charge des transactions.It also supports transactions.

La configuration par défaut de NetNamedPipeBinding est similaire à celle fournie par NetTcpBinding, mais en plus simple, car l'implémentation de WCF est uniquement destinée à être utilisée sur un ordinateur, de sorte qu'il y a moins de fonctionnalités exposées.The default configuration for the NetNamedPipeBinding is similar to the configuration provided by the NetTcpBinding, but it is simpler because the WCF implementation is only meant for on-machine use and consequently there are fewer exposed features. La différence la plus notable est que le paramètre SecurityMode offre uniquement les options None et Transport.The most notable difference is that the SecurityMode setting only offers the None and Transport options. La prise en charge de la sécurité SOAP ne fait pas partie des options incluses.SOAP security support is not an included option. Le comportement de sécurité est configurable à l'aide du paramètre securityMode en option dans le constructeur NetNamedPipeBinding(NetNamedPipeSecurityMode).The security behavior is configurable using the optional securityMode parameter in NetNamedPipeBinding(NetNamedPipeSecurityMode) the constructor.

Constructeurs

NetNamedPipeBinding() NetNamedPipeBinding() NetNamedPipeBinding() NetNamedPipeBinding()

Initialise une nouvelle instance de la classe NetNamedPipeBinding.Initializes a new instance of the NetNamedPipeBinding class.

NetNamedPipeBinding(NetNamedPipeSecurityMode) NetNamedPipeBinding(NetNamedPipeSecurityMode) NetNamedPipeBinding(NetNamedPipeSecurityMode) NetNamedPipeBinding(NetNamedPipeSecurityMode)

Initialise une nouvelle instance de la classe NetNamedPipeBinding avec le mode de sécurité spécifié.Initializes a new instance of the NetNamedPipeBinding class with a specified security mode.

NetNamedPipeBinding(String) NetNamedPipeBinding(String) NetNamedPipeBinding(String) NetNamedPipeBinding(String)

Initialise une nouvelle instance de la classe NetNamedPipeBinding disposant d'un nom de configuration spécifié.Initializes a new instance of the NetNamedPipeBinding class with a specified configuration name.

Propriétés

CloseTimeout CloseTimeout CloseTimeout 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.Gets or sets the interval of time provided for a connection to close before the transport raises an exception.

(Inherited from Binding)
EnvelopeVersion EnvelopeVersion EnvelopeVersion EnvelopeVersion

Obtient la version de SOAP utilisée pour les messages traités par cette liaison.Gets the version of SOAP that is used for messages processed by this binding.

HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode

Obtient ou définit une valeur qui indique si le nom d'hôte est utilisé pour atteindre le service lors de la correspondance avec l'URI.Gets or sets a value that indicates whether the hostname is used to reach the service when matching the URI.

MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize

Obtient ou définit le nombre maximal d'octets utilisés pour la mise en mémoire tampon des messages entrants.Gets or sets the maximum number of bytes that are used to buffer incoming messages in memory.

MaxBufferSize MaxBufferSize MaxBufferSize MaxBufferSize

Obtient ou définit le nombre maximal d'octets utilisés pour la mise en mémoire tampon des messages entrants.Gets or sets the maximum number of bytes used to buffer incoming messages in memory.

MaxConnections MaxConnections MaxConnections MaxConnections

Obtient ou définit le nombre maximal de connexions, entrantes et sortantes, autorisées aux points de terminaison configurés avec la liaison de canal nommé.Gets or sets the maximum number of connections, both inbound and outbound, that are allowed to endpoints configured with the named pipe binding.

MaxReceivedMessageSize MaxReceivedMessageSize MaxReceivedMessageSize MaxReceivedMessageSize

Obtient ou définit la taille maximale (en octets) d'un message reçu qui est traité par la liaison.Gets or sets the maximum size, in bytes, for a received message that is processed by the binding.

MessageVersion MessageVersion MessageVersion MessageVersion

Obtient la version de message utilisée par les clients et les services configurés avec la liaison.Gets the message version used by clients and services configured with the binding.

(Inherited from Binding)
Name Name Name Name

Obtient ou définit le nom de la liaison.Gets or sets the name of the binding.

(Inherited from Binding)
Namespace Namespace Namespace Namespace

Obtient ou définit l'espace de noms XML de la liaison.Gets or sets the XML namespace of the binding.

(Inherited from Binding)
OpenTimeout OpenTimeout OpenTimeout 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.Gets or sets the interval of time provided for a connection to open before the transport raises an exception.

(Inherited from Binding)
ReaderQuotas ReaderQuotas ReaderQuotas ReaderQuotas

Obtient ou définit des contraintes sur la complexité des messages SOAP qui peuvent être traités par les points de terminaison configurés avec cette liaison.Gets or sets constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

ReceiveTimeout ReceiveTimeout ReceiveTimeout 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.Gets or sets the interval of time that a connection can remain inactive, during which no application messages are received, before it is dropped.

(Inherited from Binding)
Scheme Scheme Scheme Scheme

Obtient le schéma de transport URI pour les canaux et les écouteurs configurés avec cette liaison.Gets the URI transport scheme for the channels and listeners that are configured with this binding.

Security Security Security Security

Obtient un objet qui spécifie le type de sécurité utilisé avec les services configurés avec cette liaison.Gets an object that specifies the type of security used with services configured with this binding.

SendTimeout SendTimeout SendTimeout 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.Gets or sets the interval of time provided for a write operation to complete before the transport raises an exception.

(Inherited from Binding)
TransactionFlow TransactionFlow TransactionFlow TransactionFlow

Obtient ou définit une valeur qui détermine si des transactions doivent être passées au service.Gets or sets a value that determines whether transactions should be flowed to the service.

TransactionProtocol TransactionProtocol TransactionProtocol TransactionProtocol

Obtient ou définit le protocole de transactions utilisé par le service pour transférer des transactions.Gets or sets the transactions protocol used by the service to flow transactions.

TransferMode TransferMode TransferMode TransferMode

Obtient ou définit une valeur qui indique si le service configuré avec la liaison utilise le mode de transfert de messages en continu (dans une direction ou les deux) ou en mémoire tampon.Gets or sets a value that indicates whether the service configured with the binding uses streamed (in one or both directions) or buffered modes of message transfer.

Méthodes

BuildChannelFactory<TChannel>(BindingParameterCollection) BuildChannelFactory<TChannel>(BindingParameterCollection) BuildChannelFactory<TChannel>(BindingParameterCollection) 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.Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Inherited from Binding)
BuildChannelFactory<TChannel>(Object[]) BuildChannelFactory<TChannel>(Object[]) BuildChannelFactory<TChannel>(Object[]) 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.Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by an object array.

(Inherited from Binding)
BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection)

Génère l'écouteur de canal sur le service qui accepte un type de canal donné et est conforme aux fonctionnalités spécifiées par une collection de paramètres de liaison.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Inherited from Binding)
BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[])

Génère l’écouteur de canal sur le service qui accepte un type de canal donné et est conforme aux fonctionnalités spécifiées.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Génère l’écouteur de canal sur le service qui accepte un type de canal donné et est conforme aux fonctionnalités spécifiées.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[])

Génère l’écouteur de canal sur le service qui accepte un type de canal donné et est conforme aux fonctionnalités spécifiées.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Génère l’écouteur de canal sur le service qui accepte un type de canal donné et est conforme aux fonctionnalités spécifiées.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Génère l’écouteur de canal sur le service qui accepte un type de canal donné et est conforme aux fonctionnalités spécifiées.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Génère l’écouteur de canal sur le service qui accepte un type de canal donné et est conforme aux fonctionnalités spécifiées.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[])

Génère l’écouteur de canal sur le service qui accepte un type de canal donné et est conforme aux fonctionnalités spécifiées.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection) CanBuildChannelFactory<TChannel>(BindingParameterCollection) CanBuildChannelFactory<TChannel>(BindingParameterCollection) 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.Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the collection of binding parameters specified.

(Inherited from Binding)
CanBuildChannelFactory<TChannel>(Object[]) CanBuildChannelFactory<TChannel>(Object[]) CanBuildChannelFactory<TChannel>(Object[]) 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.Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the requirements specified by an object array.

(Inherited from Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection)

Retourne une valeur qui indique si la liaison actuelle peut générer sur le service une pile d’écouteurs de canal conforme à la collection de paramètres de liaison spécifiée.Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the collection of binding parameters specified.

(Inherited from Binding)
CanBuildChannelListener<TChannel>(Object[]) CanBuildChannelListener<TChannel>(Object[]) CanBuildChannelListener<TChannel>(Object[]) CanBuildChannelListener<TChannel>(Object[])

Retourne une valeur qui indique si la liaison actuelle peut générer sur le service une pile d’écouteurs de canal conforme aux critères spécifiés dans un tableau d’objets.Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the criteria specified in an array of objects.

(Inherited from Binding)
CreateBindingElements() CreateBindingElements() CreateBindingElements() CreateBindingElements()

Crée une collection avec les éléments de liaison pour la liaison.Creates a collection with the binding elements for the binding.

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

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection)

Retourne un objet typé demandé (s’il existe) à partir de la couche appropriée dans la pile de liaison.Returns a typed object requested, if present, from the appropriate layer in the binding stack.

(Inherited from Binding)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ShouldSerializeMaxConnections() ShouldSerializeMaxConnections() ShouldSerializeMaxConnections() ShouldSerializeMaxConnections()

Retourne une valeur qui indique si la propriété MaxConnections utilise une autre valeur que sa valeur par défaut et doit être sérialisée.Returns a value that indicates whether the MaxConnections property has changed from its default value and should be serialized.

ShouldSerializeName() ShouldSerializeName() ShouldSerializeName() ShouldSerializeName()

Retourne une valeur indiquant si le nom de la liaison doit être sérialisé.Returns whether the name of the binding should be serialized.

(Inherited from Binding)
ShouldSerializeNamespace() ShouldSerializeNamespace() ShouldSerializeNamespace() ShouldSerializeNamespace()

Retourne une valeur indiquant si l'espace de noms de la liaison doit être sérialisé.Returns whether the namespace of the binding should be serialized.

(Inherited from Binding)
ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas()

Retourne une valeur qui indique si la propriété ReaderQuotas utilise une autre valeur que sa valeur par défaut et doit être sérialisée.Returns a value that indicates whether the ReaderQuotas property has changed from its default value and should be serialized. Ceci est utilisé par WCF pour l'intégration XAML.This is used by WCF for XAML integration.

ShouldSerializeSecurity() ShouldSerializeSecurity() ShouldSerializeSecurity() ShouldSerializeSecurity()

Retourne une valeur qui indique si la propriété Security utilise une autre valeur que sa valeur par défaut et doit être sérialisée.Returns a value that indicates whether the Security property has changed from its default value and should be serialized. Ceci est utilisé par WCF pour l'intégration XAML.This is used by WCF for XAML integration.

ShouldSerializeTransactionProtocol() ShouldSerializeTransactionProtocol() ShouldSerializeTransactionProtocol() ShouldSerializeTransactionProtocol()

Retourne une valeur qui indique si la propriété TransactionProtocol utilise une autre valeur que sa valeur par défaut et doit être sérialisée.Returns a value that indicates whether the TransactionProtocol property has changed from its default value and should be serialized. Ceci est utilisé par WCF pour l'intégration XAML.This is used by WCF for XAML integration.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Implémentations d’interfaces explicites

IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously

Obtient une valeur qui indique si les demandes entrantes sont gérées de façon synchrone ou asynchrone.Gets a value that indicates whether incoming requests are handled synchronously or asynchronously.

S’applique à