NetTcpBinding Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
En säker, tillförlitlig bindning som lämpar sig för kommunikation mellan datorer.
public ref class NetTcpBinding : System::ServiceModel::Channels::Bindingpublic ref class NetTcpBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferencespublic class NetTcpBinding : System.ServiceModel.Channels.Bindingpublic class NetTcpBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferencestype NetTcpBinding = class
inherit Bindingtype NetTcpBinding = class
inherit Binding
interface IBindingRuntimePreferencesPublic Class NetTcpBinding
Inherits BindingPublic Class NetTcpBinding
Inherits Binding
Implements IBindingRuntimePreferences- Arv
- Härledda
- Implementeringar
Exempel
Det här exemplet visar hur du skapar en NetTcpBinding, anger säkerhetsläge och transportautentiseringstyp.
NetTcpBinding binding = new NetTcpBinding();
binding.Security.Mode = SecurityMode.Transport;
binding.Security.Transport.ClientCredentialType = TcpClientCredentialType.Certificate;
Kommentarer
NetTcpBinding Genererar en körningskommunikationsstack som standard, som använder transportsäkerhet, TCP för meddelandeleverans och en binär meddelandekodning. Den här bindningen är ett lämpligt systemval för Windows Communication Foundation (WCF) för kommunikation via ett intranät.
Standardkonfigurationen NetTcpBinding för är snabbare än konfigurationen som tillhandahålls av WSHttpBinding, men den är endast avsedd för WCF-kommunikation. Säkerhetsbeteendet kan konfigureras med hjälp av den valfria securityMode parametern i konstruktorn. Användningen av WS-ReliableMessaging kan konfigureras med hjälp av den valfria reliableSessionEnabled parametern. Men tillförlitliga meddelanden är inaktiverade som standard. Mer allmänt är HTTP-systembaserade bindningar som WSHttpBinding och BasicHttpBinding konfigurerade för att aktivera saker som standard, medan bindningen NetTcpBinding inaktiverar saker som standard så att du måste anmäla dig för att få stöd, till exempel för en av WS-* specifikationerna. Det innebär att standardkonfigurationen för TCP är snabbare vid utbyte av meddelanden mellan slutpunkter än den som konfigurerats för HTTP-bindningarna som standard.
Varning
NetTcpBinding Använder TCP-anslutningspooler baserat på tjänstens värd-DNS-namn och det portnummer som tjänsten lyssnar på. Detta fungerar bra när en klient anropar olika tjänster på olika portar, eller om tjänster hanteras i en enda process och delar en port. Om en enskild klient anropar flera tjänster som delar en port som finns i olika processer, eller är WAS/IIS värdhanterade, kan pooleringen på klientsidan leda till problem där en anslutning till Tjänst A återanvänds för Service B, vilket resulterar i ett undantag som utlöses, anslutningen avbröts och en ny kanal skapades. Undvik det här problemet genom att använda custombinding och ange en annan ConnectionPoolSettings.GroupName för varje tjänst som klienten kommunicerar med.
Konstruktorer
| Name | Description |
|---|---|
| NetTcpBinding() |
Initierar en ny instans av NetTcpBinding klassen. |
| NetTcpBinding(SecurityMode, Boolean) |
Initierar en ny instans av NetTcpBinding klassen med den typ av säkerhet som används angivet och med ett värde som anger om tillförlitliga sessioner uttryckligen är aktiverade. |
| NetTcpBinding(SecurityMode) |
Initierar en ny instans av NetTcpBinding klassen med den typ av säkerhet som används angiven. |
| NetTcpBinding(String) |
Initierar en ny instans av NetTcpBinding klassen med ett angivet konfigurationsnamn. |
Egenskaper
| Name | Description |
|---|---|
| CloseTimeout |
Hämtar eller anger tidsintervallet för en anslutning som ska stängas innan transporten skapar ett undantag. (Ärvd från Binding) |
| EnvelopeVersion |
Hämtar den version av SOAP som används för meddelanden som bearbetas av den här bindningen. |
| HostNameComparisonMode |
Hämtar eller anger ett värde som anger om värdnamnet används för att nå tjänsten när URI:n matchas. |
| ListenBacklog |
Hämtar eller anger det maximala antalet köade anslutningsbegäranden som kan vänta. |
| MaxBufferPoolSize |
Hämtar eller anger den maximala storleken i byte som tillåts för en buffertpool som lagrar TCP-meddelanden som bearbetas av bindningen. |
| MaxBufferSize |
Hämtar eller anger ett värde som anger den maximala storleken i byte för bufferten som används för att lagra meddelanden i minnet. |
| MaxConnections |
Hämtar eller anger ett värde som styr det maximala antalet anslutningar som ska poolas för efterföljande återanvändning på klienten och det maximala antalet anslutningar som tillåts vänta på att skickas på servern. |
| MaxReceivedMessageSize |
Hämtar eller anger den maximala storleken i byte för ett mottaget meddelande som bearbetas av bindningen. |
| MessageVersion |
Hämtar meddelandeversionen som används av klienter och tjänster som konfigurerats med bindningen. (Ärvd från Binding) |
| Name |
Hämtar eller anger namnet på bindningen. (Ärvd från Binding) |
| Namespace |
Hämtar eller anger XML-namnområdet för bindningen. (Ärvd från Binding) |
| OpenTimeout |
Hämtar eller anger tidsintervallet för en anslutning som ska öppnas innan transporten skapar ett undantag. (Ärvd från Binding) |
| PortSharingEnabled |
Hämtar eller anger ett värde som anger om TCP-portdelning är aktiverat för anslutningen som konfigurerats med den här bindningen. |
| ReaderQuotas |
Hämtar eller anger begränsningar för komplexiteten i SOAP-meddelanden som kan bearbetas av slutpunkter som konfigurerats med den här bindningen. |
| ReceiveTimeout |
Hämtar eller anger det tidsintervall som en anslutning kan förbli inaktiv under vilken inga programmeddelanden tas emot innan den tas bort. (Ärvd från Binding) |
| ReliableSession |
Hämtar ett objekt som anger om en tillförlitlig session upprättas mellan kanalslutpunkter. |
| Scheme |
Returnerar URI-schemat för transporten. |
| Security |
Hämtar ett objekt som anger vilken typ av säkerhet som används med tjänster som konfigurerats med den här bindningen. |
| SendTimeout |
Hämtar eller anger tidsintervallet för en skrivåtgärd som ska slutföras innan transporten genererar ett undantag. (Ärvd från Binding) |
| TransactionFlow |
Hämtar eller anger ett värde som avgör om transaktionsflödet är aktiverat. |
| TransactionProtocol |
Hämtar eller anger det transaktionsprotokoll som används av tjänsten för att flöda transaktioner. |
| TransferMode |
Hämtar eller anger ett värde som anger om tjänsten som konfigurerats med bindningen använder strömmade eller buffrade (eller båda) lägen för meddelandeöverföring. |
Metoder
| Name | Description |
|---|---|
| BuildChannelFactory<TChannel>(BindingParameterCollection) |
Skapar kanalfabriksstacken på klienten som skapar en angiven typ av kanal och som uppfyller de funktioner som anges av en samling bindningsparametrar. (Ärvd från Binding) |
| BuildChannelFactory<TChannel>(Object[]) |
Skapar kanalfabriksstacken på klienten som skapar en angiven typ av kanal och som uppfyller de funktioner som anges av en objektmatris. (Ärvd från Binding) |
| BuildChannelListener<TChannel>(BindingParameterCollection) |
Skapar kanallyssnaren på tjänsten som accepterar en angiven typ av kanal och som uppfyller de funktioner som anges av en samling bindningsparametrar. (Ärvd från Binding) |
| BuildChannelListener<TChannel>(Object[]) |
Skapar kanallyssnaren på tjänsten som accepterar en angiven typ av kanal och som uppfyller de angivna funktionerna. (Ärvd från Binding) |
| BuildChannelListener<TChannel>(Uri, BindingParameterCollection) |
Skapar kanallyssnaren på tjänsten som accepterar en angiven typ av kanal och som uppfyller de angivna funktionerna. (Ärvd från Binding) |
| BuildChannelListener<TChannel>(Uri, Object[]) |
Skapar kanallyssnaren på tjänsten som accepterar en angiven typ av kanal och som uppfyller de angivna funktionerna. (Ärvd från Binding) |
| BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) |
Skapar kanallyssnaren på tjänsten som accepterar en angiven typ av kanal och som uppfyller de angivna funktionerna. (Ärvd från Binding) |
| BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) |
Skapar kanallyssnaren på tjänsten som accepterar en angiven typ av kanal och som uppfyller de angivna funktionerna. (Ärvd från Binding) |
| BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) |
Skapar kanallyssnaren på tjänsten som accepterar en angiven typ av kanal och som uppfyller de angivna funktionerna. (Ärvd från Binding) |
| BuildChannelListener<TChannel>(Uri, String, Object[]) |
Skapar kanallyssnaren på tjänsten som accepterar en angiven typ av kanal och som uppfyller de angivna funktionerna. (Ärvd från Binding) |
| CanBuildChannelFactory<TChannel>(BindingParameterCollection) |
Returnerar ett värde som anger om den aktuella bindningen kan skapa en kanalfabriksstack på klienten som uppfyller samlingen med angivna bindningsparametrar. (Ärvd från Binding) |
| CanBuildChannelFactory<TChannel>(Object[]) |
Returnerar ett värde som anger om den aktuella bindningen kan skapa en kanalfabriksstack på klienten som uppfyller de krav som anges av en objektmatris. (Ärvd från Binding) |
| CanBuildChannelListener<TChannel>(BindingParameterCollection) |
Returnerar ett värde som anger om den aktuella bindningen kan skapa en kanallyssningsstack på tjänsten som uppfyller den angivna samlingen med bindningsparametrar. (Ärvd från Binding) |
| CanBuildChannelListener<TChannel>(Object[]) |
Returnerar ett värde som anger om den aktuella bindningen kan skapa en kanallyssningsstack på tjänsten som uppfyller de villkor som anges i en matris med objekt. (Ärvd från Binding) |
| CreateBindingElements() |
Skapar en samling med bindningselementen för bindningen. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetProperty<T>(BindingParameterCollection) |
Returnerar ett typat objekt som begärs, om det finns, från lämpligt lager i bindningsstacken. (Ärvd från Binding) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ShouldSerializeListenBacklog() |
Returnerar ett värde som anger om egenskapen ListenBacklog har ändrats från standardvärdet och ska serialiseras. |
| ShouldSerializeMaxConnections() |
Returnerar ett värde som anger om egenskapen MaxConnections har ändrats från standardvärdet och ska serialiseras. |
| ShouldSerializeName() |
Returnerar om namnet på bindningen ska serialiseras. (Ärvd från Binding) |
| ShouldSerializeNamespace() |
Returnerar om bindningens namnområde ska serialiseras. (Ärvd från Binding) |
| ShouldSerializeReaderQuotas() |
Returnerar ett värde som anger om egenskapen ReaderQuotas har ändrats från standardvärdet och ska serialiseras. |
| ShouldSerializeReliableSession() |
Returnerar ett värde som anger om egenskapen ReliableSession har ändrats från standardvärdet och ska serialiseras. |
| ShouldSerializeSecurity() |
Returnerar ett värde som anger om egenskapen Security har ändrats från standardvärdet och ska serialiseras. |
| ShouldSerializeTransactionProtocol() |
Returnerar ett värde som anger om egenskapen TransactionProtocol har ändrats från standardvärdet och ska serialiseras. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
Explicita gränssnittsimplementeringar
| Name | Description |
|---|---|
| IBindingRuntimePreferences.ReceiveSynchronously |
Hämtar ett värde som anger om inkommande begäranden hanteras synkront eller asynkront. |
