Partilhar via


NetTcpBinding Classe

Definição

Uma associação segura e confiável adequada para comunicação entre computadores.

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
Herança
NetTcpBinding
Derivado
Implementações

Exemplos

Este exemplo mostra como criar um NetTcpBindingtipo de credencial de transporte e modo de segurança.

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

Comentários

A NetTcpBinding gera uma pilha de comunicação em tempo de execução por padrão, que usa segurança de transporte, TCP para entrega de mensagens e uma codificação de mensagem binária. Essa associação é uma opção adequada fornecida pelo sistema Windows Communication Foundation (WCF) para se comunicar por meio de uma Intranet.

A configuração padrão para o NetTcpBinding é mais rápida do que a configuração fornecida pelo WSHttpBinding, mas destina-se apenas à comunicação WCF. O comportamento de segurança é configurável usando o parâmetro opcional securityMode no construtor. O uso de WS-ReliableMessaging é configurável usando o parâmetro opcional reliableSessionEnabled . Mas as mensagens confiáveis estão desativadas por padrão. Em geral, as associações fornecidas pelo sistema HTTP, como WSHttpBinding e BasicHttpBinding configuradas, são configuradas para ativar as coisas por padrão, enquanto a NetTcpBinding associação desativa as coisas por padrão para que você precise aceitar para obter suporte, por exemplo, para uma das especificações do WS-*. Isso significa que a configuração padrão para TCP é mais rápida na troca de mensagens entre pontos de extremidade do que a configurada para as associações HTTP por padrão.

Aviso

O NetTcpBinding sistema usa o pool de conexões TCP com base no nome DNS do host do serviço e no número da porta em que o serviço está escutando. Isso funciona bem quando um cliente faz chamadas para diferentes serviços em portas diferentes ou os serviços são hospedados em um único processo e compartilham uma porta. Se um único cliente chamar vários serviços que compartilham uma porta hospedada em processos diferentes ou estiverem hospedados no WAS/IIS, o pool do lado do cliente poderá levar a problemas em que uma conexão com o Serviço A é reutilizada para o Serviço B, resultando em uma exceção lançada, a conexão anulada e um novo canal criado. Para evitar esse problema, use um CustomBinding e especifique um ConnectionPoolSettings.GroupName diferente para cada serviço com o qual o cliente se comunica.

Construtores

NetTcpBinding()

Inicializa uma nova instância da classe NetTcpBinding.

NetTcpBinding(SecurityMode)

Inicializa uma nova instância da classe NetTcpBinding com o tipo de segurança usado especificado.

NetTcpBinding(SecurityMode, Boolean)

Inicializa uma nova instância da classe NetTcpBinding com o tipo de segurança usado especificado e com um valor que indica se as sessões confiáveis são habilitadas explicitamente.

NetTcpBinding(String)

Inicializa uma nova instância da classe NetTcpBinding com um nome de configuração especificado.

Propriedades

CloseTimeout

Obtém ou define o intervalo concedido para que uma conexão seja fechada antes que o transporte gere uma exceção.

(Herdado de Binding)
EnvelopeVersion

Obtém a versão do SOAP usada para as mensagens processadas por essa associação.

HostNameComparisonMode

Obtém ou define um valor que indica se o nome do host é usado para acessar o serviço ao corresponder ao URI.

ListenBacklog

Obtém ou define o número máximo de solicitações de conexão na fila que podem estar pendentes.

MaxBufferPoolSize

Obtém ou define o tamanho máximo, em bytes, permitido para um pool de buffers que armazena mensagens TCP processadas pela associação.

MaxBufferSize

Obtém ou define um valor que especifica o tamanho máximo, em bytes, do buffer usado para armazenar mensagens na memória.

MaxConnections

Obtém ou define um valor que controla o número máximo de conexões a serem agrupadas em pool para reutilização posterior no cliente e o número máximo de conexões que podem ter uma expedição pendente no servidor.

MaxReceivedMessageSize

Obtém ou define o tamanho máximo, em bytes, de uma mensagem recebida processada pela associação.

MessageVersion

Obtém a versão de mensagem usada por clientes e serviços configurados com a associação.

(Herdado de Binding)
Name

Obtém ou define o nome da associação.

(Herdado de Binding)
Namespace

Obtém ou define o namespace de XML da associação.

(Herdado de Binding)
OpenTimeout

Obtém ou define o intervalo concedido para que uma conexão seja aberta antes que o transporte gere uma exceção.

(Herdado de Binding)
PortSharingEnabled

Obtém ou define um valor que indica se o compartilhamento de porta TCP está habilitado para a conexão configurada com essa associação.

ReaderQuotas

Obtém ou define as restrições na complexidade das mensagens SOAP que podem ser processadas por pontos de extremidade configurados com essa associação.

ReceiveTimeout

Obtém ou define o intervalo de tempo que uma conexão pode permanecer inativa, durante o qual nenhuma mensagem de aplicativo é recebida, antes de seu descarte.

(Herdado de Binding)
ReliableSession

Obtém um objeto que indica se uma sessão confiável foi estabelecida entre pontos de extremidade do canal.

Scheme

Retorna o esquema do URI para o transporte.

Security

Obtém um objeto que especifica o tipo de segurança usado com serviços configurados com esta associação.

SendTimeout

Obtém ou define o intervalo concedido para uma operação ser concluída antes de o transporte gerar uma exceção.

(Herdado de Binding)
TransactionFlow

Obtém ou define um valor que determina se o fluxo de transação está habilitado.

TransactionProtocol

Obtém ou define o protocolo de transações usado pelo serviço para transações de fluxo.

TransferMode

Obtém ou define um valor que indica se o serviço configurado com a associação usa os modos de transferência de mensagens por transmissão ou armazenamento em buffer (ou ambos).

Métodos

BuildChannelFactory<TChannel>(BindingParameterCollection)

Cria a pilha de fábricas de canais no cliente que cria um tipo de canal especificado e que satisfaz os recursos especificados por uma coleção de parâmetros de associação.

(Herdado de Binding)
BuildChannelFactory<TChannel>(Object[])

Cria a pilha de fábricas de canais no cliente que cria um tipo de canal especificado e que satisfaz os recursos especificados por uma matriz de objetos.

(Herdado de Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)

Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados por uma coleção de parâmetros de associação.

(Herdado de Binding)
BuildChannelListener<TChannel>(Object[])

Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, Object[])

Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados.

(Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])

Cria o ouvinte de canais no serviço que aceita um tipo de canal especificado e que satisfaz os recursos especificados.

(Herdado de Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)

Retorna um valor que indica se a associação atual pode criar uma pilha de fábricas de canais no cliente que satisfaz a coleção de parâmetros de associação especificados.

(Herdado de Binding)
CanBuildChannelFactory<TChannel>(Object[])

Retorna um valor que indica se a associação atual pode criar uma pilha de fábricas de canais no cliente que satisfaz os requisitos especificados por uma matriz de objetos.

(Herdado de Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)

Retorna um valor que indica se a associação atual pode criar uma pilha de ouvintes de canais no serviço que satisfaça a coleção de parâmetros de associação especificados.

(Herdado de Binding)
CanBuildChannelListener<TChannel>(Object[])

Retorna um valor que indica se a associação atual pode criar uma pilha de ouvintes de canais no serviço que satisfaça os critérios especificados em uma matriz de objetos.

(Herdado de Binding)
CreateBindingElements()

Cria uma coleção com os elementos de associação para a associação.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetProperty<T>(BindingParameterCollection)

Retorna um objeto tipado solicitado, se presente, da camada apropriada na pilha de associação.

(Herdado de Binding)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ShouldSerializeListenBacklog()

Retorna um valor que indica se a propriedade ListenBacklog foi alterada do valor padrão e se deve ser serializada.

ShouldSerializeMaxConnections()

Retorna um valor que indica se a propriedade MaxConnections foi alterada do valor padrão e se deve ser serializada.

ShouldSerializeName()

Retorna se o nome da associação deve ser serializado.

(Herdado de Binding)
ShouldSerializeNamespace()

Retorna se o namespace da associação deve ser serializado.

(Herdado de Binding)
ShouldSerializeReaderQuotas()

Retorna um valor que indica se a propriedade ReaderQuotas foi alterada do valor padrão e se deve ser serializada.

ShouldSerializeReliableSession()

Retorna um valor que indica se a propriedade ReliableSession foi alterada do valor padrão e se deve ser serializada.

ShouldSerializeSecurity()

Retorna um valor que indica se a propriedade Security foi alterada do valor padrão e se deve ser serializada.

ShouldSerializeTransactionProtocol()

Retorna um valor que indica se a propriedade TransactionProtocol foi alterada do valor padrão e se deve ser serializada.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

IBindingRuntimePreferences.ReceiveSynchronously

Obtém um valor que indica se as solicitações de entrada são tratadas de forma síncrona ou assíncrona.

Aplica-se a