NetTcpBinding Clase
Definición
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 máquinas.
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- Herencia
- 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
Genera NetTcpBinding 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 de Windows Communication Foundation (WCF) para comunicarse a través de una intranet.
La configuración predeterminada de NetTcpBinding es más rápida que la configuración proporcionada por , WSHttpBindingpero solo está pensada para la comunicación WCF. El comportamiento de seguridad se puede configurar mediante el parámetro opcional securityMode en el constructor. El uso de WS-ReliableMessaging se puede configurar mediante el parámetro opcional reliableSessionEnabled . Pero la mensajería confiable está desactivada de forma predeterminada. Por lo general, los enlaces proporcionados por el sistema HTTP como WSHttpBinding y BasicHttpBinding están configurados para activar las cosas de forma predeterminada, mientras que el NetTcpBinding enlace desactiva las cosas de forma predeterminada para que tenga que optar por obtener soporte técnico, por ejemplo, para una de las especificaciones WS-*. Esto significa que la configuración predeterminada para TCP es más rápida al intercambiar mensajes entre puntos de conexión que los configurados para los enlaces HTTP de forma predeterminada.
Advertencia
NetTcpBinding usa la agrupación de conexiones TCP en función del nombre DNS del 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 distintos puertos 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 se hospedan 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
| Nombre | Description |
|---|---|
| NetTcpBinding() |
Inicializa una nueva instancia de la clase NetTcpBinding. |
| NetTcpBinding(SecurityMode, Boolean) |
Inicializa una nueva instancia de la NetTcpBinding clase con el tipo de seguridad utilizado y con un valor que indica si las sesiones confiables están habilitadas explícitamente. |
| NetTcpBinding(SecurityMode) |
Inicializa una nueva instancia de la NetTcpBinding clase con el tipo de seguridad usado especificado. |
| NetTcpBinding(String) |
Inicializa una nueva instancia de la NetTcpBinding clase con un nombre de configuración especificado. |
Propiedades
| Nombre | Description |
|---|---|
| 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 usa para los mensajes procesados por este enlace. |
| HostNameComparisonMode |
Obtiene o establece un valor que indica si el nombre de host se usa para llegar al servicio al buscar coincidencias 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, en bytes, permitido para un grupo de búferes que almacena los 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 mensajes en la 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 posterior 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, de un mensaje recibido procesado por el enlace. |
| MessageVersion |
Obtiene la versión del mensaje utilizada por 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 se abra una conexión 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 puertos TCP está habilitado para la conexión configurada con este enlace. |
| ReaderQuotas |
Obtiene o establece restricciones sobre la complejidad de los mensajes SOAP que pueden procesar los puntos de conexión configurados con este enlace. |
| ReceiveTimeout |
Obtiene o establece el intervalo de tiempo que una conexión puede permanecer inactiva, durante la cual no se recibe ningún mensaje de aplicación, antes de quitarla. (Heredado de Binding) |
| ReliableSession |
Obtiene un objeto que indica si se establece una sesión confiable entre puntos de conexión de canal. |
| Scheme |
Devuelve el esquema URI para el transporte. |
| Security |
Obtiene un objeto que especifica el tipo de seguridad utilizado con los servicios configurados con este enlace. |
| SendTimeout |
Obtiene o establece el intervalo de tiempo proporcionado para que se complete una operación de escritura antes de que el transporte genere una excepción. (Heredado de Binding) |
| TransactionFlow |
Obtiene o establece un valor que determina si el flujo de transacción está habilitado. |
| TransactionProtocol |
Obtiene o establece el protocolo de transacciones utilizado por el servicio para fluir las transacciones. |
| TransferMode |
Obtiene o establece un valor que indica si el servicio configurado con el enlace usa modos transmitidos o almacenados en búfer (o ambos) de transferencia de mensajes. |
Métodos
| Nombre | Description |
|---|---|
| BuildChannelFactory<TChannel>(BindingParameterCollection) |
Compila la pila de generador de canales en el cliente que crea un tipo de canal especificado y que satisface las características especificadas por una colección de parámetros de enlace. (Heredado de Binding) |
| BuildChannelFactory<TChannel>(Object[]) |
Compila la pila del generador de canales en el cliente que crea un tipo de canal especificado y que satisface las características especificadas por una matriz de objetos. (Heredado de Binding) |
| BuildChannelListener<TChannel>(BindingParameterCollection) |
Compila el agente de escucha de canal en el servicio que acepta un tipo de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que satisface las características especificadas. (Heredado de Binding) |
| CanBuildChannelFactory<TChannel>(BindingParameterCollection) |
Devuelve un valor que indica si el enlace actual puede crear una pila de generador de canales en el cliente que satisfaga la colección de parámetros de enlace especificados. (Heredado de Binding) |
| CanBuildChannelFactory<TChannel>(Object[]) |
Devuelve un valor que indica si el enlace actual puede crear una pila de generador de canales en el cliente que cumpla los requisitos especificados por una matriz de objetos. (Heredado de Binding) |
| CanBuildChannelListener<TChannel>(BindingParameterCollection) |
Devuelve un valor que indica si el enlace actual puede crear una pila del agente de escucha de canal en el servicio que satisface la colección de parámetros de enlace especificados. (Heredado de Binding) |
| CanBuildChannelListener<TChannel>(Object[]) |
Devuelve un valor que indica si el enlace actual puede crear una pila del agente de escucha de canal en el servicio que cumpla los criterios especificados en una matriz de objetos. (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 al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa como función hash predeterminada. (Heredado de Object) |
| GetProperty<T>(BindingParameterCollection) |
Devuelve un objeto con tipo solicitado, si está presente, de la capa adecuada en la pila de enlace. (Heredado de Binding) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| ShouldSerializeListenBacklog() |
Devuelve un valor que indica si la ListenBacklog propiedad ha cambiado de su valor predeterminado y se debe serializar. |
| ShouldSerializeMaxConnections() |
Devuelve un valor que indica si la MaxConnections propiedad ha cambiado de su valor predeterminado y se debe serializar. |
| ShouldSerializeName() |
Devuelve si se debe serializar el nombre del enlace. (Heredado de Binding) |
| ShouldSerializeNamespace() |
Devuelve si se debe serializar el espacio de nombres del enlace. (Heredado de Binding) |
| ShouldSerializeReaderQuotas() |
Devuelve un valor que indica si la ReaderQuotas propiedad ha cambiado de su valor predeterminado y se debe serializar. |
| ShouldSerializeReliableSession() |
Devuelve un valor que indica si la ReliableSession propiedad ha cambiado de su valor predeterminado y se debe serializar. |
| ShouldSerializeSecurity() |
Devuelve un valor que indica si la Security propiedad ha cambiado de su valor predeterminado y se debe serializar. |
| ShouldSerializeTransactionProtocol() |
Devuelve un valor que indica si la TransactionProtocol propiedad ha cambiado 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
| Nombre | Description |
|---|---|
| IBindingRuntimePreferences.ReceiveSynchronously |
Obtiene un valor que indica si las solicitudes entrantes se controlan de forma sincrónica o asincrónica. |
