Share via


<netTcpContextBinding>

保護レベルの署名を求める NetTcpBinding のコンテキストを指定します。NetTcpContextBinding の contextExchangeMechanism は、SOAPHeader です。

スキーマの階層

<system.serviceModel>
  <bindings>
    <netTcpContextBinding>

構文

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

属性と要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性 説明

closeTimeout

クローズ操作が完了するまでの期間を指定する TimeSpan 値。この値は必ず Zero 以上である必要があります。既定値は 00:01:00 です。

contextProtectionLevel

コンテキスト情報の反映に使用される SOAP ヘッダーの必要な保護レベルを指定する、有効な ProtectionLevel 値。既定値は、Sign です。

hostnameComparisonMode

URI の解析に使用する HTTP ホスト名比較モードを指定します。この属性は HostnameComparisonMode 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。既定値は StrongWildcard で、一致しているホスト名を無視します。

listenBacklog

リスナーで受け入れを待機するチャネルの最大数を指定する正の整数。この制限を超えた接続は、制限内に空きができるまでキューに置かれます。connectionTimeout 属性は、クライアントが接続を待つ時間を制限します。この時間が経過すると接続の例外をスローします。既定値は 10 です。

maxBufferPoolSize

このバインディングに使用するバッファー プール サイズの上限を指定する整数。既定は 512 * 1024 バイトです。Windows Communication Foundation (WCF) では、多くの部分でバッファーを使用します。使用するたびに毎回バッファーを作成および破棄すると負荷が高くなります。バッファーのガベージ コレクションも同様です。バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。これで、バッファーの作成と破壊のオーバーヘッドを回避できます。

maxBufferSize

メッセージをメモリに保存するのに使用するバッファーの最大サイズをバイト単位で指定する正の整数。バッファーがいっぱいになると、超過データは、バッファーに空きが出るまで、基になるソケットに残されます。この値が maxReceivedMessageSize 属性の値を下回らないようにしてください。既定値は 65536 です。詳細については、「MaxBufferSize」を参照してください。

maxConnections

サービスが作成し受け付ける発信/着信接続数の上限を指定する整数。この属性により指定された別個の制限に対して、着信接続および発信接続がカウントされます。

制限を超える着信接続は、制限内に空きができるまでキューに置かれます。

制限を超える発信接続は、制限内に空きができるまでキューに置かれます。

既定値は 10 です。

maxReceivedMessageSize

このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ (ヘッダーを含む) をバイト単位で指定する正の整数。この制限を超えるメッセージの送信者が、SOAP エラーを受信します。受信者がメッセージをドロップし、トレース ログにそのイベントのエントリを作成します。既定値は 65536 です。

name

バインディングの構成名を格納する文字列。この値は、バインディングの ID として使用されるため、一意にする必要があります。.NET Framework 4 以降では、バインディングおよび動作に名前を付ける必要はありません。既定の構成、および名前のないバインディングと動作の詳細については、「Simplified Configuration」および「Simplified Configuration for WCF Services」を参照してください。

openTimeout

実行中の操作が完了するまでの時間間隔を指定する TimeSpan 値です。この値は必ず Zero 以上である必要があります。既定値は 00:01:00 です。

portSharingEnabled

TCP ポート共有をこの接続で有効にするかどうかを指定するブール値。これが false の場合、各バインドは独自の排他ポートを使用します。クライアントには影響しないため、この設定はサービスのみに関連します。

receiveTimeout

受信操作が完了するまでの時間間隔を指定する TimeSpan 値です。この値は必ず Zero 以上である必要があります。既定値は 00:10:00 です。

sendTimeout

送信操作が完了するまでの時間間隔を指定する TimeSpan 値です。この値は必ず Zero 以上である必要があります。既定値は 00:01:00 です。

transactionFlow

バインディングが WS-Transactions のフローをサポートするかどうかを指定するブール値です。既定値は false です。

transactionProtocol

このバインディングで使用されるトランザクション プロトコルを指定します。有効な値は、以下のとおりです。

  • OleTransactions

  • WSAtomicTransactionOctober2004

既定値は OleTransactions です。この属性は TransactionProtocol 型です。

transferMode

メッセージが要求や応答をバッファーするか、ストリーミングするかを指定する TransferMode 値です。

子要素

要素 説明

<netTcpBinding> の <security>

バインディングのセキュリティ設定を定義します。この要素は NetTcpSecurityElement 型です。

<readerQuotas>

このバインディングを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。この要素は XmlDictionaryReaderQuotasElement 型です。

reliableSession

チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを指定します。

親要素

要素 説明

<bindings>

この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。

参照

リファレンス

<<netTcpBinding>>
NetTcpBinding
netTcpContextBinding
netTcpContextBindingElement
ContextBindingElement

概念

<binding>

その他のリソース

Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients