NetTcpBinding Třída

Reference

Definice

Obor názvů:: System.ServiceModel

Sestavení:: System.ServiceModel.NetTcp.dll

Sestavení:: System.ServiceModel.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zabezpečená spolehlivá vazba vhodná pro komunikaci mezi počítači.

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

Dědičnost: Object

Binding
NetTcpBinding

Odvozené: System.ServiceModel.NetTcpContextBinding

Implementuje: IBindingRuntimePreferences

Příklady

V tomto příkladu NetTcpBindingse dozvíte, jak vytvořit , nastavit režim zabezpečení a transportní typ přihlašovacích údajů.

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

Poznámky

Ve výchozím nastavení generuje NetTcpBinding zásobník komunikace za běhu, který používá zabezpečení přenosu, TCP pro doručování zpráv a kódování binárních zpráv. Tato vazba je vhodná Windows Communication Foundation (WCF) pro komunikaci přes intranet.

Výchozí konfigurace pro tuto NetTcpBinding konfiguraci je rychlejší než konfigurace poskytovaná WSHttpBindingnástrojem , ale je určená pouze pro komunikaci WCF. Chování zabezpečení je možné konfigurovat pomocí volitelného securityMode parametru v konstruktoru. Použití WS-ReliableMessaging je možné konfigurovat pomocí volitelného reliableSessionEnabled parametru. Spolehlivé zasílání zpráv je ale ve výchozím nastavení vypnuté. Obecně platí, že systémové vazby HTTP, jako WSHttpBinding jsou například a BasicHttpBinding jsou nakonfigurované tak, aby ve výchozím nastavení zapnuly věci, zatímco NetTcpBinding vazba ve výchozím nastavení vypne, takže se musíte přihlásit, abyste získali podporu, například pro jednu ze specifikací WS-*. To znamená, že výchozí konfigurace protokolu TCP je rychlejší při výměně zpráv mezi koncovými body, než je nakonfigurovaná pro vazby HTTP ve výchozím nastavení.

Upozornění

Používá NetTcpBinding sdružování připojení TCP na základě názvu DNS hostitele služby a čísla portu, na který služba naslouchá. To funguje dobře, když klient volá různé služby na různých portech nebo jsou služby hostované v jednom procesu a sdílejí port. Pokud jeden klient volá více služeb, které sdílejí port hostovaný v různých procesech nebo jsou hostované was/IIS, může sdružování na straně klienta vést k problémům, kdy se pro službu B znovu používá připojení ke službě A, což vede k vyvolání výjimky, přerušení připojení a vytvoření nového kanálu. Chcete-li se tomuto problému vyhnout, použijte CustomBinding a zadejte jiný ConnectionPoolSettings.GroupName pro každou službu, se kterými klient komunikuje.

Konstruktory

NetTcpBinding()	Inicializuje novou instanci NetTcpBinding třídy.
NetTcpBinding(SecurityMode)	Inicializuje novou instanci NetTcpBinding třídy s typem použitého zabezpečení.
NetTcpBinding(SecurityMode, Boolean)	Inicializuje novou instanci NetTcpBinding třídy s typem použitého zabezpečení a s hodnotou, která označuje, zda jsou spolehlivé relace explicitně povoleny.
NetTcpBinding(String)	Inicializuje novou instanci NetTcpBinding třídy se zadaným názvem konfigurace.

Vlastnosti

CloseTimeout	Získá nebo nastaví interval času, který je k dispozici pro připojení zavřít před vyvolání výjimky. (Zděděno od Binding)
EnvelopeVersion	Získá verzi SOAP, která se používá pro zprávy zpracovávané touto vazbou.
HostNameComparisonMode	Získá nebo nastaví hodnotu, která označuje, zda se název hostitele používá k dosažení služby při porovnávání identifikátoru URI.
ListenBacklog	Získá nebo nastaví maximální počet požadavků na připojení ve frontě, které mohou být čekající.
MaxBufferPoolSize	Získá nebo nastaví maximální velikost v bajtech povolené pro fond vyrovnávací paměti, který ukládá zprávy TCP zpracovávané vazbou.
MaxBufferSize	Získá nebo nastaví hodnotu, která určuje maximální velikost v bajtech vyrovnávací paměti použité k ukládání zpráv do paměti.
MaxConnections	Získá nebo nastaví hodnotu, která řídí maximální počet připojení, která mají být ve fondu pro následné opakované použití v klientovi a maximální počet připojení může být čekající na odeslání na serveru.
MaxReceivedMessageSize	Získá nebo nastaví maximální velikost v bajtech pro přijatou zprávu, která je zpracována vazbou.
MessageVersion	Získá verzi zprávy, kterou klienti a služby konfigurují s vazbou. (Zděděno od Binding)
Name	Získá nebo nastaví název vazby. (Zděděno od Binding)
Namespace	Získá nebo nastaví obor názvů XML vazby. (Zděděno od Binding)
OpenTimeout	Získá nebo nastaví interval času, který je k dispozici pro připojení, aby se otevřelo před vyvolání výjimky přenosu. (Zděděno od Binding)
PortSharingEnabled	Získá nebo nastaví hodnotu, která označuje, zda je pro připojení nakonfigurované pomocí této vazby povoleno sdílení portů TCP.
ReaderQuotas	Získá nebo nastaví omezení složitosti zpráv SOAP, které je možné zpracovat koncovými body nakonfigurovanými pomocí této vazby.
ReceiveTimeout	Získá nebo nastaví interval doby, po kterou může připojení zůstat neaktivní, během kterého nebudou přijaty žádné zprávy aplikace, než se odstraní. (Zděděno od Binding)
ReliableSession	Získá objekt, který označuje, zda je spolehlivá relace založena mezi koncovými body kanálu.
Scheme	Vrátí schéma identifikátoru URI pro přenos.
Security	Získá objekt, který určuje typ zabezpečení používané se službami nakonfigurovanými pomocí této vazby.
SendTimeout	Získá nebo nastaví interval času, který je k dispozici pro operaci zápisu dokončit před přenos vyvolá výjimku. (Zděděno od Binding)
TransactionFlow	Získá nebo nastaví hodnotu, která určuje, zda je tok transakce povolen.
TransactionProtocol	Získá nebo nastaví transakční protokol používaný službou k toku transakcí.
TransferMode	Získá nebo nastaví hodnotu, která označuje, zda služba nakonfigurovaná s vazbou používá streamované nebo vyrovnávací paměti (nebo oba) režimy přenosu zpráv.

Metody

BuildChannelFactory<TChannel>(BindingParameterCollection)	Sestaví zásobník továrny kanálu na klientovi, který vytvoří zadaný typ kanálu a který splňuje funkce určené kolekcí parametrů vazby. (Zděděno od Binding)
BuildChannelFactory<TChannel>(Object[])	Vytvoří zásobník objektu pro vytváření kanálů na klientovi, který vytvoří zadaný typ kanálu a který vyhovuje funkcím určeným polem objektů. (Zděděno od Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje funkce určené kolekcí parametrů vazby. (Zděděno od Binding)
BuildChannelListener<TChannel>(Object[])	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, Object[])	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	Vytvoří naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a který splňuje zadané funkce. (Zděděno od Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Vrátí hodnotu, která označuje, zda aktuální vazba může vytvořit zásobník objektu pro vytváření kanálů na klientovi, který splňuje kolekci zadaných parametrů vazby. (Zděděno od Binding)
CanBuildChannelFactory<TChannel>(Object[])	Vrátí hodnotu, která označuje, zda aktuální vazba může vytvořit zásobník objektu pro vytváření kanálů na klientovi, který splňuje požadavky určené polem objektů. (Zděděno od Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	Vrátí hodnotu, která označuje, zda aktuální vazba může vytvořit zásobník naslouchacího procesu kanálu ve službě, která splňuje kolekci zadaných parametrů vazby. (Zděděno od Binding)
CanBuildChannelListener<TChannel>(Object[])	Vrátí hodnotu, která označuje, zda aktuální vazba může vytvořit zásobník naslouchacího procesu kanálu ve službě, která splňuje kritéria zadaná v poli objektů. (Zděděno od Binding)
CreateBindingElements()	Vytvoří kolekci s prvky vazby pro vazbu.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetProperty<T>(BindingParameterCollection)	Vrátí požadovaný typ objektu z příslušné vrstvy v zásobníku vazeb. (Zděděno od Binding)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ShouldSerializeListenBacklog()	Vrátí hodnotu, která označuje, zda se ListenBacklog vlastnost změnila z výchozí hodnoty a měla by být serializována.
ShouldSerializeMaxConnections()	Vrátí hodnotu, která označuje, zda se MaxConnections vlastnost změnila z výchozí hodnoty a měla by být serializována.
ShouldSerializeName()	Vrátí, zda má být název vazby serializován. (Zděděno od Binding)
ShouldSerializeNamespace()	Vrátí, zda má být obor názvů vazby serializován. (Zděděno od Binding)
ShouldSerializeReaderQuotas()	Vrátí hodnotu, která označuje, zda se ReaderQuotas vlastnost změnila z výchozí hodnoty a měla by být serializována.
ShouldSerializeReliableSession()	Vrátí hodnotu, která označuje, zda se ReliableSession vlastnost změnila z výchozí hodnoty a měla by být serializována.
ShouldSerializeSecurity()	Vrátí hodnotu, která označuje, zda se Security vlastnost změnila z výchozí hodnoty a měla by být serializována.
ShouldSerializeTransactionProtocol()	Vrátí hodnotu, která označuje, zda se TransactionProtocol vlastnost změnila z výchozí hodnoty a měla by být serializována.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

IBindingRuntimePreferences.ReceiveSynchronously

Získá hodnotu, která označuje, zda se příchozí požadavky zpracovávají synchronně nebo asynchronně.

Platí pro

Sdílet prostřednictvím