<netTcpContextBinding>

Artigo
05/10/2023

Especifica um contexto para o NetTcpBinding que exige que o nível de proteção seja assinado. O contextExchangeMechanism para NetTcpContextBinding é SOAPHeader.

<configuration>
  <system.serviceModel>
    <bindings>
      <netTcpContextBinding>

Syntax

<netTcpContextBinding>
  <binding closeTimeout="TimeSpan"
           contextProtectionLevel="EncryptAndSign/None/Sign"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           listenBacklog="Integer"
           maxBufferPoolSize="integer"
           maxBufferSize="Integer"
           maxConnections="Integer"
           maxReceivedMessageSize="Integer"
           name="string"
           openTimeout="TimeSpan"
           portSharingEnabled="Boolean"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           transactionFlow="Boolean"
           transactionProtocol="OleTransactions/WSAtomicTransactionOctober2004"
           transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse">
    <reliableSession ordered="Boolean"
                     inactivityTimeout="TimeSpan"
                     enabled="Boolean" />
    <security mode="Message/None/Transport/TransportWithCredential">
      <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 realm="String"
                 defaultClientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 defaultProxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 defaultRealm="String" />
      <message clientCredentialType="Certificate/IssuedToken/None/UserName/Windows"
               algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
               establishSecurityContext="Boolean"
               negotiateServiceCredential="Boolean" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</netTcpContextBinding>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Descrição
closeTimeout	Um valor TimeSpan que especifica o intervalo de tempo para a conclusão de uma operação de fechamento. Esse valor deve ser igual ou superior a Zero. O padrão é 00:01:00.
contextProtectionLevel	Um valor ProtectionLevel válido que especifica o nível de proteção desejado do cabeçalho SOAP usado para propagar as informações de contexto. O valor padrão é Sign.
hostnameComparisonMode	Especifica o modo de comparação de nome do host HTTP usado para analisar URIs. Esse atributo é do tipo HostNameComparisonMode, o que indica se o nome do host é usado para acessar o serviço ao fazer correspondência no URI. O valor padrão é StrongWildcard, que ignora o nome do host na correspondência.
listenBacklog	Um inteiro positivo que especifica o número máximo de canais aguardando para serem aceitos no ouvinte. As conexões acima do limite serão colocadas na fila até que um espaço abaixo do limite fique disponível. O atributo `connectionTimeout` limita o tempo que o cliente aguardará para ser conectado antes de lançar uma exceção de conexão. O padrão é 10.
maxBufferPoolSize	Um inteiro que especifica o tamanho máximo do pool de buffers para essa associação. O padrão é 512 * 1024 bytes. Muitas partes do WCF (Windows Communication Foundation) usam buffers. Criar e destruir buffers cada vez que eles são usados é caro, e a coleta de lixo para buffers também é cara. Com os pools de buffers, você pode pegar um buffer do pool, usá-lo e devolvê-lo ao pool assim que terminar. Portanto, a sobrecarga na criação e na destruição de buffers é evitada.
maxBufferSize	Um inteiro positivo que especifica o tamanho máximo, em bytes, do buffer usado para armazenar mensagens na memória. Se o buffer estiver cheio, o excesso de dados permanecerá no soquete subjacente até que o buffer tenha espaço novamente. Esse valor não pode ser menor que o `maxReceivedMessageSize` atributo. O padrão é 65536. Para obter mais informações, consulte MaxBufferSize.
maxConnections	Um inteiro que especifica o número máximo de conexões de saída e de entrada que o serviço criará/aceitará. As conexões de entrada e saída são contadas em relação a um limite separado especificado por esse atributo. As conexões de entrada acima do limite serão colocadas na fila até que um espaço abaixo do limite fique disponível. As conexões de saída acima do limite serão colocadas na fila até que um espaço abaixo do limite fique disponível. O padrão é 10.
maxReceivedMessageSize	Um inteiro positivo que especifica o tamanho máximo da mensagem, em bytes, incluindo cabeçalhos, que pode ser recebido em um canal configurado com essa associação. O remetente de uma mensagem que exceder esse limite receberá uma falha SOAP. O receptor remove a mensagem e cria uma entrada do evento no log de rastreamento. O padrão é 65536.
name	Uma cadeia de caracteres que contém o nome de configuração da associação. Esse valor deve ser exclusivo, pois é usado como uma identificação para a associação. A partir do .NET Framework 4, associações e comportamentos não precisam ter um nome. Para obter mais informações sobre a configuração padrão e as associações sem nome, incluindo os comportamentos, confira Configuração Simplificada e Configuração Simplificada para Serviços WCF.
openTimeout	Um valor TimeSpan que especifica o intervalo de tempo fornecido para a conclusão de uma operação de abertura. Esse valor deve ser igual ou superior a Zero. O padrão é 00:01:00.
portSharingEnabled	Um valor booliano que especifica se o compartilhamento de porta TCP está habilitado para essa conexão. Se for `false`, cada associação usará sua própria porta exclusiva. Essa configuração é relevante apenas para os serviços, pois os clientes não são afetados.
receiveTimeout	Um valor TimeSpan que especifica o intervalo de tempo para a conclusão de uma operação de recebimento. Esse valor deve ser igual ou superior a Zero. O padrão é 00:10:00.
sendTimeout	Um valor TimeSpan que especifica o intervalo de tempo para a conclusão de uma operação de envio. Esse valor deve ser igual ou superior a Zero. O padrão é 00:01:00.
transactionFlow	Um valor booliano que especifica se a associação dá suporte ao fluxo de WS-Transactions. O padrão é `false`.
transactionProtocol	Especifica o protocolo de transação a ser usado com essa associação. Os valores válidos são - OleTransactions – WSAtomicTransactionOctober2004 O padrão é OleTransactions. Esse atributo é do tipo TransactionProtocol.
transferMode	Um valor TransferMode que especifica se as mensagens são armazenadas em buffer ou transmitidas por streaming ou uma solicitação ou resposta.

Elementos filho

Elemento	Descrição
<security>	Define as configurações de segurança da associação. Esse elemento é do tipo NetTcpSecurityElement.
<readerQuotas>	Define as restrições sobre a complexidade das mensagens SOAP que podem ser processadas pelos pontos de extremidade configurados com essa associação. Esse elemento é do tipo XmlDictionaryReaderQuotasElement.
<reliableSession>	Especifica se sessões as confiáveis são estabelecidas entre pontos de extremidade de canal.

Elementos pai

Elemento	Descrição
<bindings>	Esse elemento contém uma coleção de associações padrão e personalizadas.

Compartilhar via