NetTcpBinding Klasse

Referenz

Definition

Namespace:: System.ServiceModel

Assembly:: System.ServiceModel.NetTcp.dll

Assembly:: System.ServiceModel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Eine sichere, zuverlässige Bindung, die für die computerübergreifende Kommunikation geeignet ist.

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

Vererbung: Object

Binding
NetTcpBinding

Abgeleitet: System.ServiceModel.NetTcpContextBinding

Implementiert: IBindingRuntimePreferences

Beispiele

In diesem Beispiel wird gezeigt, wie Sie einen NetTcpBindingSicherheitsmodus und den Transportanmeldeinformationstyp festlegen.

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

Hinweise

Der NetTcpBinding Generiert standardmäßig einen Laufzeitkommunikationsstapel, der Transportsicherheit, TCP für die Nachrichtenübermittlung und eine binäre Nachrichtencodierung verwendet. Diese Bindung ist eine geeignete Windows Communication Foundation (WCF)-System, die für die Kommunikation über ein Intranet bereitgestellt wird.

Die Standardkonfiguration für die NetTcpBinding Konfiguration ist schneller als die von der WSHttpBinding, aber nur für WCF-Kommunikation vorgesehen. Das Sicherheitsverhalten kann mithilfe des optionalen securityMode-Parameters im Konstruktor konfiguriert werden. Die Verwendung von WS-ReliableMessaging ist mit dem optionalen reliableSessionEnabled-Parameter konfigurierbar. Zuverlässiges Messaging ist jedoch standardmäßig deaktiviert. Die vom System bereitgestellten HTTP-Bindungen, wie z. B. WSHttpBinding und BasicHttpBinding, sind im Allgemeinen so konfiguriert, dass Funktionen standardmäßig aktiviert werden ,während die NetTcpBinding-Bindung Funktionen standardmäßig deaktiviert, sodass Sie die Unterstützung für eine der WS-*-Spezifikationen explizit übernehmen müssen. Das bedeutet, dass die Standardkonfiguration für TCP Meldungen zwischen Endpunkten schneller austauscht als die standardmäßig für die HTTP-Bindungen festgelegte Konfiguration.

Warnung

Die NetTcpBinding Verwendung von TCP-Verbindungspooling basierend auf dem Host-DNS-Namen des Diensts und der Portnummer, auf der der Dienst überwacht wird. Dies funktioniert gut, wenn ein Client Anrufe an verschiedene Dienste auf verschiedenen Ports annimmt, oder Dienste in einem einzigen Prozess gehostet und einen Port freigeben. Wenn ein einzelner Client mehrere Dienste aufruft, die einen Port freigeben, der in verschiedenen Prozessen gehostet wird oder WAS/IIS gehostet wird, kann das clientseitige Pooling zu Problemen führen, bei denen eine Verbindung mit Service A für Service B wiederverwendet wird, was zu einer Ausnahme führt, die ausgelöst wird, die Verbindung abgebrochen und ein neuer Kanal erstellt wurde. Um dieses Problem zu vermeiden, verwenden Sie ein CustomBinding und geben Sie für jeden Dienst, mit dem der Client kommuniziert, einen anderen ConnectionPoolSettings.GroupName an.

Konstruktoren

NetTcpBinding()	Initialisiert eine neue Instanz der NetTcpBinding-Klasse.
NetTcpBinding(SecurityMode)	Initialisiert eine neue Instanz der NetTcpBinding-Klasse mit Angabe des verwendeten Sicherheitstyps.
NetTcpBinding(SecurityMode, Boolean)	Initialisiert eine neue Instanz der NetTcpBinding-Klasse mit dem angegebenen verwendeten Sicherheitstyp und einem Wert, der angibt, ob zuverlässige Sitzungen explizit aktiviert sind.
NetTcpBinding(String)	Initialisiert eine neue Instanz der NetTcpBinding-Klasse mit einem angegebenen Konfigurationsnamen.

Eigenschaften

CloseTimeout	Ruft das Zeitintervall ab, das für eine Verbindung eingerichtet ist, die geschlossen wird, bevor ein Transport eine Ausnahme auslöst, oder legt dieses fest. (Geerbt von Binding)
EnvelopeVersion	Ruft die SOAP-Version ab, die für Nachrichten verwendet wird, die von dieser Bindung verarbeitet werden.
HostNameComparisonMode	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Hostname zum Erreichen des Diensts bei übereinstimmendem URI verwendet werden soll.
ListenBacklog	Ruft die maximal mögliche Anzahl der ausstehenden Verbindungsanforderungen in der Warteschlange ab, oder legt diese fest.
MaxBufferPoolSize	Ruft die maximal zulässige Größe in Byte für einen Pufferpool ab, der TCP-Meldungen speichert, die von der Bindung verarbeitet werden, oder legt diese Größe fest.
MaxBufferSize	Ruft einen Wert ab oder legt einen Wert fest, der die maximale Größe (in Byte) des Puffers angibt, der zum Speichern von Meldungen im Arbeitsspeicher verwendet wird.
MaxConnections	Ruft einen Wert ab, der die maximale Anzahl an Verbindungen, die für die nachfolgende Wiederverwendung auf dem Client gepoolt werden sollen, und die maximale Anzahl an Verbindungen steuert, für die eine ausstehende Übermittlung auf dem Server zulässig ist.
MaxReceivedMessageSize	Ruft die maximale Größe in Byte für eine empfangene Nachricht ab, die von der Bindung verarbeitet wird, oder legt sie fest.
MessageVersion	Ruft die Nachrichtenversion ab, die von den Clients und Diensten verwendet wird, die mit der Bindung konfiguriert wurden. (Geerbt von Binding)
Name	Ruft den Namen der Bindung ab oder legt diesen fest. (Geerbt von Binding)
Namespace	Ruft den XML-Namespace einer Bindung ab oder legt diesen fest. (Geerbt von Binding)
OpenTimeout	Ruft das Zeitintervall ab, das für eine Verbindung eingerichtet ist, die geöffnet wird, bevor ein Transport eine Ausnahme auslöst, oder legt dieses fest. (Geerbt von Binding)
PortSharingEnabled	Ruft einen Wert ab, der angibt, ob die TCP-Portfreigabe für die mit dieser Bindung konfigurierte Verbindung aktiviert ist oder legt diesen Wert fest.
ReaderQuotas	Ruft Beschränkungen der Komplexität von SOAP-Meldungen ab, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert werden, oder legt die Beschränkungen fest.
ReceiveTimeout	Ruft ein Zeitintervall ab oder legt ein Zeitintervall fest, während dessen eine Verbindung inaktiv bleiben kann und keine Anwendungsnachrichten empfangen werden, bevor sie verworfen werden. (Geerbt von Binding)
ReliableSession	Ruft ein Objekt ab, das angibt, ob eine zuverlässige Sitzung zwischen Kanalendpunkten eingerichtet wird.
Scheme	Gibt das URI-Schema für die Übertragung zurück.
Security	Ruft ein Objekt ab, das den Sicherheitstyp angibt, der mit den mit dieser Bindung konfigurierten Diensten verwendet wird.
SendTimeout	Ruft das Zeitintervall ab, das für einen Schreibvorgang eingerichtet ist, der abgeschlossen wird, bevor ein Transport eine Ausnahme auslöst, oder legt dieses fest. (Geerbt von Binding)
TransactionFlow	Ruft einen Wert ab, mit dem bestimmt wird, ob der Transaktionsfluss aktiviert ist.
TransactionProtocol	Ruft vom Dienst für den Transaktionsfluss verwendete Transaktionsprotokolle ab oder legt sie fest.
TransferMode	Ruft einen Wert ab, der angibt, ob der mit der Bindung konfigurierte Dienst den Streaming- oder Puffermodus (oder beides) für die Nachrichtenübertragung einsetzt oder legt diesen Wert fest.

Methoden

BuildChannelFactory<TChannel>(BindingParameterCollection)	Erstellt den Kanalfactorystapel auf dem Client, der einen festgelegten Kanaltyp erstellt und der die Funktionen erfüllt, die von einer Auflistung von Bindungsparametern festgelegt werden. (Geerbt von Binding)
BuildChannelFactory<TChannel>(Object[])	Erstellt den Kanalfactorystapel auf dem Client, der einen festgelegten Kanaltyp erstellt und der die Funktionen erfüllt, die von einem Objektarray festgelegt werden. (Geerbt von Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die Funktionen erfüllt, die von einer Auflistung von Bindungsparametern festgelegt werden. (Geerbt von Binding)
BuildChannelListener<TChannel>(Object[])	Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, Object[])	Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	Erstellt den Kanallistener auf dem Dienst, der einen festgelegten Kanaltyp akzeptiert und der die festgelegten Funktionen erfüllt. (Geerbt von Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Kanalfactorystapel auf dem Client erstellen kann, der die Auflistung festgelegter Bindungsparameter erfüllt. (Geerbt von Binding)
CanBuildChannelFactory<TChannel>(Object[])	Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Kanalfactorystapel auf dem Client erstellen kann, der die von einem Objektarray festgelegten Anforderungen erfüllt. (Geerbt von Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Kanallistenerstapel auf dem Dienst erstellen kann, der die Auflistung festgelegter Bindungsparameter erfüllt. (Geerbt von Binding)
CanBuildChannelListener<TChannel>(Object[])	Gibt einen Wert zurück, der angibt, ob die aktuelle Bindung einen Kanallistenerstapel auf dem Dienst erstellen kann, der die in einem Objektarray festgelegten Kriterien erfüllt. (Geerbt von Binding)
CreateBindingElements()	Erstellt eine Auflistung mit den Bindungselementen für die Bindung.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetProperty<T>(BindingParameterCollection)	Gibt ggf. ein angefordertes typisiertes Objekt von der entsprechenden Ebene im Bindungsstapel zurück. (Geerbt von Binding)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ShouldSerializeListenBacklog()	Gibt einen Wert zurück, der angibt, ob die ListenBacklog-Eigenschaft ihren Standardwert geändert hat und serialisiert werden soll.
ShouldSerializeMaxConnections()	Gibt einen Wert zurück, der angibt, ob die MaxConnections-Eigenschaft ihren Standardwert geändert hat und serialisiert werden soll.
ShouldSerializeName()	Gibt einen Wert zurück, der angibt, ob der Name der Bindung serialisiert werden soll. (Geerbt von Binding)
ShouldSerializeNamespace()	Gibt einen Wert zurück, der angibt, ob der Namespace der Bindung serialisiert werden soll. (Geerbt von Binding)
ShouldSerializeReaderQuotas()	Gibt einen Wert zurück, der angibt, ob die ReaderQuotas-Eigenschaft ihren Standardwert geändert hat und serialisiert werden soll.
ShouldSerializeReliableSession()	Gibt einen Wert zurück, der angibt, ob die ReliableSession-Eigenschaft ihren Standardwert geändert hat und serialisiert werden soll.
ShouldSerializeSecurity()	Gibt einen Wert zurück, der angibt, ob die Security-Eigenschaft ihren Standardwert geändert hat und serialisiert werden soll.
ShouldSerializeTransactionProtocol()	Gibt einen Wert zurück, der angibt, ob die TransactionProtocol-Eigenschaft ihren Standardwert geändert hat und serialisiert werden soll.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IBindingRuntimePreferences.ReceiveSynchronously

Ruft einen Wert ab, der angibt, ob eingehende Anforderungen synchron oder asynchron gehandhabt werden.

Gilt für