<Nettcpcontextbinding>

Artykuł
07/07/2023

Określa kontekst, który NetTcpBinding wymaga podpisania poziomu ochrony. ContextExchangeMechanism for NetTcpContextBinding to SOAPHeader.

<Konfiguracji>
  <System.servicemodel>
    <Powiązania>
      <Nettcpcontextbinding>

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	Opis
closeTimeout	TimeSpan Wartość określająca interwał czasu określony dla zakończenia operacji zamknięcia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
contextProtectionLevel	Prawidłowa ProtectionLevel wartość określająca żądany poziom ochrony nagłówka SOAP używanego do propagowania informacji kontekstowych. Wartość domyślna to Sign.
Hostnamecomparisonmode	Określa tryb porównania nazwy hosta HTTP używany do analizowania identyfikatorów URI. Ten atrybut jest typu HostNameComparisonMode, który wskazuje, czy nazwa hosta jest używana do dotarcia do usługi podczas dopasowywania identyfikatora URI. Wartość domyślna to StrongWildcard, która ignoruje nazwę hosta w dopasowaniu.
listenBacklog	Dodatnia liczba całkowita określająca maksymalną liczbę kanałów oczekujących na zaakceptowanie na odbiorniku. Połączenia przekraczające ten limit są kolejkowane do momentu, aż miejsce poniżej limitu stanie się dostępne. Atrybut `connectionTimeout` ogranicza czas oczekiwania klienta na połączenie przed zgłoszeniem wyjątku połączenia. Wartość domyślna to 10.
Maxbufferpoolsize	Liczba całkowita określająca maksymalny rozmiar puli buforów dla tego powiązania. Wartość domyślna to 512 * 1024 bajty. Wiele części programu Windows Communication Foundation (WCF) używa buforów. Tworzenie i niszczenie buforów za każdym razem, gdy są używane, jest kosztowne, a odzyskiwanie pamięci dla buforów jest również kosztowne. W przypadku pul buforów można pobrać bufor z puli, użyć go i wrócić do puli po zakończeniu pracy. W związku z tym unika się nakładu pracy podczas tworzenia i niszczenia buforów.
Maxbuffersize	Dodatnia liczba całkowita określająca maksymalny rozmiar w bajtach buforu używanego do przechowywania komunikatów w pamięci. Jeśli bufor jest pełny, nadmiar danych pozostaje w gniazdie bazowym, aż bufor ponownie będzie miał miejsce. Ta wartość nie może być mniejsza niż `maxReceivedMessageSize` atrybut. Wartość domyślna to 65536. Aby uzyskać więcej informacji, zobacz MaxBufferSize.
Maxconnections	Liczba całkowita określająca maksymalną liczbę połączeń wychodzących i przychodzących, które usługa utworzy/zaakceptuje. Połączenia przychodzące i wychodzące są liczone względem oddzielnego limitu określonego przez ten atrybut. Połączenia przychodzące przekraczające limit są kolejkowane do momentu, gdy miejsce poniżej limitu stanie się dostępne. Połączenia wychodzące przekraczające limit są kolejkowane do momentu, gdy miejsce poniżej limitu stanie się dostępne. Wartość domyślna to 10.
Maxreceivedmessagesize	Dodatnia liczba całkowita określająca maksymalny rozmiar komunikatu w bajtach, w tym nagłówki, które można odebrać w kanale skonfigurowanym za pomocą tego powiązania. Nadawca komunikatu przekraczającego ten limit otrzyma błąd PROTOKOŁU SOAP. Odbiorca pominie komunikat i tworzy wpis zdarzenia w dzienniku śledzenia. Wartość domyślna to 65536.
name	Ciąg zawierający nazwę konfiguracji powiązania. Ta wartość powinna być unikatowa, ponieważ jest używana jako identyfikacja powiązania. Począwszy od .NET Framework 4, powiązania i zachowania nie muszą mieć nazwy. Aby uzyskać więcej informacji na temat domyślnej konfiguracji i bez nazw powiązań i zachowań, zobacz Uproszczone konfigurowanie i uproszczona konfiguracja dla usług WCF.
openTimeout	TimeSpan Wartość określająca interwał czasu określony dla operacji otwierania do ukończenia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
portSharingEnabled	Wartość logiczna określająca, czy udostępnianie portów TCP jest włączone dla tego połączenia. Jeśli jest `false`to , każde powiązanie używa własnego portu wyłącznego. To ustawienie jest istotne tylko dla usług, ponieważ nie ma to wpływu na klientów.
Receivetimeout	TimeSpan Wartość określająca interwał czasu określony dla wykonania operacji odbierania. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:10:00.
sendTimeout	TimeSpan Wartość określająca interwał czasu określony dla operacji wysyłania do ukończenia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
transactionFlow	Wartość logiczna określająca, czy powiązanie obsługuje przepływ transakcji WS-Transactions. Wartość domyślna to `false`.
Transactionprotocol	Określa protokół transakcji do użycia z tym powiązaniem. Prawidłowe wartości to -Oletransactions - WSAtomicTransactionOctober2004 Wartość domyślna to OleTransactions. Ten atrybut jest typu TransactionProtocol.
Transfermode	TransferMode Wartość określająca, czy komunikaty są buforowane, czy przesyłane strumieniowo, czy też żądanie lub odpowiedź.

Elementy podrzędne

Element	Opis
<Zabezpieczeń>	Definiuje ustawienia zabezpieczeń powiązania. Ten element jest typu NetTcpSecurityElement.
<Readerquotas>	Definiuje ograniczenia dotyczące złożoności komunikatów PROTOKOŁU SOAP, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego powiązania. Ten element jest typu XmlDictionaryReaderQuotasElement.
<reliableSession>	Określa, czy niezawodne sesje są ustanawiane między punktami końcowymi kanału.

Elementy nadrzędne

Element	Opis
<Powiązania>	Ten element zawiera kolekcję powiązań standardowych i niestandardowych.

Udostępnij za pośrednictwem