NetTcpBinding Classe

Definição

Namespace:: System.ServiceModel

Assemblies:: System.ServiceModel.dll, System.ServiceModel.NetTcp.dll

Assembly:: System.ServiceModel.NetTcp.dll

Assembly:: System.ServiceModel.dll

Pacotes:: System.ServiceModel.NetTcp v10.0.652802, System.ServiceModel.Primitives v10.0.652802

Pacote:: System.ServiceModel.NetTcp v10.0.652802

Origem:: NetTcpBinding.cs

Origem:: NetTcpBinding.cs

Origem:: NetTcpBinding.cs

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 máquinas.

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 NetTcpBinding, definindo o modo de segurança e o tipo de credencial de transporte.

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

Comentários

O 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 codificação de mensagem binária. Essa associação é uma opção apropriada fornecida pelo sistema do 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 securityMode opcional no construtor. O uso de WS-ReliableMessaging é configurável usando o parâmetro reliableSessionEnabled opcional. Mas as mensagens confiáveis estão desativadas por padrão. De modo mais geral, as associações fornecidas pelo sistema HTTP, como WSHttpBinding e BasicHttpBinding são configuradas para ativar as coisas por padrão, enquanto a NetTcpBinding associação desativa as coisas por padrão para que você tenha que aceitar para obter suporte, por exemplo, para uma das especificações do WS-*. Isso significa que a configuração padrão do TCP é mais rápida na troca de mensagens entre pontos de extremidade do que a configurada para as associações HTTP por padrão.

Warning

O NetTcpBinding uso do 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 compartilhando uma porta hospedada em processos diferentes ou que estão hospedados em 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 sendo gerada, 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

Nome	Description
NetTcpBinding()	Inicializa uma nova instância da classe NetTcpBinding.
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 estão explicitamente habilitadas.
NetTcpBinding(SecurityMode)	Inicializa uma nova instância da classe NetTcpBinding com o tipo de segurança usado especificado.
NetTcpBinding(String)	Inicializa uma nova instância da classe NetTcpBinding com um nome de configuração especificado.

Propriedades

Nome	Description
CloseTimeout	Obtém ou define o intervalo de tempo fornecido 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 que é usada para mensagens processadas por essa associação.
HostNameComparisonMode	Obtém ou define um valor que indica se o nome do host é usado para alcançar 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 para reutilização subsequente no cliente e o número máximo de conexões permitidas para a expedição pendente no servidor.
MaxReceivedMessageSize	Obtém ou define o tamanho máximo, em bytes, para uma mensagem recebida que é processada pela associação.
MessageVersion	Obtém a versão da 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 XML da associação. (Herdado de Binding)
OpenTimeout	Obtém ou define o intervalo de tempo fornecido 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 restrições sobre a 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 em que uma conexão pode permanecer inativa, durante a qual nenhuma mensagem de aplicativo é recebida, antes de ser descartada. (Herdado de Binding)
ReliableSession	Obtém um objeto que indica se uma sessão confiável é estabelecida entre pontos de extremidade de canal.
Scheme	Retorna o esquema de URI para o transporte.
Security	Obtém um objeto que especifica o tipo de segurança usado com os serviços configurados com essa associação.
SendTimeout	Obtém ou define o intervalo de tempo fornecido para que uma operação de gravação seja concluída antes que o transporte gere 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 fluir transações.
TransferMode	Obtém ou define um valor que indica se o serviço configurado com a associação usa modos transmitidos ou em buffer (ou ambos) de transferência de mensagens.

Métodos

Nome	Description
BuildChannelFactory<TChannel>(BindingParameterCollection)	Cria a pilha de fábrica 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ábrica 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 canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados por uma coleção de parâmetros de associação. (Herdado de Binding)
BuildChannelListener<TChannel>(Object[])	Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados. (Herdado de Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados. (Herdado de Binding)
BuildChannelListener<TChannel>(Uri, Object[])	Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados. (Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados. (Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados. (Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados. (Herdado de Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	Cria o ouvinte de canal no serviço que aceita um tipo de canal especificado e que atende aos recursos especificados. (Herdado de Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Retorna um valor que indica se a associação atual pode criar uma pilha de fábrica de canais no cliente que satisfaça 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ábrica de canais no cliente que atenda aos 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 canal 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 canal no serviço que atenda aos 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 digitado 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 Objectatual. (Herdado de Object)
ShouldSerializeListenBacklog()	Retorna um valor que indica se a ListenBacklog propriedade foi alterada de seu valor padrão e deve ser serializada.
ShouldSerializeMaxConnections()	Retorna um valor que indica se a MaxConnections propriedade foi alterada de seu valor padrão e 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 ReaderQuotas propriedade foi alterada de seu valor padrão e deve ser serializada.
ShouldSerializeReliableSession()	Retorna um valor que indica se a ReliableSession propriedade foi alterada de seu valor padrão e deve ser serializada.
ShouldSerializeSecurity()	Retorna um valor que indica se a Security propriedade foi alterada de seu valor padrão e deve ser serializada.
ShouldSerializeTransactionProtocol()	Retorna um valor que indica se a TransactionProtocol propriedade foi alterada de seu valor padrão e deve ser serializada.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

Nome	Description
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

Comentários

Esta página foi útil?