<wsHttpContextBinding>
保護レベルの署名を要求する WSHttpBinding のコンテキストを提供します。
configuration
system.serviceModel
<bindings>
wsHttpContextBinding>
構文
<wsHttpContextBinding>
<binding allowCookies="Boolean"
bypassProxyOnLocal="Boolean"
closeTimeout="TimeSpan"
contextProtectionLevel="EncryptAndSign/None/Sign"
hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
maxBufferPoolSize="integer"
maxReceivedMessageSize="Integer"
messageEncoding="Text/Mtom"
name="string"
openTimeout="TimeSpan"
proxyAddress="URI"
receiveTimeout="TimeSpan"
sendTimeout="TimeSpan"
textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
transactionFlow="Boolean"
useDefaultWebProxy="Boolean">
<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>
</wsHttpContextBinding>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 | 説明 |
---|---|
allowCookies | クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。 既定では、 false です。allowCookies が true に設定されると、contextChannel は httpCookies をコンテキストの交換モードとして使用します。 この属性が false に設定されると、コンテキストは、SOAP ヘッダーとして交換されます。既定値は false です。クッキーを使用する ASMX Web サービスと対話する場合にこのプロパティを使用できます。 この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。 |
bypassProxyOnLocal | ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。 既定では、 false です。 |
closeTimeout | クローズ操作が完了するまでの期間を指定する TimeSpan 値。 この値は必ず Zero 以上である必要があります。 既定値は 00:01:00 です。 |
contextProtectionLevel | コンテキスト情報の反映に使用される SOAP ヘッダーの必要な保護レベルを指定する、有効な ProtectionLevel 値。 既定値は Sign です。 |
hostnameComparisonMode | URI の解析に使用する HTTP ホスト名比較モードを指定します。 この属性は HostNameComparisonMode 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。 既定値は StrongWildcard で、一致しているホスト名を無視します。 |
maxBufferPoolSize | このバインディングに使用するバッファー プール サイズの上限を指定する整数。 既定は 524,288 バイト (512 * 1024) です。 Windows Communication Foundation (WCF) では、多くの部分でバッファーを使用します。 使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。 バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。 これで、バッファーの作成と破棄のオーバーヘッドを回避できます。 |
maxReceivedMessageSize | このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ (ヘッダーを含む) をバイト単位で指定する正の整数。 この制限を超えるメッセージの送信者が、SOAP エラーを受信します。 メッセージは受信者によってドロップされ、トレース ログにこのイベントのエントリが作成されます。 既定値は 65536 です。 |
messageEncoding | メッセージのエンコードに使用されるエンコーダーを定義します。 有効な値は次のとおりです。 - Text: テキスト メッセージ エンコーダーを使用します。 - Mtom: Message Transmission Organization Mechanism 1.0 (MTOM) エンコーダーを使用します。 - 既定値は Text です。 この属性は WSMessageEncoding 型です。 |
name | バインディングの構成名を格納する文字列です。 この値は、バインディングの ID として使用されるため、一意にする必要があります。 NET Framework 4 以降では、バインディングおよび動作に名前を付ける必要はありません。 既定の構成と、名前のないバインディングと動作については、「簡略化された構成」と「WCF サービスの簡略化された構成」を参照してください。 |
openTimeout | 実行中の操作が完了するまでの時間間隔を指定する TimeSpan 値です。 この値は必ず Zero 以上である必要があります。 既定値は 00:01:00 です。 |
proxyAddress | HTTP プロキシのアドレスを指定する URI。 useSystemWebProxy が true の場合、この設定を null にする必要があります。 既定では、 null です。 |
receiveTimeout | 受信操作が完了するまでの時間間隔を指定する TimeSpan 値です。 この値は必ず Zero 以上である必要があります。 既定値は 00:01:00 です。 |
sendTimeout | 送信操作が完了するまでの時間間隔を指定する TimeSpan 値です。 この値は必ず Zero 以上である必要があります。 既定値は 00:01:00 です。 |
textEncoding | バインドでメッセージの発行に使用される文字セット エンコーディングを指定します。 有効な値は次のとおりです。 - UnicodeFffeTextEncoding: Unicode BigEndian エンコード。 - Utf16TextEncoding: 16 ビットのエンコード。 - Utf8TextEncoding: 8 ビットのエンコード。 既定値は Utf8TextEncoding です。 この属性は Encoding 型です。 |
transactionFlow | バインディングが WS-Transactions のフローをサポートするかどうかを指定するブール値です。 既定では、 false です。 |
useDefaultWebProxy | システムの自動設定 HTTP プロキシを使用するかどうかを指定するブール値。 既定では、 true です。 |
子要素
要素 | 説明 |
---|---|
<security> | バインディングのセキュリティ設定を定義します。 この要素は WSHttpSecurityElement 型です。 |
<readerQuotas> | このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。 この要素は XmlDictionaryReaderQuotasElement 型です。 |
<reliableSession> | チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを指定します。 |
親要素
要素 | 説明 |
---|---|
<bindings> | この要素には、標準バインディングおよびカスタム バインドのコレクションが保持されます。 |
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET