<netNamedPipeBinding>

Article
09/12/2008

Définit une liaison qui est sécurisée, fiable, optimisée pour la communication interprocessus sur l'ordinateur. Par défaut, elle génère une pile de communication du runtime avec WS-ReliableMessaging pour la fiabilité, la sécurité du transport pour la sécurité du transfert, des canaux nommés pour la remise de messages et le codage binaire de messages.

<system.serviceModel>
<bindings>
<netNamedPipeBinding>

<netNamedPipeBinding>
   <binding 
      closeTimeout="TimeSpan"
      hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
      maxBufferPoolSize="Integer"
      maxBufferSize="Integer"
      maxConnections="Integer" 
      maxReceivedMessageSize="Integer"
            name="string"
      openTimeout="TimeSpan" 
      receiveTimeout="TimeSpan"
      sendTimeout="TimeSpan"
      transactionFlow="Boolean"
      transactionProtocol="OleTransactions/WS-AtomicTransactionOctober2004"
            transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
      <security mode="None/Transport">
            <transport clientCredentialType="None/Windows"
                protectionLevel="None/Sign/EncryptAndSign" />
      </security>
      <readerQuotas maxDepth="integer" 
            maxStringContentLength="integer"
            maxByteArrayContentLength="integer"
            maxBytesPerRead="integer"
            maxNameTableCharCount="integer" />
   </binding>
</netNamedPipeBinding>

Attributs et éléments

Attributs

Attribut	Description
closeTimeout	Valeur TimeSpan qui spécifie l'intervalle de temps prévu pour qu'une opération de fermeture s'effectue. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
hostnameComparisonMode	Spécifie le mode de comparaison du nom d'hôte HTTP utilisé pour analyser des URI. Cet attribut est de type HostnameComparisonMode, ce qui indique si le nom d'hôte est utilisé pour atteindre le service en cas de correspondance sur l'URI. La valeur par défaut est StrongWildcard, qui ignore le nom d'hôte dans la correspondance.
maxBufferPoolSize	Entier qui spécifie la taille maximale du pool de mémoires tampons pour cette liaison. La valeur par défaut est 524 288 octets (512 x 1024). De nombreuses parties de Windows Communication Foundation (WCF) utilisent des mémoires tampons. La création et la destruction des mémoires tampons à chaque utilisation sont chères, tout comme leur nettoyage. Avec les pools de mémoires tampons, vous pouvez prendre une mémoire tampon du pool, l'utiliser et la renvoyer dans le pool une fois que vous avez terminé. Ainsi, la surcharge occasionnée par la création et la destruction des mémoires tampons est évitée.
maxBufferSize	Entier positif qui spécifie la taille maximale, en octets, de la mémoire tampon utilisée pour stocker des messages en mémoire. Si la mémoire tampon est pleine, les données excédentaires restent dans le socket sous-jacent jusqu'à ce que de l'espace soit disponible dans la mémoire tampon. Cette valeur ne peut pas être inférieure à l'attribut maxReceivedMessageSize. La valeur par défaut est 65 536. Pour plus d'informations, consultez MaxBufferSize.
maxConnections	Entier qui spécifie le nombre maximal de connexions sortantes et entrantes que le service créera/acceptera. Les connexions entrantes et sortantes sont comptées par rapport à une limite distincte spécifiée par cet attribut. Les connexions entrantes dépassant cette limite sont mises en file d'attente jusqu'à ce qu'un espace sous la limite soit disponible. Les connexions sortantes dépassant cette limite sont mises en file d'attente jusqu'à ce qu'un espace sous la limite soit disponible. La valeur par défaut est 10.
maxReceivedMessageSize	Entier positif qui spécifie la taille maximale du message, en octets, y compris les en-têtes, pouvant être reçu sur un canal configuré avec cette liaison. L'expéditeur d'un message qui dépasse cette limite se verra notifier une erreur SOAP. Le récepteur abandonne le message et crée une entrée d'événement dans le journal de suivi. La valeur par défaut est 65 536.
name	Chaîne qui contient le nom de configuration de la liaison. Cette valeur doit être unique car elle permet d'identifier la liaison.
openTimeout	Valeur TimeSpan qui spécifie l'intervalle de temps prévu pour qu'une opération d'ouverture s'effectue. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
receiveTimeout	Valeur TimeSpan qui spécifie l'intervalle de temps prévu pour qu'une opération de réception s'effectue. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:10:00.
sendTimeout	Valeur TimeSpan qui spécifie l'intervalle de temps prévu pour qu'une opération d'envoi s'effectue. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
transactionFlow	Valeur booléenne qui spécifie si la liaison prend en charge le flux WS-Transactions. La valeur par défaut est false.
transactionProtocol	Spécifie le protocole de transaction à utiliser avec cette liaison. Les valeurs valides sont : OleTransactions WS-AtomicTransactionOctober2004 La valeur par défaut est OleTransactions. Cet attribut est de type TransactionProtocol.
transferMode	Valeur TransferMode qui spécifie si les messages sont mis en mémoire tampon ou transmis en continu ou s'il s'agit d'une demande ou d'une réponse.

Éléments enfants

Élément	Description
<security> de <netNamedPipeBinding>	Définit les paramètres de sécurité de la liaison. Cet élément est de type NetNamedPipeBindingElement.
<readerQuotas>	Définit les contraintes de la complexité des messages SOAP qui peuvent être traités par les points de terminaison configurés avec cette liaison. Cet élément est de type XmlDictionaryReaderQuotasElement.

Éléments parents

Élément	Description
<bindings>	Cet élément conserve une collection de liaisons standard et personnalisées. Chaque entrée est identifiée par son name. Les services utilisent les liaisons en les liant à l'aide du name.

Notes

NetNamedPipeBinding génère une pile de communication au moment de l'exécution par défaut, qui utilise la sécurité de transport, des canaux nommés pour la remise des messages et un codage de message binaire. Cette liaison est une solution fournie par le système WCF (Windows Communication Foundation) adaptée à la communication sur les ordinateurs. Elle prend en outre en charge des 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. La différence la plus notable est que le paramètre securityMode offre uniquement les options None et Transport. La prise en charge de la sécurité SOAP ne fait pas partie des options incluses. Le comportement de sécurité est configurable à l'aide de l'attribut facultatif securityMode.

Exemple

L'exemple suivant montre la liaison netNamedPipeBinding, qui fournit la communication interprocessus sur le même ordinateur. Les canaux nommés ne fonctionnent pas à travers des ordinateurs.

La liaison est spécifiée dans les fichiers de configuration pour le client et le service. Le type de liaison est spécifié dans l'attribut binding de l'élément <endpoint>. Si vous souhaitez configurer la liaison netNamedPipeBinding et modifier quelques-uns de ses paramètres, vous devez définir une configuration de liaison. Le point de terminaison doit référencer la configuration de liaison par nom avec un attribut bindingConfiguration. Dans cet exemple, la configuration de liaison est nommée Binding1.

<configuration>
  <system.serviceModel>
    <services>
      <service name="Microsoft.ServiceModel.Samples.CalculatorService"
               behaviorConfiguration="CalculatorServiceBehavior">
        <host>
          <baseAddresses>
            <add baseAddress="https://localhost:8000/ServiceModelSamples/service"/>
          </baseAddresses>
        </host>
        <!-- this endpoint is exposed at the base address provided by host: net.pipe://localhost/ServiceModelSamples/service  -->
        <endpoint address="net.pipe://localhost/ServiceModelSamples/service"
                  binding="netNamedPipeBinding"
                  bindingConfiguration="Binding1" 
                  contract="Microsoft.ServiceModel.Samples.ICalculator" />
        <!-- the mex endpoint is exposed at https://localhost:8000/ServiceModelSamples/service/mex -->
        <endpoint address="mex"
                  binding="mexHttpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>

    <bindings>
      <netNamedPipeBinding>
        <binding name="Binding1" 
                 closeTimeout="00:01:00"
                 openTimeout="00:01:00" 
                 receiveTimeout="00:10:00" 
                 sendTimeout="00:01:00"
                 transactionFlow="false" 
                 transferMode="Buffered" 
                 transactionProtocol="OleTransactions"
                 hostNameComparisonMode="StrongWildcard" 
                 maxBufferPoolSize="524288"
                 maxBufferSize="65536" 
                 maxConnections="10" 
                 maxReceivedMessageSize="65536">
          <security mode="Transport">
            <transport protectionLevel="EncryptAndSign" />
          </security>
        </binding>
      </netNamedPipeBinding>
    </bindings>

    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->
    <behaviors>
      <serviceBehaviors>
        <behavior name="CalculatorServiceBehavior">
          <serviceMetadata httpGetEnabled="True"/>
          <serviceDebug includeExceptionDetailInFaults="False" />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

Voir aussi

Référence

NetNamedPipeBindingElement
NetNamedPipeBinding

Concepts

Autres ressources

Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients