NetTcpBinding Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.ServiceModel

Zestaw:: System.ServiceModel.NetTcp.dll

Zestaw:: System.ServiceModel.dll

Zestaw:: System.Private.ServiceModel.dll

Pakiet:: System.ServiceModel.NetTcp v8.0.0

Pakiet:: System.Private.ServiceModel v4.10.3

Źródło:: NetTcpBinding.cs

Źródło:: NetTcpBinding.cs

Źródło:: NetTcpBinding.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

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: 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 do dostarczania komunikatów i kodowania komunikatów binarnych. To powiązanie jest odpowiednim wyborem systemowym programu Windows Communication Foundation (WCF) do komunikacji za pośrednictwem intranetu.

Domyślna konfiguracja dla elementu NetTcpBinding jest szybsza niż konfiguracja podana przez usługę WSHttpBinding, ale jest przeznaczona tylko dla 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 niezawodne komunikaty są domyślnie wyłączone. 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, podczas gdy NetTcpBinding powiązanie domyślnie wyłącza elementy, aby uzyskać pomoc techniczną, na przykład w przypadku 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.

Ostrzeżenie

Używa NetTcpBinding puli 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 przez usługę WAS/IIS, buforowanie po stronie klienta może prowadzić do problemów, w których połączenie z usługą A jest ponownie używane dla usługi B, co powoduje zgłoszenie wyjątku, przerwane połączenie i utworzony nowy kanał. 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

NetTcpBinding()	Inicjuje nowe wystąpienie klasy NetTcpBinding.
NetTcpBinding(SecurityMode)	Inicjuje NetTcpBinding nowe wystąpienie klasy z określonym typem zabezpieczeń.
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(String)	Inicjuje NetTcpBinding nowe wystąpienie klasy o określonej nazwie konfiguracji.

Właściwości

CloseTimeout	Pobiera lub ustawia interwał czasu podanego dla połączenia do zamknięcia, zanim transport zgłasza wyjątek. (Odziedziczone po Binding)
EnvelopeVersion	Pobiera wersję protokołu SOAP, która jest używana do obsługi komunikatów przetwarzanych przez to powiązanie.
HostNameComparisonMode	Pobiera lub ustawia wartość wskazującą, czy nazwa hosta jest używana do osiągnięcia usługi podczas dopasowywania identyfikatora URI.
ListenBacklog	Pobiera lub ustawia maksymalną liczbę oczekujących żądań połączenia w kolejce.
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 buforu używanego do przechowywania komunikatów w pamięci w bajtach.
MaxConnections	Pobiera lub ustawia wartość, która kontroluje maksymalną liczbę połączeń, które mają być w puli w celu późniejszego ponownego użycia na kliencie, oraz 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 podany dla połączenia do otwarcia, zanim transport zgłosi wyjątek. (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 nie są odbierane żadne komunikaty aplikacji, 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żywanych z usługami skonfigurowanymi za pomocą tego powiązania.
SendTimeout	Pobiera lub ustawia interwał czasu podany 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 używa strumieniowych lub buforowanych (lub obu) trybów transferu komunikatów.

Metody

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łów 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óra 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óra 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 z odpowiedniej warstwy w stosie powiązań. (Odziedziczone po Binding)
GetType()	Type Pobiera bieżące wystąpienie. (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

IBindingRuntimePreferences.ReceiveSynchronously

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

Dotyczy