NetTcpBinding Classe

Referência

Definição

Namespace:: System.ServiceModel

Assembly:: System.ServiceModel.NetTcp.dll

Assembly:: System.ServiceModel.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: Object

Binding
NetTcpBinding

Derivado: System.ServiceModel.NetTcpContextBinding

Implementações: IBindingRuntimePreferences

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