NetTcpBinding Třída
Definice
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á a 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
- Odvozené
- Implementuje
Příklady
Tento příklad ukazuje, jak vytvořit NetTcpBinding, nastavení režimu zabezpečení a přenos typu přihlašovacích údajů.
NetTcpBinding binding = new NetTcpBinding();
binding.Security.Mode = SecurityMode.Transport;
binding.Security.Transport.ClientCredentialType = TcpClientCredentialType.Certificate;
Poznámky
Ve NetTcpBinding výchozím nastavení generuje 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í zprávy. Tato vazba je vhodná volba systému Windows Communication Foundation (WCF) určená pro komunikaci přes intranet.
Výchozí konfigurace je NetTcpBinding rychlejší než konfigurace poskytovaná WSHttpBindingnástrojem , ale je určená pouze pro komunikaci WCF. Chování zabezpečení je konfigurovatelné 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ěji platí, že systémové vazby HTTP, jako WSHttpBinding jsou a BasicHttpBinding jsou nakonfigurované tak, aby ve výchozím nastavení zapnuly věci, zatímco NetTcpBinding vazba ve výchozím nastavení vypne, abyste se přihlásili, 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ž které jsou nakonfigurované pro vazby HTTP ve výchozím nastavení.
Warning
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 provádí volání různých služeb 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 sdílející port hostovaný v různých procesech nebo je hostovaný službou WAS/IIS, může sdružování na straně klienta vést k problémům, kdy se pro službu B znovu použije 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
| Name | Description |
|---|---|
| NetTcpBinding() |
Inicializuje novou instanci NetTcpBinding třídy. |
| NetTcpBinding(SecurityMode, Boolean) |
Inicializuje novou instanci NetTcpBinding třídy s typem zabezpečení použitého zadanou hodnotou a s hodnotou, která označuje, zda jsou spolehlivé relace explicitně povoleny. |
| NetTcpBinding(SecurityMode) |
Inicializuje novou instanci NetTcpBinding třídy s typem použitého zabezpečení. |
| NetTcpBinding(String) |
Inicializuje novou instanci NetTcpBinding třídy se zadaným názvem konfigurace. |
Vlastnosti
| Name | Description |
|---|---|
| CloseTimeout |
Získá nebo nastaví časový interval zadaný pro připojení zavřít před přenos vyvolá výjimku. (Zděděno od Binding) |
| EnvelopeVersion |
Získá verzi protokolu SOAP, která se používá pro zprávy zpracovávané touto vazbou. |
| HostNameComparisonMode |
Získá nebo nastaví hodnotu, která urč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í zařazených do fronty, 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 v 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 používanou klienty a službami nakonfigurovanými 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 zadaného pro připojení k otevření před přenos vyvolá výjimku. (Zděděno od Binding) |
| PortSharingEnabled |
Získá nebo nastaví hodnotu, která označuje, zda je povoleno sdílení portů TCP pro připojení nakonfigurované s touto vazbou. |
| ReaderQuotas |
Získá nebo nastaví omezení složitosti zpráv SOAP, které lze zpracovat koncovými body nakonfigurovanými touto vazbou. |
| ReceiveTimeout |
Získá nebo nastaví interval doby, po kterou může připojení zůstat neaktivní, během kterého nejsou přijaty žádné zprávy aplikace, než se zahodí. (Zděděno od Binding) |
| ReliableSession |
Získá objekt, který označuje, zda je spolehlivá relace vytvoř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 s touto vazbou. |
| SendTimeout |
Získá nebo nastaví interval času zadaný 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 pro tok 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
| Name | Description |
|---|---|
| BuildChannelFactory<TChannel>(BindingParameterCollection) |
Sestaví zásobník objektu pro vytváření kanálů 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[]) |
Sestaví zásobník objektu pro vytváření kanálů na klientovi, který vytvoří zadaný typ kanálu a splňuje funkce určené polem objektů. (Zděděno od Binding) |
| BuildChannelListener<TChannel>(BindingParameterCollection) |
Sestaví naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a splňuje funkce určené kolekcí parametrů vazby. (Zděděno od Binding) |
| BuildChannelListener<TChannel>(Object[]) |
Sestaví naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a splňuje zadané funkce. (Zděděno od Binding) |
| BuildChannelListener<TChannel>(Uri, BindingParameterCollection) |
Sestaví naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a splňuje zadané funkce. (Zděděno od Binding) |
| BuildChannelListener<TChannel>(Uri, Object[]) |
Sestaví naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a splňuje zadané funkce. (Zděděno od Binding) |
| BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) |
Sestaví naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a splňuje zadané funkce. (Zděděno od Binding) |
| BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) |
Sestaví naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a splňuje zadané funkce. (Zděděno od Binding) |
| BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) |
Sestaví naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a splňuje zadané funkce. (Zděděno od Binding) |
| BuildChannelListener<TChannel>(Uri, String, Object[]) |
Sestaví naslouchací proces kanálu ve službě, která přijímá zadaný typ kanálu a splňuje zadané funkce. (Zděděno od Binding) |
| CanBuildChannelFactory<TChannel>(BindingParameterCollection) |
Vrátí hodnotu, která urč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á urč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á určuje, zda aktuální vazba může sestavit 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á urč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čuje, zda je zadaný objekt roven 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() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| ShouldSerializeListenBacklog() |
Vrátí hodnotu, která určuje, zda ListenBacklog se vlastnost změnila z výchozí hodnoty a měla by být serializována. |
| ShouldSerializeMaxConnections() |
Vrátí hodnotu, která určuje, zda MaxConnections se 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á určuje, zda ReaderQuotas se vlastnost změnila z výchozí hodnoty a měla by být serializována. |
| ShouldSerializeReliableSession() |
Vrátí hodnotu, která určuje, zda ReliableSession se vlastnost změnila z výchozí hodnoty a měla by být serializována. |
| ShouldSerializeSecurity() |
Vrátí hodnotu, která určuje, zda Security se vlastnost změnila z výchozí hodnoty a měla by být serializována. |
| ShouldSerializeTransactionProtocol() |
Vrátí hodnotu, která určuje, zda TransactionProtocol se 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í
| Name | Description |
|---|---|
| IBindingRuntimePreferences.ReceiveSynchronously |
Získá hodnotu, která označuje, zda příchozí požadavky jsou zpracovávány synchronně nebo asynchronně. |