NetTcpBinding Classe

Definizione

Spazio dei nomi:
System.ServiceModel
Assembly:
System.ServiceModel.dll, System.ServiceModel.NetTcp.dll
Assembly:
System.ServiceModel.NetTcp.dll
Assembly:
System.ServiceModel.dll
Pacchetti:
System.ServiceModel.NetTcp v10.0.652802, System.ServiceModel.Primitives v10.0.652802
Pacchetto:
System.ServiceModel.NetTcp v10.0.652802
Origine:
NetTcpBinding.cs
Origine:
NetTcpBinding.cs
Origine:
NetTcpBinding.cs

Associazione sicura e affidabile adatta per la comunicazione tra 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
Implementazioni
IBindingRuntimePreferences

Esempio

In questo esempio viene illustrato come creare un oggetto NetTcpBinding, 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

NetTcpBinding genera 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 di sistema di Windows Communication Foundation (WCF) appropriata per la comunicazione su una Intranet.

La configurazione predefinita per è NetTcpBinding più veloce rispetto alla configurazione fornita da WSHttpBinding, ma è destinata solo alla comunicazione WCF. Il comportamento di sicurezza è configurabile usando il parametro facoltativo securityMode nel costruttore. L'uso di WS-ReliableMessaging è configurabile usando il parametro facoltativo reliableSessionEnabled . Ma la messaggistica affidabile è disattivata per impostazione predefinita. Più in generale, le associazioni fornite dal sistema HTTP come WSHttpBinding e BasicHttpBinding sono configurate per attivare gli elementi per impostazione predefinita, mentre l'associazione NetTcpBinding disattiva le operazioni per impostazione predefinita in modo che sia necessario acconsentire esplicitamente per ottenere supporto, ad esempio per una delle specifiche WS-*. Ciò significa che la configurazione predefinita per TCP è più veloce allo scambio di messaggi tra endpoint rispetto a quelli configurati per le associazioni HTTP per impostazione predefinita.

Avvertimento

NetTcpBinding usa il pool di connessioni TCP in base al nome DNS host del servizio e al numero di porta su cui il servizio è in ascolto. 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 sono ospitati in WAS/IIS, il pooling sul lato client può causare problemi in cui viene riutilizzata una connessione al servizio A per il servizio B, generando un'eccezione, 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 il client comunica.

Costruttori

Nome Descrizione
NetTcpBinding()

Inizializza una nuova istanza della classe NetTcpBinding.
NetTcpBinding(SecurityMode, Boolean)

Inizializza una nuova istanza della NetTcpBinding classe con il tipo di sicurezza usato e con un valore che indica se le sessioni affidabili sono abilitate in modo esplicito.
NetTcpBinding(SecurityMode)

Inizializza una nuova istanza della NetTcpBinding classe con il tipo di sicurezza utilizzato specificato.
NetTcpBinding(String)

Inizializza una nuova istanza della NetTcpBinding classe con un nome di configurazione specificato.

Proprietà

Nome Descrizione
CloseTimeout

Ottiene o imposta l'intervallo di tempo specificato per la chiusura di una connessione prima che il trasporto generi un'eccezione.

(Ereditato da Binding)
EnvelopeVersion

Ottiene la versione di SOAP utilizzata per i messaggi elaborati da questa associazione.
HostNameComparisonMode

Ottiene o imposta un valore che indica se il nome host viene utilizzato per raggiungere il servizio quando corrisponde all'URI.
ListenBacklog

Ottiene o imposta il numero massimo di richieste di connessione in coda che possono essere in sospeso.
MaxBufferPoolSize

Ottiene o imposta le dimensioni massime, in byte, consentite per un pool di buffer che archivia i messaggi TCP elaborati dall'associazione.
MaxBufferSize

Ottiene o imposta un valore che specifica la dimensione massima, in byte, del buffer utilizzato per archiviare i messaggi in memoria.
MaxConnections

Ottiene o imposta un valore che controlla il numero massimo di connessioni da raggruppare per il successivo riutilizzo nel client e il numero massimo di connessioni consentite per l'invio in sospeso nel server.
MaxReceivedMessageSize

Ottiene o imposta le dimensioni massime, in byte, per un messaggio ricevuto 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 specificato 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 la condivisione delle porte TCP è abilitata 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 in cui una connessione può rimanere inattiva, durante la quale non vengono ricevuti messaggi dell'applicazione, prima che venga eliminata.

(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 specificato 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 il flusso della transazione è abilitato.
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 dei messaggi in streaming o memorizzate nel buffer (o in entrambi i casi).

Metodi

Nome Descrizione
BuildChannelFactory<TChannel>(BindingParameterCollection)

Compila lo stack channel factory nel client che crea un tipo di canale specificato e che soddisfa le funzionalità specificate da una raccolta di parametri di associazione.

(Ereditato da Binding)
BuildChannelFactory<TChannel>(Object[])

Compila lo stack channel factory nel client che crea un tipo di canale specificato 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 di canale specificato e che soddisfa le funzionalità specificate da una raccolta di parametri di associazione.

(Ereditato da Binding)
BuildChannelListener<TChannel>(Object[])

Compila il listener del canale nel servizio che accetta un tipo di canale specificato e che soddisfa le funzionalità specificate.

(Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Compila il listener del canale nel servizio che accetta un tipo di canale specificato e che soddisfa le funzionalità specificate.

(Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, Object[])

Compila il listener del canale nel servizio che accetta un tipo di canale specificato e che soddisfa le funzionalità specificate.

(Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Compila il listener del canale nel servizio che accetta un tipo di canale specificato e che soddisfa le funzionalità specificate.

(Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Compila il listener del canale nel servizio che accetta un tipo di canale specificato e che soddisfa le funzionalità specificate.

(Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Compila il listener del canale nel servizio che accetta un tipo di canale specificato e che soddisfa le funzionalità specificate.

(Ereditato da Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])

Compila il listener del canale nel servizio che accetta un tipo di canale specificato e che soddisfa le funzionalità specificate.

(Ereditato da Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)

Restituisce un valore che indica se l'associazione corrente può compilare uno stack channel factory nel client che soddisfa la raccolta di parametri di associazione specificati.

(Ereditato da Binding)
CanBuildChannelFactory<TChannel>(Object[])

Restituisce un valore che indica se l'associazione corrente può compilare uno stack 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 di listener del canale nel servizio che soddisfa la raccolta di parametri di associazione specificati.

(Ereditato da Binding)
CanBuildChannelListener<TChannel>(Object[])

Restituisce un valore che indica se l'associazione corrente può compilare uno stack di listener del canale nel servizio che soddisfa i criteri specificati in una matrice di oggetti.

(Ereditato da Binding)
CreateBindingElements()

Crea una raccolta con gli elementi di associazione per l'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)

Restituisce un oggetto tipizzato richiesto, se presente, dal livello appropriato nello stack di binding.

(Ereditato da Binding)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ShouldSerializeListenBacklog()

Restituisce un valore che indica se la ListenBacklog proprietà è stata modificata rispetto al valore predefinito e deve essere serializzata.
ShouldSerializeMaxConnections()

Restituisce un valore che indica se la MaxConnections proprietà è stata modificata rispetto al valore predefinito e deve essere serializzata.
ShouldSerializeName()

Restituisce un valore che indica se il nome dell'associazione deve essere serializzato.

(Ereditato da Binding)
ShouldSerializeNamespace()

Restituisce un valore che indica se lo spazio dei nomi dell'associazione deve essere serializzato.

(Ereditato da Binding)
ShouldSerializeReaderQuotas()

Restituisce un valore che indica se la ReaderQuotas proprietà è stata modificata rispetto al valore predefinito e deve essere serializzata.
ShouldSerializeReliableSession()

Restituisce un valore che indica se la ReliableSession proprietà è stata modificata rispetto al valore predefinito e deve essere serializzata.
ShouldSerializeSecurity()

Restituisce un valore che indica se la Security proprietà è stata modificata rispetto al valore predefinito e deve essere serializzata.
ShouldSerializeTransactionProtocol()

Restituisce un valore che indica se la TransactionProtocol proprietà è stata modificata rispetto al valore predefinito e deve essere serializzata.
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
IBindingRuntimePreferences.ReceiveSynchronously

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

Si applica a