<AssociazioneNetTcpPeer>

Articolo
09/12/2008

Definisce un'associazione per la messaggistica TCP specifica del canale peer.

<system.serviceModel>
<bindings>
<AssociazioneNetTcpPeer>

<netPeerBinding>
    <binding name="string"
         closeTimeout="TimeSpan"
         openTimeout="TimeSpan" 
         receiveTimeout="TimeSpan"
         sendTimeout="TimeSpan"
         listenIPAddress="String"
          maxBufferPoolSize="integer"
         maxReceiveMessageSize="Integer" 
         port="Integer"
         <security mode="None/Transport/Message/TransportWithMessageCredential">
            <transport credentialType="Certificate/Password" />
        </security>
    </binding>
</netPeerBinding>

Attributi ed elementi

Attributi

Attributo	Descrizione
closeTimeout	Valore TimeSpan che specifica l'intervallo di tempo fornito per il completamento di un'operazione di chiusura. Questo valore deve essere maggiore o uguale a Zero. L'impostazione predefinita è 00:01:00.
listenIPAddress	Stringa che specifica l'indirizzo IP utilizzato dal nodo peer per l'ascolto dei messaggi TCP. L'impostazione predefinita è null.
maxBufferPoolSize	Numero intero che specifica la dimensione del pool di buffer massima per questa associazione. Il valore predefinito è 524.288 byte (512 * 1024). Molte parti di Windows Communication Foundation (WCF) utilizzano buffer. La creazione e l'eliminazione dei buffer a ogni loro utilizzo sono operazioni onerose, come anche le procedure di Garbage Collection dei buffer. Quando si utilizza un pool di buffer è possibile prelevare un buffer dal pool, utilizzarlo e, al termine delle operazioni, riporlo nel pool. In questo modo è possibile evitare il sovraccarico dovuto alla creazione e all'eliminazione dei buffer.
maxReceivedMessageSize	Numero intero positivo che specifica la dimensione massima del messaggio, incluse le intestazioni, che può essere ricevuto in canale configurato con questa associazione. Il mittente di un messaggio che supera questo limite riceverà un errore SOAP. Il destinatario elimina il messaggio e crea una voce dell'evento nel registro di traccia. L'impostazione predefinita è 65.536.
name	Stringa che contiene il nome della configurazione dell'associazione. Questo valore deve essere univoco perché viene utilizzato per identificare l'associazione.
openTimeout	Valore TimeSpan che specifica l'intervallo di tempo fornito per il completamento di un'operazione di apertura. Questo valore deve essere maggiore o uguale a Zero. L'impostazione predefinita è 00:01:00.
port	Numero intero che specifica la porta dell'interfaccia di rete utilizzata dall'associazione per elaborare i messaggi TCP del canale peer. Il valore deve essere compreso tra MinPort e MaxPort. L'impostazione predefinita è 0.
receiveTimeout	Valore TimeSpan che specifica l'intervallo di tempo fornito per il completamento di un'operazione di ricezione. Questo valore deve essere maggiore o uguale a Zero. L'impostazione predefinita è 00:10:00.
sendTimeout	Valore TimeSpan che specifica l'intervallo di tempo fornito per il completamento di un'operazione di invio. Questo valore deve essere maggiore o uguale a Zero. L'impostazione predefinita è 00:01:00.

Elementi figlio

Elemento	Descrizione
<quoteReader>	Definisce i vincoli sulla complessità dei messaggi SOAP che possono essere elaborati dagli endpoint configurati con questa associazione. L'elemento è di tipo XmlDictionaryReaderQuotasElement.
<resolver>	Specifica un resolver peer utilizzato dall'associazione per risolvere un ID di rete peer negli indirizzi endpoint dei nodi appartenenti alla rete di peer.
<security> di <netPeerBinding>	Definisce le impostazioni di protezione per il messaggio. L'elemento è di tipo PeerSecurityElement.

Elementi padre

Elemento	Descrizione
<bindings>	Questo elemento contiene un insieme di associazioni standard e personalizzate. Ciascuna voce è identificata dal relativo name. I servizi utilizzano le associazioni collegandole mediante il name.

Osservazioni

Questa associazione fornisce il supporto per la creazione di applicazioni peer-to-peer o a più parti utilizzando il trasporto peer su TCP. Ogni istanza di può ospitare più canali del peer definiti con questo tipo di associazione.

Esempio

Nell'esempio seguente è dimostrato l'utilizzo dell'associazione NetPeerTcpBinding, il quale fornisce comunicazione a più parti utilizzando un canale peer. Per uno scenario dettagliato dell'utilizzo di questa associazione, vedere Net Peer TCP.

<configuration>
<system.ServiceModel>
<bindings>
<netPeerBinding>
    <binding name="test"
         closeTimeout="00:00:10"
         openTimeout="00:00:20" 
         receiveTimeout="00:00:30"
         sendTimeout="00:00:40"
         maxBufferSize="1001"
         maxConnections="123" 
         maxReceiveMessageSize="1000">
        <reliableSession ordered="false"
            inactivityTimeout="00:02:00"
            enabled="true" />
        <security mode="TransportWithMessageCredential">
            <message clientCredentialType="CardSpace" />
        </security>
    </binding>
</netPeerBinding>
</bindings>
</system.ServiceModel>
</configuration>

Vedere anche

Riferimenti

NetPeerTcpBinding
NetPeerTcpBindingElement

Concetti

Altre risorse

Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients
Net Peer TCP
Peer-to-Peer Networking

Condividi tramite