NetTcpBinding Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel

Zestaw:

System.ServiceModel.dll

Bezpieczne, niezawodne powiązanie odpowiednie do komunikacji między maszynami.

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

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

type NetTcpBinding = class
    inherit Binding
    interface IBindingRuntimePreferences

Public Class NetTcpBinding
Inherits Binding
Implements IBindingRuntimePreferences

Dziedziczenie

Object

Binding

NetTcpBinding

Pochodne

System.ServiceModel.NetTcpContextBinding

Implementuje

IBindingRuntimePreferences

Przykłady

W tym przykładzie pokazano, jak utworzyć element NetTcpBinding, ustawiając tryb zabezpieczeń i typ poświadczeń transportu.

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

Uwagi

Element NetTcpBinding generuje domyślnie stos komunikacji w czasie wykonywania, który używa zabezpieczeń transportu, protokołu TCP na potrzeby dostarczania komunikatów i kodowania komunikatów binarnych. To powiązanie jest odpowiednim wyborem systemu Windows Communication Foundation (WCF) do komunikacji za pośrednictwem intranetu.

Domyślna konfiguracja elementu NetTcpBinding jest szybsza niż konfiguracja dostarczana przez WSHttpBindingprogram , ale jest przeznaczona tylko do komunikacji WCF. Zachowanie zabezpieczeń można skonfigurować przy użyciu opcjonalnego securityMode parametru w konstruktorze. Użycie WS-ReliableMessaging można skonfigurować przy użyciu opcjonalnego reliableSessionEnabled parametru. Jednak niezawodna obsługa komunikatów jest domyślnie wyłączona. Ogólnie rzecz biorąc, powiązania dostarczane przez system HTTP, takie jak WSHttpBinding i BasicHttpBinding są skonfigurowane domyślnie do włączania elementów, natomiast NetTcpBinding powiązanie domyślnie wyłącza elementy, aby umożliwić uzyskanie pomocy technicznej, na przykład dla jednej ze specyfikacji WS-*. Oznacza to, że domyślna konfiguracja protokołu TCP jest szybsza podczas wymiany komunikatów między punktami końcowymi niż skonfigurowana dla powiązań HTTP domyślnie.

Warning

Program NetTcpBinding używa buforowania połączeń TCP na podstawie nazwy DNS hosta usługi i numeru portu, na który nasłuchuje usługa. Działa to dobrze, gdy klient wykonuje wywołania do różnych usług na różnych portach lub usługi są hostowane w jednym procesie i współużytkują port. Jeśli jeden klient wywołuje wiele usług współużytkujących port hostowany w różnych procesach lub jest hostowany w usługach WAS/IIS, buforowanie po stronie klienta może prowadzić do problemów, gdy połączenie z usługą A jest ponownie używane dla usługi B, co powoduje zgłoszenie wyjątku, przerwanie połączenia i utworzenie nowego kanału. Aby uniknąć tego problemu, użyj elementu CustomBinding i określ inną nazwę ConnectionPoolSettings.GroupName dla każdej usługi, z którymi komunikuje się klient.

Konstruktory

Nazwa	Opis
NetTcpBinding()	Inicjuje nowe wystąpienie klasy NetTcpBinding.
NetTcpBinding(SecurityMode, Boolean)	Inicjuje nowe wystąpienie NetTcpBinding klasy z określonym typem zabezpieczeń i wartością wskazującą, czy sesje niezawodne są jawnie włączone.
NetTcpBinding(SecurityMode)	Inicjuje nowe wystąpienie NetTcpBinding klasy z określonym typem zabezpieczeń.
NetTcpBinding(String)	Inicjuje nowe wystąpienie NetTcpBinding klasy o określonej nazwie konfiguracji.

Właściwości

Nazwa	Opis
CloseTimeout	Pobiera lub ustawia interwał czasu podany dla połączenia do zamknięcia przed transportem zgłasza wyjątek. (Odziedziczone po Binding)
EnvelopeVersion	Pobiera wersję protokołu SOAP, która jest używana dla komunikatów przetwarzanych przez to powiązanie.
HostNameComparisonMode	Pobiera lub ustawia wartość wskazującą, czy nazwa hosta jest używana do uzyskiwania dostępu do usługi podczas dopasowywania identyfikatora URI.
ListenBacklog	Pobiera lub ustawia maksymalną liczbę żądań połączeń w kolejce, które mogą być oczekujące.
MaxBufferPoolSize	Pobiera lub ustawia maksymalny rozmiar w bajtach dozwolony dla puli buforów, która przechowuje komunikaty TCP przetwarzane przez powiązanie.
MaxBufferSize	Pobiera lub ustawia wartość określającą maksymalny rozmiar w bajtach buforu używanego do przechowywania komunikatów w pamięci.
MaxConnections	Pobiera lub ustawia wartość, która kontroluje maksymalną liczbę połączeń, które mają być buforowane w celu późniejszego ponownego użycia na kliencie i maksymalną liczbę połączeń, które mogą być oczekujące na wysłanie na serwerze.
MaxReceivedMessageSize	Pobiera lub ustawia maksymalny rozmiar w bajtach dla odebranego komunikatu przetwarzanego przez powiązanie.
MessageVersion	Pobiera wersję komunikatu używaną przez klientów i usługi skonfigurowane za pomocą powiązania. (Odziedziczone po Binding)
Name	Pobiera lub ustawia nazwę powiązania. (Odziedziczone po Binding)
Namespace	Pobiera lub ustawia przestrzeń nazw XML powiązania. (Odziedziczone po Binding)
OpenTimeout	Pobiera lub ustawia interwał czasu dla połączenia, który ma być otwarty przed zgłoszeniem wyjątku. (Odziedziczone po Binding)
PortSharingEnabled	Pobiera lub ustawia wartość wskazującą, czy udostępnianie portów TCP jest włączone dla połączenia skonfigurowanego za pomocą tego powiązania.
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.
ReceiveTimeout	Pobiera lub ustawia interwał czasu, przez który połączenie może pozostać nieaktywne, podczas którego żadne komunikaty aplikacji nie są odbierane, zanim zostanie porzucony. (Odziedziczone po Binding)
ReliableSession	Pobiera obiekt wskazujący, czy istnieje niezawodna sesja między punktami końcowymi kanału.
Scheme	Zwraca schemat identyfikatora URI dla transportu.
Security	Pobiera obiekt określający typ zabezpieczeń używany z usługami skonfigurowanymi za pomocą tego powiązania.
SendTimeout	Pobiera lub ustawia interwał czasu przewidziany dla operacji zapisu do ukończenia, zanim transport zgłosi wyjątek. (Odziedziczone po Binding)
TransactionFlow	Pobiera lub ustawia wartość określającą, czy przepływ transakcji jest włączony.
TransactionProtocol	Pobiera lub ustawia protokół transakcji używany przez usługę do przepływu transakcji.
TransferMode	Pobiera lub ustawia wartość wskazującą, czy usługa skonfigurowana za pomocą powiązania korzysta ze strumieniowych lub buforowanych (lub obu) trybów transferu komunikatów.

Metody

Nazwa	Opis
BuildChannelFactory<TChannel>(BindingParameterCollection)	Tworzy stos fabryki kanałów na kliencie, który tworzy określony typ kanału i spełnia funkcje określone przez kolekcję parametrów powiązania. (Odziedziczone po Binding)
BuildChannelFactory<TChannel>(Object[])	Tworzy stos fabryki kanałów na kliencie, który tworzy określony typ kanału i spełnia funkcje określone przez tablicę obiektów. (Odziedziczone po Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	Tworzy 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ązania. (Odziedziczone po Binding)
BuildChannelListener<TChannel>(Object[])	Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje. (Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje. (Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, Object[])	Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje. (Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje. (Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje. (Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje. (Odziedziczone po Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	Tworzy odbiornik kanału w usłudze, który akceptuje określony typ kanału i spełnia określone funkcje. (Odziedziczone po Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Zwraca wartość wskazującą, czy bieżące powiązanie może utworzyć stos fabryki kanału na kliencie, który spełnia określone parametry powiązania. (Odziedziczone po Binding)
CanBuildChannelFactory<TChannel>(Object[])	Zwraca wartość wskazującą, czy bieżące powiązanie może utworzyć stos fabryki kanału na kliencie, który spełnia wymagania określone przez tablicę obiektów. (Odziedziczone po Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	Zwraca wartość wskazującą, czy bieżące powiązanie może utworzyć stos odbiornika kanału w usłudze, który spełnia określone parametry powiązania. (Odziedziczone po Binding)
CanBuildChannelListener<TChannel>(Object[])	Zwraca wartość wskazującą, czy bieżące powiązanie może utworzyć stos odbiornika kanału w usłudze, który spełnia kryteria określone w tablicy obiektów. (Odziedziczone po Binding)
CreateBindingElements()	Tworzy kolekcję z elementami powiązania dla powiązania.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetProperty<T>(BindingParameterCollection)	Zwraca żądany obiekt typu (jeśli istnieje) z odpowiedniej warstwy w stosie powiązania. (Odziedziczone po Binding)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ShouldSerializeListenBacklog()	Zwraca wartość wskazującą, czy ListenBacklog właściwość zmieniła się z wartości domyślnej i powinna być serializowana.
ShouldSerializeMaxConnections()	Zwraca wartość wskazującą, czy MaxConnections właściwość zmieniła się z wartości domyślnej i powinna być serializowana.
ShouldSerializeName()	Zwraca, czy nazwa powiązania powinna być serializowana. (Odziedziczone po Binding)
ShouldSerializeNamespace()	Zwraca, czy przestrzeń nazw powiązania powinna być serializowana. (Odziedziczone po Binding)
ShouldSerializeReaderQuotas()	Zwraca wartość wskazującą, czy ReaderQuotas właściwość zmieniła się z wartości domyślnej i powinna być serializowana.
ShouldSerializeReliableSession()	Zwraca wartość wskazującą, czy ReliableSession właściwość zmieniła się z wartości domyślnej i powinna być serializowana.
ShouldSerializeSecurity()	Zwraca wartość wskazującą, czy Security właściwość zmieniła się z wartości domyślnej i powinna być serializowana.
ShouldSerializeTransactionProtocol()	Zwraca wartość wskazującą, czy TransactionProtocol właściwość zmieniła się z wartości domyślnej i powinna być serializowana.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

Nazwa	Opis
IBindingRuntimePreferences.ReceiveSynchronously	Pobiera wartość wskazującą, czy żądania przychodzące są obsługiwane synchronicznie, czy asynchronicznie.