次の方法で共有

<basicHttpContextBinding>

交換メカニズムとして HTTP Cookie を有効にして、 BasicHttpBinding のコンテキストを提供するバインディングを指定します。

<configuration>
  <system.serviceModel>
    <bindings>
      <basicHttpContextBinding>

構文

<basicHttpContextBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="Integer"
           maxBufferSize="Integer"
           maxReceivedMessageSize="Integer"
           messageEncoding="Text/Mtom"
           name="String"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
           transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
           useDefaultWebProxy="Boolean">
    <security mode="None/Transport/Message/TransportWithMessageCredential/TransportCredentialOnly">
      <transport clientCredentialType="None/Basic/Digest/Ntlm/Windows/Certificate"
                 proxyCredentialType="None/Basic/Digest/Ntlm/Windows"
                 realm="String" />
      <message algorithmSuite="Aes128/Aes192/Aes256/Rsa15Aes128/ Rsa15Aes256/TripleDes"
               clientCredentialType="UserName/Certificate" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</basicHttpContextBinding>

属性および要素

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

Attributes

特性 Description
allowCookies クライアントが Cookie を受け入れ、今後の要求に反映するかどうかを示すブール値。 既定値は falseです。

このプロパティは、Cookie を使用する ASMX Web サービスと対話するときに使用できます。 この方法では、サーバーから返された Cookie が、そのサービスに対する今後のすべてのクライアント要求に自動的にコピーされることを確認できます。
bypassProxyOnLocal ローカル アドレスのプロキシ サーバーをバイパスするかどうかを示すブール値。 既定値は falseです。

インターネット リソースは、ローカル アドレスを持つ場合はローカルです。 ローカル アドレスは、同じコンピューター、ローカル LAN、またはイントラネット上にあり、URI http://webserver/ や http://localhost/のようにピリオド (.) がないために構文的に識別されます。

この属性を設定すると、BasicHttpBinding で構成されたエンドポイントがローカル リソースにアクセスするときにプロキシ サーバーを使用するかどうかが決まります。 この属性が trueされている場合、ローカル インターネット リソースへの要求ではプロキシ サーバーは使用されません。 この属性が trueに設定されているときに、同じコンピューター上のサービスと通信するときにクライアントがプロキシを経由する場合は、(localhost ではなく) ホスト名を使用します。

この属性が falseされると、すべてのインターネット要求がプロキシ サーバー経由で行われます。
closeTimeout 閉じる操作が完了するまでに指定された時間間隔を指定する TimeSpan 値。 この値は、 Zero以上である必要があります。 既定値は 00:01:00 です。
hostNameComparisonMode URI の解析に使用する HTTP ホスト名比較モードを指定します。 この属性は HostNameComparisonMode 型であり、URI で照合するときにホスト名を使用してサービスに到達するかどうかを示します。 既定値は StrongWildcard であり、一致するホスト名は無視されます。
maxBufferPoolSize チャネルからメッセージを受信するメッセージ バッファーのマネージャーが使用するために割り当てられるメモリの最大量を指定する整数値。 既定値は 524288 (0x80000) バイトです。

バッファー マネージャーは、バッファー プールを使用してバッファーを使用するコストを最小限に抑えます。 バッファーは、チャネルから出るときにサービスによってメッセージを処理するために必要です。 バッファー プールにメッセージの読み込みを処理するための十分なメモリがない場合、バッファー マネージャーは CLR ヒープから追加のメモリを割り当てる必要があり、ガベージ コレクションのオーバーヘッドが増加します。 CLR ガベージ ヒープからの広範な割り当ては、バッファー プールのサイズが小さすぎること、およびこの属性で指定された制限を大きくすることで、割り当てが大きくなるとパフォーマンスを向上できることを示しています。
maxBufferSize このバインディングで構成されたエンドポイントに対してメッセージが処理されている間にメッセージを格納するバッファーの最大サイズをバイト単位で指定する整数値。 既定値は 65,536 バイトです。
maxReceivedMessageSize このバインディングで構成されたチャネルで受信できるメッセージの最大メッセージ サイズ (ヘッダーを含むバイト単位) を定義する正の整数。 メッセージが受信者に対して大きすぎる場合、送信者は SOAP エラーを受信します。 受信側はメッセージを削除し、トレース ログにイベントのエントリを作成します。 既定値は 65,536 バイトです。
messageEncoding SOAP メッセージのエンコードに使用するエンコーダーを定義します。 有効な値は次のとおりです。

- テキスト: テキスト メッセージ エンコーダーを使用します。
- Mtom: メッセージ送信組織メカニズム 1.0 (MTOM) エンコーダーを使用します。

既定値は Text です。 この属性は WSMessageEncoding型です。
messageVersion バインディングで構成されたクライアントとサービスによって使用されるメッセージのバージョンを指定します。 この属性は MessageVersion型です。
name バインディングの構成名を含む文字列。 この値は、バインディングの ID として使用されるため、一意である必要があります。 .NET Framework 4 以降では、バインドと動作に名前を付ける必要はありません。 既定の構成と名前のないバインディングと動作の詳細については、「WCF サービスの 簡略化された構成 と 簡略化された構成」を参照してください。
openTimeout 開いている操作が完了するまでに指定された時間間隔を指定する TimeSpan 値。 この値は、 Zero以上である必要があります。 既定値は 00:01:00 です。
proxyAddress HTTP プロキシのアドレスを含む URI。 useSystemWebProxyが true に設定されている場合は、この設定をnullする必要があります。 既定値は nullです。
receiveTimeout 受信操作が完了するまでの時間間隔を指定する TimeSpan 値。 この値は、 Zero以上である必要があります。 既定値は 00:10:00 です。
sendTimeout 送信操作が完了するまでに指定された時間間隔を指定する TimeSpan 値。 この値は、 Zero以上である必要があります。 既定値は 00:01:00 です。
textEncoding バインディングでメッセージを出力するために使用する文字セット エンコードを設定します。 有効な値は次のとおりです。

- BigEndianUnicode: Unicode BigEndian エンコード。
- Unicode: 16 ビット エンコード。
- UTF8: 8 ビット エンコード

既定値は UTF8 です。 この属性は Encoding型です。
transferMode メッセージをバッファー処理するか、要求または応答でストリーミングするかを指定する有効な TransferMode 値。
useDefaultWebProxy システムの自動構成 HTTP プロキシを使用する必要があるかどうかを指定するブール値 (使用可能な場合)。 既定値は trueです。

子要素

要素 Description
<安全> バインディングのセキュリティ設定を定義します。 この要素は BasicHttpSecurityElement型です。
<readerQuotas> このバインディングで構成されたエンドポイントによって処理できる SOAP メッセージの複雑さに関する制約を定義します。 この要素は XmlDictionaryReaderQuotasElement型です。

親要素

要素 Description
<バインド> この要素は、標準バインドとカスタム バインドのコレクションを保持します。

注釈

このバインド要素は、 BasicHttpBindingのコンテキストの一部として、保護レベルと交換メカニズムを提供します。

こちらも参照ください

  • Last updated on