NetTcpBinding Clase

Referencia

Definición

Espacio de nombres:: System.ServiceModel

Ensamblado:: System.ServiceModel.NetTcp.dll

Ensamblado:: System.ServiceModel.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Un enlace seguro y confiable adecuado para la comunicación entre equipos.

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

Herencia: Object

Binding
NetTcpBinding

Derivado: System.ServiceModel.NetTcpContextBinding

Implementaciones: IBindingRuntimePreferences

Ejemplos

En este ejemplo se muestra cómo crear un NetTcpBinding, estableciendo el modo de seguridad y el tipo de credencial de transporte.

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

Comentarios

NetTcpBinding Genera una pila de comunicación en tiempo de ejecución de forma predeterminada, que usa la seguridad de transporte, TCP para la entrega de mensajes y una codificación de mensajes binarios. Este enlace es una opción adecuada proporcionada por el sistema Windows Communication Foundation (WCF) para comunicarse a través de una intranet.

La configuración predeterminada para NetTcpBinding es más rápida que la configuración proporcionada por , WSHttpBindingpero está pensada solo para la comunicación de WCF. El comportamiento de seguridad es configurable mediante el parámetro opcional securityMode en el constructor. El uso de WS-ReliableMessaging es configurable utilizando el parámetro reliableSessionEnabled opcional. Pero la mensajería de confianza está apagada de forma predeterminada. Más generalmente, los enlaces proporcionados por el sistema HTTP como WSHttpBinding y BasicHttpBinding se configuran para activar de forma predeterminada las cosas, mientras que el enlace NetTcpBinding desactiva de forma predeterminada las cosas para que tenga que inscribirse para obtener compatibilidad, por ejemplo, para una de las especificaciones de WS-*. Esto significa que la configuración predeterminada para TCP es más rápida en intercambiar los mensajes entre los extremos que la configurada de forma predeterminada para los enlaces HTTP.

Advertencia

NetTcpBinding usa la agrupación de conexiones TCP en función del nombre DNS de host del servicio y el número de puerto en el que escucha el servicio. Esto funciona bien cuando un cliente realiza llamadas a diferentes servicios en puertos diferentes o los servicios se hospedan en un único proceso y comparten un puerto. Si un solo cliente llama a varios servicios que comparten un puerto hospedado en procesos diferentes o están hospedados en WAS/IIS, la agrupación del lado cliente puede provocar problemas en los que se reutiliza una conexión al servicio A para el servicio B, lo que da lugar a una excepción que se produce, se anula la conexión y se crea un nuevo canal. Para evitar este problema, use customBinding y especifique un connectionPoolSettings.GroupName diferente para cada servicio con el que se comunica el cliente.

Constructores

NetTcpBinding()	Inicializa una nueva instancia de la clase NetTcpBinding.
NetTcpBinding(SecurityMode)	Inicializa una instancia nueva de la clase NetTcpBinding con el tipo de seguridad utilizado especificado.
NetTcpBinding(SecurityMode, Boolean)	Inicializa una instancia nueva de la clase NetTcpBinding con el tipo de seguridad utilizado especificado, y con un valor que indica si se habilitan explícitamente las sesiones de confianza.
NetTcpBinding(String)	Inicializa una instancia nueva de la clase NetTcpBinding con el nombre de configuración especificado.

Propiedades

CloseTimeout	Obtiene o establece el intervalo de tiempo proporcionado para que una conexión se cierre antes de que el transporte genere una excepción. (Heredado de Binding)
EnvelopeVersion	Obtiene la versión de SOAP que se utiliza para los mensajes procesados por este enlace.
HostNameComparisonMode	Obtiene o establece un valor que indica si el nombre del host se usa para alcanzar el servicio al coincidir con el URI.
ListenBacklog	Obtiene o establece el número máximo de solicitudes de conexión en cola que pueden estar pendientes.
MaxBufferPoolSize	Obtiene o establece el tamaño máximo permitido, en bytes, para un grupo de búferes que almacena mensajes TCP procesados por el enlace.
MaxBufferSize	Obtiene o establece un valor que especifica el tamaño máximo, en bytes, del búfer usado para almacenar los mensajes en memoria.
MaxConnections	Obtiene o establece un valor que controla el número máximo de conexiones que se van a agrupar para su reutilización subsiguiente en el cliente y el número máximo de conexiones que pueden estar pendientes de envío en el servidor.
MaxReceivedMessageSize	Obtiene o establece el tamaño máximo, en bytes, para un mensaje recibido que el enlace procesa.
MessageVersion	Obtiene la versión de mensaje utilizada por los clientes y servicios configurados con el enlace. (Heredado de Binding)
Name	Obtiene o establece el nombre del enlace. (Heredado de Binding)
Namespace	Obtiene o establece el espacio de nombres XML del enlace. (Heredado de Binding)
OpenTimeout	Obtiene o establece el intervalo de tiempo proporcionado para que una conexión se abra antes de que el transporte genere una excepción. (Heredado de Binding)
PortSharingEnabled	Obtiene o establece un valor que indica si el uso compartido de puerto TCP está habilitado para la conexión configurada con este enlace.
ReaderQuotas	Obtiene o establece restricciones en la complejidad de mensajes SOAP que pueden ser procesados por puntos de conexión configurados con este enlace.
ReceiveTimeout	Obtiene o establece el intervalo de tiempo que una conexión puede permanecer inactiva, durante el cual no se recibe ningún mensaje de la aplicación, antes de interrumpir la conexión. (Heredado de Binding)
ReliableSession	Obtiene un objeto que indica si se establece una sesión confiable entre los extremos del canal.
Scheme	Devuelve el esquema URI para el transporte.
Security	Obtiene un objeto que especifica el tipo de seguridad utilizado con servicios configurados con este enlace.
SendTimeout	Obtiene o establece el intervalo de tiempo proporcionado para que una operación de escritura se complete antes de que el transporte genere una excepción. (Heredado de Binding)
TransactionFlow	Obtiene o establece un valor que determina si se habilita el flujo de transacciones.
TransactionProtocol	Obtiene o establece el protocolo de transacciones utilizado por el servicio para el flujo de transacciones.
TransferMode	Obtiene o establece un valor que indica si el servicio configurado con el enlace utiliza modos de transmisión o de almacenamiento en búfer (o ambos) para transferir los mensajes.

Métodos

BuildChannelFactory<TChannel>(BindingParameterCollection)	Compila la pila de generador de canales en el cliente que crea un tipo especificado de canal y satisface las características especificadas por una colección de parámetros de enlace. (Heredado de Binding)
BuildChannelFactory<TChannel>(Object[])	Compila la pila de generador de canales en el cliente que crea un tipo especificado de canal y eso satisface las características especificadas por una matriz de objetos. (Heredado de Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y eso satisface las características especificadas por una colección de parámetros de enlace. (Heredado de Binding)
BuildChannelListener<TChannel>(Object[])	Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas. (Heredado de Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas. (Heredado de Binding)
BuildChannelListener<TChannel>(Uri, Object[])	Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas. (Heredado de Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas. (Heredado de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas. (Heredado de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas. (Heredado de Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas. (Heredado de Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Devuelve un valor que indica si el enlace actual puede compilar una pila de generador de canales en el cliente que satisfaga la colección especificada de parámetros de enlace. (Heredado de Binding)
CanBuildChannelFactory<TChannel>(Object[])	Devuelve un valor que indica si el enlace actual puede compilar una pila de generador de canales en el cliente que satisfaga los requisitos especificados por una matriz de objetos. (Heredado de Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	Devuelve un valor que indica si el enlace actual puede compilar un agente de escucha de canal en el servicio que satisfaga la colección especificada de parámetros de enlace. (Heredado de Binding)
CanBuildChannelListener<TChannel>(Object[])	Devuelve un valor que indica si el enlace actual puede compilar un agente de escucha de canal en el servicio que satisfaga la colección especificada de parámetros de enlace. (Heredado de Binding)
CreateBindingElements()	Crea una colección con los elementos de enlace para el enlace.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetProperty<T>(BindingParameterCollection)	Devuelve un objeto escrito solicitado de la capa adecuada en la pila de enlace si está presente. (Heredado de Binding)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ShouldSerializeListenBacklog()	Devuelve un valor que indica si la propiedad ListenBacklog ha cambiado respecto de su valor predeterminado y se debe serializar.
ShouldSerializeMaxConnections()	Devuelve un valor que indica si la propiedad MaxConnections ha cambiado respecto de su valor predeterminado y se debe serializar.
ShouldSerializeName()	Devuelve un valor si se debe serializar el nombre del enlace. (Heredado de Binding)
ShouldSerializeNamespace()	Devuelve un valor si se debe serializar el espacio de nombres. (Heredado de Binding)
ShouldSerializeReaderQuotas()	Devuelve un valor que indica si la propiedad ReaderQuotas ha cambiado respecto de su valor predeterminado y se debe serializar.
ShouldSerializeReliableSession()	Devuelve un valor que indica si la propiedad ReliableSession ha cambiado respecto de su valor predeterminado y se debe serializar.
ShouldSerializeSecurity()	Devuelve un valor que indica si la propiedad Security ha cambiado respecto de su valor predeterminado y se debe serializar.
ShouldSerializeTransactionProtocol()	Devuelve un valor que indica si la propiedad TransactionProtocol ha cambiado respecto de su valor predeterminado y se debe serializar.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

IBindingRuntimePreferences.ReceiveSynchronously

Obtiene un valor que indica si las solicitudes de entrada se administran de forma sincrónica o asincrónica.

Se aplica a