Compartir vía


NetTcpBinding Clase

Definición

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
NetTcpBinding
Derivado
Implementaciones

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