Udostępnij za pośrednictwem


NetTcpBinding Klasa

Definicja

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

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