NetTcpBinding Klasa

Definicja

Bezpieczne, niezawodne powiązania odpowiednie dla komunikacji między komputerami.A secure, reliable binding suitable for cross-machine communication.

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
Dziedziczenie
NetTcpBinding
Pochodne
Implementuje

Przykłady

Ten przykład pokazuje, jak utworzyć NetTcpBinding , ustawić tryb zabezpieczeń i typ poświadczenia transportu.This example shows how to create a NetTcpBinding, setting the security mode and transport credential type.

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

Uwagi

NetTcpBindingGeneruje stos komunikacji w czasie wykonywania domyślnie, który korzysta z zabezpieczeń transportu, protokołu TCP do dostarczania komunikatów i kodowania komunikatów binarnych.The NetTcpBinding generates a run-time communication stack by default, which uses transport security, TCP for message delivery, and a binary message encoding. To powiązanie jest odpowiednim wyborem systemu Windows Communication Foundation (WCF) w przypadku komunikacji za pośrednictwem intranetu.This binding is an appropriate Windows Communication Foundation (WCF) system-provided choice for communicating over an Intranet.

Konfiguracja domyślna dla programu NetTcpBinding jest szybsza niż konfiguracja podana przez WSHttpBinding , ale jest przeznaczona tylko do komunikacji z WCF.The default configuration for the NetTcpBinding is faster than the configuration provided by the WSHttpBinding, but it is intended only for WCF communication. Zachowanie zabezpieczeń można skonfigurować za pomocą opcjonalnego securityMode parametru w konstruktorze.The security behavior is configurable using the optional securityMode parameter in the constructor. Użycie WS-ReliableMessaging można skonfigurować przy użyciu opcjonalnego reliableSessionEnabled parametru.The use of WS-ReliableMessaging is configurable using the optional reliableSessionEnabled parameter. Jednak niezawodna obsługa komunikatów jest domyślnie wyłączona.But reliable messaging is off by default. Ogólnie rzecz biorąc, powiązania dostarczone przez system HTTP, takie jak WSHttpBinding i, BasicHttpBinding są domyślnie skonfigurowane do włączania funkcji, natomiast NetTcpBinding powiązanie to jest domyślnie wyłączone, dzięki czemu trzeba się dowiedzieć, aby uzyskać pomoc techniczną, na przykład dla jednej ze specyfikacji WS-*.More generally, the HTTP system-provided bindings such as WSHttpBinding and BasicHttpBinding are configured to turn things on by default, whereas the NetTcpBinding binding turns things off by default so that you have to opt-in to get support, for example, for one of the WS-* specifications. Oznacza to, że konfiguracja domyślna dla protokołu TCP jest szybsza podczas wymiany komunikatów między punktami końcowymi, które są domyślnie skonfigurowane dla powiązań HTTP.This means that the default configuration for TCP is faster at exchanging messages between endpoints than that configured for the HTTP bindings by default.

Ostrzeżenie

NetTcpBindingUżywa puli połączeń TCP na podstawie nazwy DNS hosta usługi i numeru portu, na którym nasłuchuje usługa.The NetTcpBinding uses TCP connection pooling based on the service's host DNS name and the port number the service is listening on. Jest to dobre rozwiązanie, gdy klient wysyła wywołania do różnych usług na różnych portach, a usługi są hostowane w pojedynczym procesie i udostępniają port.This works well when a client makes calls to different services on different ports, or services are hosted in a single process and share a port. Jeśli pojedynczy klient wywołuje wiele usług udostępniających port, który jest hostowany w różnych procesach, lub jeśli Usługa IIS jest hostowana, buforowanie po stronie klienta może prowadzić do problemów, w przypadku których połączenie z usługą A jest ponownie używane w usłudze B, co spowodowało wystąpienie wyjątku, przerwanie połączenia i utworzenie nowego kanału.If a single client calls multiple services sharing a port that are hosted in different processes, or are WAS/IIS hosted, the client side pooling may lead to problems where a connection to Service A is reused for Service B, resulting in an exception being thrown, the connection aborted, and a new channel created. Aby uniknąć tego problemu, należy użyć Niestandardowegobinding i określić inną ConnectionPoolSettings. GroupName dla każdej usługi, z którą komunikuje się klient.To avoid this problem, use a CustomBinding and specify a different ConnectionPoolSettings.GroupName for each service the client communicates with.

Konstruktory

NetTcpBinding()

Inicjuje nowe wystąpienie klasy NetTcpBinding.Initializes a new instance of the NetTcpBinding class.

NetTcpBinding(SecurityMode)

Inicjuje nowe wystąpienie NetTcpBinding klasy z określonym typem używanego zabezpieczenia.Initializes a new instance of the NetTcpBinding class with the type of security used specified.

NetTcpBinding(SecurityMode, Boolean)

Inicjuje nowe wystąpienie NetTcpBinding klasy z typem używanego zabezpieczenia i wartością wskazującą, czy niezawodne sesje są jawnie włączone.Initializes a new instance of the NetTcpBinding class with the type of security used specified and with a value that indicates whether reliable sessions are explicitly enabled.

NetTcpBinding(String)

Inicjuje nowe wystąpienie NetTcpBinding klasy z określoną nazwą konfiguracji.Initializes a new instance of the NetTcpBinding class with a specified configuration name.

Właściwości

CloseTimeout

Pobiera lub ustawia przedział czasu, który ma zostać zamknięty, zanim transport zgłosi wyjątek.Gets or sets the interval of time provided for a connection to close before the transport raises an exception.

(Odziedziczone po Binding)
EnvelopeVersion

Pobiera wersję protokołu SOAP, która jest używana na potrzeby komunikatów przetwarzanych przez to powiązanie.Gets the version of SOAP that is used for messages processed by this binding.

HostNameComparisonMode

Pobiera lub ustawia wartość wskazującą, czy nazwa hosta jest używana do uzyskiwania dostępu do usługi podczas dopasowywania identyfikatora URI.Gets or sets a value that indicates whether the hostname is used to reach the service when matching the URI.

ListenBacklog

Pobiera lub ustawia maksymalną liczbę oczekujących żądań połączeń, które mogą być w stanie oczekiwania.Gets or sets the maximum number of queued connection requests that can be pending.

MaxBufferPoolSize

Pobiera lub ustawia maksymalny rozmiar (w bajtach) dozwolony dla puli buforów przechowującej komunikaty TCP przetwarzane przez powiązanie.Gets or sets the maximum size, in bytes, allowed for a buffer pool that stores TCP messages processed by the binding.

MaxBufferSize

Pobiera lub ustawia wartość określającą maksymalny rozmiar buforu używany do przechowywania komunikatów w pamięci (w bajtach).Gets or sets a value that specifies the maximum size, in bytes, of the buffer used to store messages in memory.

MaxConnections

Pobiera lub ustawia wartość określającą maksymalną liczbę połączeń w puli do późniejszego ponownego użycia na kliencie oraz maksymalną dozwoloną liczbę połączeń oczekujących na wysłanie na serwer.Gets or sets a value that controls the maximum number of connections to be pooled for subsequent reuse on the client and the maximum number of connections allowed to be pending dispatch on the server.

MaxReceivedMessageSize

Pobiera lub ustawia maksymalny rozmiar w bajtach dla odebranego komunikatu, który jest przetwarzany przez powiązanie.Gets or sets the maximum size, in bytes, for a received message that is processed by the binding.

MessageVersion

Pobiera wersję wiadomości używaną przez klientów i usługi skonfigurowane przy użyciu powiązania.Gets the message version used by clients and services configured with the binding.

(Odziedziczone po Binding)
Name

Pobiera lub ustawia nazwę powiązania.Gets or sets the name of the binding.

(Odziedziczone po Binding)
Namespace

Pobiera lub ustawia przestrzeń nazw XML powiązania.Gets or sets the XML namespace of the binding.

(Odziedziczone po Binding)
OpenTimeout

Pobiera lub ustawia przedział czasu, który ma być otwarty, zanim transport zgłosi wyjątek.Gets or sets the interval of time provided for a connection to open before the transport raises an exception.

(Odziedziczone po Binding)
PortSharingEnabled

Pobiera lub ustawia wartość wskazującą, czy włączone jest Udostępnianie portów TCP dla połączenia skonfigurowanego za pomocą tego powiązania.Gets or sets a value that indicates whether TCP port sharing is enabled for the connection configured with this binding.

ReaderQuotas

Pobiera lub ustawia ograniczenia złożoności komunikatów protokołu SOAP, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego powiązania.Gets or sets constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

ReceiveTimeout

Pobiera lub ustawia przedział czasu, przez jaki połączenie może pozostawać nieaktywne, podczas którego nie są odbierane żadne komunikaty aplikacji przed porzuceniem.Gets or sets the interval of time that a connection can remain inactive, during which no application messages are received, before it is dropped.

(Odziedziczone po Binding)
ReliableSession

Pobiera obiekt wskazujący, czy dla punktów końcowych kanału ustanowiono niezawodną sesję.Gets an object that indicates whether a reliable session is established between channel endpoints.

Scheme

Zwraca schemat identyfikatora URI dla transportu.Returns the URI scheme for the transport.

Security

Pobiera obiekt, który określa typ zabezpieczeń używany z usługami skonfigurowanymi przy użyciu tego powiązania.Gets an object that specifies the type of security used with services configured with this binding.

SendTimeout

Pobiera lub ustawia przedział czasu przewidziany na zakończenie operacji zapisu przed wykroczeniem przez transport wyjątku.Gets or sets the interval of time provided for a write operation to complete before the transport raises an exception.

(Odziedziczone po Binding)
TransactionFlow

Pobiera lub ustawia wartość określającą, czy przepływ transakcji jest włączony.Gets or sets a value that determines whether transaction flow is enabled.

TransactionProtocol

Pobiera lub ustawia protokół transakcji używany przez usługę do przepływu transakcji.Gets or sets the transactions protocol used by the service to flow transactions.

TransferMode

Pobiera lub ustawia wartość wskazującą, czy Usługa skonfigurowana za pomocą powiązania korzysta z trybu transferu komunikatów przesyłanego strumieniowo czy z buforem.Gets or sets a value that indicates whether the service configured with the binding uses streamed or buffered (or both) modes of message transfer.

Metody

BuildChannelFactory<TChannel>(BindingParameterCollection)

Kompiluje stos fabryki kanałów na kliencie, który tworzy określony typ kanału, który spełnia funkcje określone przez kolekcję parametrów powiązań.Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Odziedziczone po Binding)
BuildChannelFactory<TChannel>(Object[])

Kompiluje stos fabryki kanałów na kliencie, który tworzy określony typ kanału, który spełnia funkcje określone przez tablicę obiektów.Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by an object array.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia funkcje określone przez kolekcję parametrów powiązań.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Object[])

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, Object[])

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])

Kompiluje odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje.Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Odziedziczone po Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)

Zwraca wartość wskazującą, czy bieżące powiązanie może utworzyć stos fabryki kanałów na kliencie, który spełnia wymagania kolekcji określonych parametrów powiązania.Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the collection of binding parameters specified.

(Odziedziczone po Binding)
CanBuildChannelFactory<TChannel>(Object[])

Zwraca wartość wskazującą, czy bieżące powiązanie może skompilować stos fabryki kanałów na kliencie, który spełnia wymagania określone przez tablicę obiektów.Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the requirements specified by an object array.

(Odziedziczone po Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)

Zwraca wartość wskazującą, czy bieżące powiązanie może kompilować stos odbiornika kanałów w usłudze, która spełnia kryteria kolekcji określonych parametrów powiązania.Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the collection of binding parameters specified.

(Odziedziczone po Binding)
CanBuildChannelListener<TChannel>(Object[])

Zwraca wartość wskazującą, czy bieżące powiązanie może kompilować stos odbiornika kanałów w usłudze, która spełnia kryteria określone w tablicy obiektów.Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the criteria specified in an array of objects.

(Odziedziczone po Binding)
CreateBindingElements()

Tworzy kolekcję z elementami powiązania dla powiązania.Creates a collection with the binding elements for the binding.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetProperty<T>(BindingParameterCollection)

Zwraca żądany obiekt typu, jeśli jest obecny, z odpowiedniej warstwy w stosie powiązań.Returns a typed object requested, if present, from the appropriate layer in the binding stack.

(Odziedziczone po Binding)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ShouldSerializeListenBacklog()

Zwraca wartość wskazującą, czy ListenBacklog Właściwość została zmieniona z wartości domyślnej i powinna być serializowana.Returns a value that indicates whether the ListenBacklog property has changed from its default value and should be serialized.

ShouldSerializeMaxConnections()

Zwraca wartość wskazującą, czy MaxConnections Właściwość została zmieniona z wartości domyślnej i powinna być serializowana.Returns a value that indicates whether the MaxConnections property has changed from its default value and should be serialized.

ShouldSerializeName()

Zwraca czy nazwa powiązania powinna być serializowana.Returns whether the name of the binding should be serialized.

(Odziedziczone po Binding)
ShouldSerializeNamespace()

Zwraca czy przestrzeń nazw powiązania powinna być serializowana.Returns whether the namespace of the binding should be serialized.

(Odziedziczone po Binding)
ShouldSerializeReaderQuotas()

Zwraca wartość wskazującą, czy ReaderQuotas Właściwość została zmieniona z wartości domyślnej i powinna być serializowana.Returns a value that indicates whether the ReaderQuotas property has changed from its default value and should be serialized.

ShouldSerializeReliableSession()

Zwraca wartość wskazującą, czy ReliableSession Właściwość została zmieniona z wartości domyślnej i powinna być serializowana.Returns a value that indicates whether the ReliableSession property has changed from its default value and should be serialized.

ShouldSerializeSecurity()

Zwraca wartość wskazującą, czy Security Właściwość została zmieniona z wartości domyślnej i powinna być serializowana.Returns a value that indicates whether the Security property has changed from its default value and should be serialized.

ShouldSerializeTransactionProtocol()

Zwraca wartość wskazującą, czy TransactionProtocol Właściwość została zmieniona z wartości domyślnej i powinna być serializowana.Returns a value that indicates whether the TransactionProtocol property has changed from its default value and should be serialized.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IBindingRuntimePreferences.ReceiveSynchronously

Pobiera wartość wskazującą, czy żądania przychodzące są obsługiwane synchronicznie, czy asynchronicznie.Gets a value that indicates whether incoming requests are handled synchronously or asynchronously.

Dotyczy