NetTcpBinding Klasse

Referenz

Definition

Namespace:: System.ServiceModel

Assembly:: System.ServiceModel.NetTcp.dll

Assembly:: System.ServiceModel.dll

Paket:: System.ServiceModel.NetTcp v8.0.0

Quelle:: NetTcpBinding.cs

Quelle:: NetTcpBinding.cs

Quelle:: NetTcpBinding.cs

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 maschinenü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 eine NetTcpBindingerstellen, den Sicherheitsmodus und den Transportanmeldeinformationstyp festlegen.

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

Hinweise

Die 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)-Systemoption für die Kommunikation über ein Intranet.

Die Standardkonfiguration für die NetTcpBinding ist schneller als die vom WSHttpBindingbereitgestellte Konfiguration, ist jedoch nur für die WCF-Kommunikation vorgesehen. Das Sicherheitsverhalten kann mithilfe des optionalen securityMode Parameters im Konstruktor konfiguriert werden. Die Verwendung von WS-ReliableMessaging kann mithilfe des optionalen reliableSessionEnabled Parameters konfiguriert werden. Zuverlässige Nachrichten sind jedoch standardmäßig deaktiviert. Im Allgemeinen sind die vom HTTP-System bereitgestellten Bindungen wie WSHttpBinding und BasicHttpBinding so konfiguriert, dass die Elemente standardmäßig aktiviert werden, während die NetTcpBinding Bindung standardmäßig deaktiviert wird, damit Sie sich anmelden müssen, um Unterstützung zu erhalten, z. B. für eine der WS-*-Spezifikationen. Dies bedeutet, dass die Standardkonfiguration für TCP beim Austauschen von Nachrichten zwischen Endpunkten schneller ist als dies standardmäßig für die HTTP-Bindungen konfiguriert ist.

Warnung

Die NetTcpBinding verwendet tcp-Verbindungspooling basierend auf dem Host-DNS-Namen des Diensts und der Portnummer, auf die der Dienst lauscht. Dies funktioniert gut, wenn ein Client Aufrufe an verschiedene Dienste an verschiedenen Ports sendet oder Dienste in einem einzigen Prozess gehostet und einen Port gemeinsam nutzen. Wenn ein einzelner Client mehrere Dienste aufruft, die einen Port gemeinsam nutzen, 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 Dienst B wiederverwendet wird, was zu einer Ausnahme führt, die verbindung abgebrochen und ein neuer Kanal erstellt wurde. Um dieses Problem zu vermeiden, verwenden Sie eine CustomBinding-Datei, 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, Boolean)	Initialisiert eine neue Instanz der NetTcpBinding Klasse mit dem angegebenen Sicherheitstyp und einem Wert, der angibt, ob zuverlässige Sitzungen explizit aktiviert sind.
NetTcpBinding(SecurityMode)	Initialisiert eine neue Instanz der NetTcpBinding Klasse mit dem angegebenen Sicherheitstyp.
NetTcpBinding(String)	Initialisiert eine neue Instanz der NetTcpBinding Klasse mit einem angegebenen Konfigurationsnamen.

Eigenschaften

CloseTimeout	Dient zum Abrufen oder Festlegen des Zeitintervalls, das für eine Verbindung bereitgestellt wird, die geschlossen werden soll, bevor der Transport eine Ausnahme auslöst. (Geerbt von Binding)
EnvelopeVersion	Ruft die Version von SOAP ab, die für Nachrichten verwendet wird, die von dieser Bindung verarbeitet werden.
HostNameComparisonMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Hostname verwendet wird, um den Dienst beim Abgleichen des URI zu erreichen.
ListenBacklog	Ruft die maximale Anzahl von Verbindungsanforderungen in der Warteschlange ab, die ausstehend sein können, oder legt diese fest.
MaxBufferPoolSize	Ruft die maximale Größe in Bytes ab, die für einen Pufferpool zulässig ist, der TCP-Nachrichten speichert, die von der Bindung verarbeitet werden, oder legt diese fest.
MaxBufferSize	Dient zum Abrufen oder Festlegen eines Werts, der die maximale Größe des Puffers in Bytes angibt, der zum Speichern von Nachrichten im Arbeitsspeicher verwendet wird.
MaxConnections	Dient zum Abrufen oder Festlegen eines Werts, der die maximale Anzahl von Verbindungen steuert, die für die nachfolgende Wiederverwendung auf dem Client zusammengefasst werden sollen, und die maximale Anzahl von Verbindungen, die ausstehend auf dem Server sein dürfen.
MaxReceivedMessageSize	Ruft die maximale Größe in Bytes für eine empfangene Nachricht ab, die von der Bindung verarbeitet wird, oder legt diese fest.
MessageVersion	Ruft die Nachrichtenversion ab, die von Clients und Diensten verwendet wird, die mit der Bindung konfiguriert sind. (Geerbt von Binding)
Name	Dient zum Abrufen oder Festlegen des Namens der Bindung. (Geerbt von Binding)
Namespace	Dient zum Abrufen oder Festlegen des XML-Namespace der Bindung. (Geerbt von Binding)
OpenTimeout	Dient zum Abrufen oder Festlegen des Zeitintervalls, das für eine Verbindung bereitgestellt wird, die geöffnet werden soll, bevor der Transport eine Ausnahme auslöst. (Geerbt von Binding)
PortSharingEnabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die TCP-Portfreigabe für die mit dieser Bindung konfigurierte Verbindung aktiviert ist.
ReaderQuotas	Dient zum Abrufen oder Festlegen von Einschränkungen für die Komplexität von SOAP-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert sind.
ReceiveTimeout	Ruft ab oder legt das Zeitintervall fest, in dem eine Verbindung inaktiv bleiben kann, während der keine Anwendungsnachrichten empfangen werden, bevor sie gelöscht wird. (Geerbt von Binding)
ReliableSession	Ruft ein Objekt ab, das angibt, ob eine zuverlässige Sitzung zwischen Kanalendpunkten hergestellt wird.
Scheme	Gibt das URI-Schema für den Transport zurück.
Security	Ruft ein Objekt ab, das den Typ der Sicherheit angibt, die mit diesen Diensten verwendet wird, die mit dieser Bindung konfiguriert sind.
SendTimeout	Dient zum Abrufen oder Festlegen des Zeitintervalls, das für einen Schreibvorgang bereitgestellt wird, der abgeschlossen werden soll, bevor der Transport eine Ausnahme auslöst. (Geerbt von Binding)
TransactionFlow	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob der Transaktionsfluss aktiviert ist.
TransactionProtocol	Ruft ab oder legt das Transaktionsprotokoll fest, das vom Dienst zum Fluss von Transaktionen verwendet wird.
TransferMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der mit der Bindung konfigurierte Dienst gestreamte oder gepufferte (oder beide) Modi der Nachrichtenübertragung verwendet.

Methoden

BuildChannelFactory<TChannel>(BindingParameterCollection)	Erstellt den Kanalfactorystapel auf dem Client, der einen bestimmten Kanaltyp erstellt und die durch eine Sammlung von Bindungsparametern angegebenen Features erfüllt. (Geerbt von Binding)
BuildChannelFactory<TChannel>(Object[])	Erstellt den Kanalfactorystapel auf dem Client, der einen bestimmten Kanaltyp erstellt und die von einem Objektarray angegebenen Features erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die durch eine Sammlung von Bindungsparametern angegebenen Features erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Object[])	Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, Object[])	Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features erfüllt. (Geerbt von Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	Erstellt den Kanallistener auf dem Dienst, der einen bestimmten Kanaltyp akzeptiert und die angegebenen Features 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 der angegebenen 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 angegebenen 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 der angegebenen 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 Array von Objekten angegebenen Kriterien erfüllt. (Geerbt von Binding)
CreateBindingElements()	Erstellt eine Auflistung mit den Bindungselementen für die Bindung.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetProperty<T>(BindingParameterCollection)	Gibt ein typiertes Objekt zurück, das ( falls vorhanden) aus der entsprechenden Ebene im Bindungsstapel angefordert wird. (Geerbt von Binding)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ShouldSerializeListenBacklog()	Gibt einen Wert zurück, der angibt, ob sich die ListenBacklog -Eigenschaft von ihrem Standardwert geändert hat und serialisiert werden soll.
ShouldSerializeMaxConnections()	Gibt einen Wert zurück, der angibt, ob sich die MaxConnections -Eigenschaft von ihrem Standardwert geändert hat und serialisiert werden soll.
ShouldSerializeName()	Gibt zurück, ob der Name der Bindung serialisiert werden soll. (Geerbt von Binding)
ShouldSerializeNamespace()	Gibt zurück, ob der Namespace der Bindung serialisiert werden soll. (Geerbt von Binding)
ShouldSerializeReaderQuotas()	Gibt einen Wert zurück, der angibt, ob sich die ReaderQuotas -Eigenschaft von ihrem Standardwert geändert hat und serialisiert werden soll.
ShouldSerializeReliableSession()	Gibt einen Wert zurück, der angibt, ob sich die ReliableSession -Eigenschaft von ihrem Standardwert geändert hat und serialisiert werden soll.
ShouldSerializeSecurity()	Gibt einen Wert zurück, der angibt, ob sich die Security -Eigenschaft von ihrem Standardwert geändert hat und serialisiert werden soll.
ShouldSerializeTransactionProtocol()	Gibt einen Wert zurück, der angibt, ob sich die TransactionProtocol -Eigenschaft von ihrem 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 verarbeitet werden.

Gilt für:

Freigeben über