NetTcpBinding Classe

Definizione

Spazio dei nomi:

System.ServiceModel

Assembly:

System.ServiceModel.NetTcp.dll

Assembly:

System.ServiceModel.dll

Associazione protetta e affidabile adatta per le comunicazioni fra computer.

public ref class NetTcpBinding : System::ServiceModel::Channels::Binding

public ref class NetTcpBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences

public class NetTcpBinding : System.ServiceModel.Channels.Binding

public class NetTcpBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences

type NetTcpBinding = class
    inherit Binding

type NetTcpBinding = class
    inherit Binding
    interface IBindingRuntimePreferences

Public Class NetTcpBinding
Inherits Binding

Public Class NetTcpBinding
Inherits Binding
Implements IBindingRuntimePreferences

Ereditarietà

Object

Binding

NetTcpBinding

Derivato

System.ServiceModel.NetTcpContextBinding

Implementazioni

IBindingRuntimePreferences

Esempio

In questo esempio viene illustrato come creare un NetTcpBindingoggetto , impostando la modalità di sicurezza e il tipo di credenziale di trasporto.

NetTcpBinding binding = new NetTcpBinding();
binding.Security.Mode = SecurityMode.Transport;
binding.Security.Transport.ClientCredentialType = TcpClientCredentialType.Certificate;

Commenti

genera NetTcpBinding uno stack di comunicazione in fase di esecuzione per impostazione predefinita, che usa la sicurezza del trasporto, TCP per il recapito dei messaggi e una codifica di messaggi binari. Questa associazione è una scelta appropriata fornita dal sistema di Windows Communication Foundation (WCF) per la comunicazione tramite intranet.

La configurazione predefinita per è NetTcpBinding più veloce rispetto alla configurazione fornita da WSHttpBinding, ma è destinata solo alla comunicazione WCF. Il comportamento di sicurezza può essere configurato utilizzando il parametro facoltativo securityMode nel costruttore. L'utilizzo del protocollo WS-ReliableMessaging può essere configurato utilizzando il parametro facoltativo reliableSessionEnabled. La messaggistica affidabile è tuttavia disattivata per impostazione predefinita. Più in generale, le associazioni HTTP fornite dal sistema, ad esempio WSHttpBinding e BasicHttpBinding, sono configurate in modo da attivare modalità di supporto per impostazione predefinita, mentre l'associazione NetTcpBinding le disattiva per impostazione predefinita e pertanto è necessario fornire un consenso esplicito per ottenere il supporto, ad esempio, per una delle specifiche WS-*. Ciò significa che la configurazione predefinita per le associazioni TCP è più veloce nello scambio dei messaggi tra endpoint rispetto a quella predefinita per le associazioni HTTP.

Avviso

NetTcpBinding usa il pool di connessioni TCP in base al nome DNS host del servizio e al numero di porta su cui è in ascolto il servizio. Ciò funziona bene quando un client effettua chiamate a servizi diversi su porte diverse o i servizi sono ospitati in un singolo processo e condividono una porta. Se un singolo client chiama più servizi che condividono una porta ospitata in processi diversi o è ospitata da WAS/IIS, il pooling sul lato client può causare problemi in cui una connessione al servizio A viene riutilizzata per il servizio B, generando un'eccezione generata, la connessione interrotta e un nuovo canale creato. Per evitare questo problema, usare CustomBinding e specificare un valore ConnectionPoolSettings.GroupName diverso per ogni servizio con cui comunica il client.

Costruttori

NetTcpBinding()	Inizializza una nuova istanza della classe NetTcpBinding.
NetTcpBinding(SecurityMode)	Inizializza una nuova istanza della classe NetTcpBinding con il tipo specificato di sicurezza.
NetTcpBinding(SecurityMode, Boolean)	Inizializza una nuova istanza della classe NetTcpBinding con il tipo specificato di sicurezza e con un valore che indica se sono esplicitamente abilitate le sessioni affidabili.
NetTcpBinding(String)	Inizializza una nuova istanza della classe NetTcpBinding con un nome di configurazione specificato.

Proprietà

CloseTimeout	Ottiene o imposta l'intervallo di tempo fornito per la chiusura di una connessione prima che il trasporto generi un'eccezione. (Ereditato da Binding)
EnvelopeVersion	Consente di ottenere la versione di SOAP utilizzata per i messaggi elaborati da questa associazione.
HostNameComparisonMode	Ottiene o imposta un valore che indica se viene utilizzato il nome host per raggiungere il servizio in caso di corrispondenza dell'URI.
ListenBacklog	Ottiene o imposta il numero massimo di richieste di connessione in coda che possono essere in sospeso.
MaxBufferPoolSize	Ottiene o imposta la dimensione massima in byte consentita per un pool di buffer che archivia messaggi TCP elaborati dall'associazione.
MaxBufferSize	Ottiene o imposta un valore che specifica la dimensione massima, in byte, del buffer utilizzato per archiviare messaggi in memoria.
MaxConnections	Ottiene o imposta un valore che controlla il numero massimo di connessioni da inserire in un pool per il successivo riutilizzo nel client, nonché il numero massimo di connessioni consentite in attesa di invio nel server.
MaxReceivedMessageSize	Ottiene o imposta la dimensione massima in byte di un messaggio ricevuto che viene elaborato dall'associazione.
MessageVersion	Ottiene la versione del messaggio utilizzata dai client e dai servizi configurati con l'associazione. (Ereditato da Binding)
Name	Ottiene o imposta il nome dell'associazione. (Ereditato da Binding)
Namespace	Ottiene o imposta lo spazio dei nomi XML dell'associazione. (Ereditato da Binding)
OpenTimeout	Ottiene o imposta l'intervallo di tempo fornito per l'apertura di una connessione prima che il trasporto generi un'eccezione. (Ereditato da Binding)
PortSharingEnabled	Ottiene o imposta un valore che indica se è abilitata la condivisione delle porte TCP per la connessione configurata con questa associazione.
ReaderQuotas	Ottiene o imposta vincoli sulla complessità dei messaggi SOAP che possono essere elaborati dagli endpoint configurati con questa associazione.
ReceiveTimeout	Ottiene o imposta l'intervallo di tempo durante il quale una connessione rimane inattiva, senza ricevere messaggi dell'applicazione, prima di essere rilasciata. (Ereditato da Binding)
ReliableSession	Ottiene un oggetto che indica se viene stabilita una sessione affidabile tra gli endpoint del canale.
Scheme	Restituisce lo schema URI per il trasporto.
Security	Ottiene un oggetto che specifica il tipo di sicurezza utilizzato con i servizi configurati con questa associazione.
SendTimeout	Ottiene o imposta l'intervallo di tempo fornito per il completamento di un'operazione di scrittura prima che il trasporto generi un'eccezione. (Ereditato da Binding)
TransactionFlow	Ottiene o imposta un valore che determina se è abilitato il flusso delle transazioni.
TransactionProtocol	Ottiene o imposta il protocollo delle transazioni utilizzato dal servizio per il flusso delle transazioni.
TransferMode	Ottiene o imposta un valore che indica se il servizio configurato con l'associazione utilizza modalità di trasferimento messaggi con flusso o con memorizzazione nel buffer (o entrambe).

Metodi

BuildChannelFactory<TChannel>(BindingParameterCollection)	Compila lo stack della channel factory nel client che crea un tipo specificato di canale e che soddisfa le funzionalità specificate da una raccolta di parametri di associazione. (Ereditato da Binding)
BuildChannelFactory<TChannel>(Object[])	Compila lo stack della channel factory nel client che crea un tipo specificato di canale e che soddisfa le funzionalità specificate da una matrice di oggetti. (Ereditato da Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	Compila il listener del canale nel servizio che accetta un tipo specificato di canale e che soddisfa le funzionalità specificate da una raccolta di parametri di associazione. (Ereditato da Binding)
BuildChannelListener<TChannel>(Object[])	Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, Object[])	Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	Compila il listener del canale sul servizio che accetta un tipo di canale specificato e che presenta le funzionalità specificate. (Ereditato da Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Restituisce un valore che indica se l'associazione corrente può compilare uno stack della channel factory nel client che soddisfa la raccolta dei parametri di associazione specificati. (Ereditato da Binding)
CanBuildChannelFactory<TChannel>(Object[])	Restituisce un valore che indica se l'associazione corrente può compilare uno stack della channel factory nel client che soddisfa i requisiti specificati da una matrice di oggetti. (Ereditato da Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	Restituisce un valore che indica se l'associazione corrente può compilare uno stack del channel listener nel servizio che soddisfa la raccolta dei parametri di associazione specificati. (Ereditato da Binding)
CanBuildChannelListener<TChannel>(Object[])	Restituisce un valore che indica se l'associazione corrente può compilare uno stack del channel listener nel servizio che soddisfa i criteri specificati in una matrice di oggetti. (Ereditato da Binding)
CreateBindingElements()	Consente di creare una raccolta contenente gli elementi dell'associazione.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetProperty<T>(BindingParameterCollection)	Se presente, restituisce un oggetto tipizzato richiesto dal livello appropriato nello stack dell'associazione. (Ereditato da Binding)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ShouldSerializeListenBacklog()	Restituisce un valore che indica se la proprietà ListenBacklog è cambiata rispetto al valore predefinito e deve essere serializzata.
ShouldSerializeMaxConnections()	Restituisce un valore che indica se la proprietà MaxConnections è cambiata rispetto al valore predefinito e deve essere serializzata.
ShouldSerializeName()	Indica se il nome dell'associazione deve essere serializzato. (Ereditato da Binding)
ShouldSerializeNamespace()	Indica se lo spazio dei nomi dell'associazione deve essere serializzato. (Ereditato da Binding)
ShouldSerializeReaderQuotas()	Restituisce un valore che indica se la proprietà ReaderQuotas è cambiata rispetto al valore predefinito e deve essere serializzata.
ShouldSerializeReliableSession()	Restituisce un valore che indica se la proprietà ReliableSession è cambiata rispetto al valore predefinito e deve essere serializzata.
ShouldSerializeSecurity()	Restituisce un valore che indica se la proprietà Security è cambiata rispetto al valore predefinito e deve essere serializzata.
ShouldSerializeTransactionProtocol()	Restituisce un valore che indica se la proprietà TransactionProtocol è cambiata rispetto al valore predefinito e deve essere serializzata.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IBindingRuntimePreferences.ReceiveSynchronously

Ottiene un valore che indica se le richieste in entrata vengono gestite in modo sincrono o in modo asincrono.