WSHttpBinding クラス

リファレンス

定義

名前空間:: System.ServiceModel

アセンブリ:: System.ServiceModel.Http.dll

アセンブリ:: System.ServiceModel.dll

パッケージ:: System.ServiceModel.Http v8.0.0

ソース:: WSHttpBinding.cs

ソース:: WSHttpBinding.cs

ソース:: WSHttpBinding.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

分散トランザクションとセキュリティで保護された信頼できるセッションをサポートする相互操作可能なバインドを表します。

public ref class WSHttpBinding : System::ServiceModel::WSHttpBindingBase

public class WSHttpBinding : System.ServiceModel.WSHttpBindingBase

type WSHttpBinding = class
    inherit WSHttpBindingBase

Public Class WSHttpBinding
Inherits WSHttpBindingBase

継承: Object

Binding

WSHttpBindingBase
WSHttpBinding

派生: System.ServiceModel.Federation.WSFederationHttpBinding

System.ServiceModel.WS2007HttpBinding

System.ServiceModel.WSHttpContextBinding

例

WSHttpBinding クラスを使用するコード例を次に示します。

using System;
using System.ServiceModel;
using System.Collections.Generic;
using System.IdentityModel.Tokens;
using System.Security.Cryptography.X509Certificates;
using System.ServiceModel.Channels;
using System.ServiceModel.Security;
using System.ServiceModel.Security.Tokens;
using System.Security.Permissions;

// Define a service contract for the calculator.
[ServiceContract()]
public interface ICalculator
{
    [OperationContract(IsOneWay = false)]
    double Add(double n1, double n2);
    [OperationContract(IsOneWay = false)]
    double Subtract(double n1, double n2);
    [OperationContract(IsOneWay = false)]
    double Multiply(double n1, double n2);
    [OperationContract(IsOneWay = false)]
    double Divide(double n1, double n2);
}

public sealed class CustomBindingCreator
{

    public static void snippetSecurity()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        WSHttpSecurity whSecurity = wsHttpBinding.Security;
    }

    public static void snippetCreateBindingElements()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        BindingElementCollection beCollection = wsHttpBinding.CreateBindingElements();
    }

    private void snippetCreateMessageSecurity()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        // SecurityBindingElement sbe = wsHttpBinding
    }

    public static void snippetGetTransport()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        //		TransportBindingElement tbElement = wsHttpBinding.GetTransport();
    }

    public static void snippetAllowCookies()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        wsHttpBinding.AllowCookies = true;
    }

    public static Binding GetBinding()
    {
        // securityMode is Message
        // reliableSessionEnabled is true
        WSHttpBinding binding = new WSHttpBinding(SecurityMode.Message, true);
        binding.Security.Message.ClientCredentialType = MessageCredentialType.Windows;

        WSHttpSecurity security = binding.Security;
        return binding;
    }

    public static Binding GetBinding2()
    {

        // The security mode is set to Message.
        WSHttpBinding binding = new WSHttpBinding(SecurityMode.Message);
        binding.Security.Message.ClientCredentialType = MessageCredentialType.Windows;
        return binding;
    }

    // This method creates a WSFederationHttpBinding.
    public static WSFederationHttpBinding CreateWSFederationHttpBinding()
    {
        // Create an instance of the WSFederationHttpBinding
        WSFederationHttpBinding b = new WSFederationHttpBinding();

        // Set the security mode to Message
        b.Security.Mode = WSFederationHttpSecurityMode.Message;

        // Set the Algorithm Suite to Basic256Rsa15
        b.Security.Message.AlgorithmSuite = SecurityAlgorithmSuite.Basic256Rsa15;

        // Set NegotiateServiceCredential to true
        b.Security.Message.NegotiateServiceCredential = true;

        // Set IssuedKeyType to Symmetric
        b.Security.Message.IssuedKeyType = SecurityKeyType.SymmetricKey;

        // Set IssuedTokenType to SAML 1.1
        b.Security.Message.IssuedTokenType = "http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#samlv1.1";

        // Extract the STS certificate from the certificate store
        X509Store store = new X509Store(StoreName.TrustedPeople, StoreLocation.CurrentUser);
        store.Open(OpenFlags.ReadOnly);
        X509Certificate2Collection certs = store.Certificates.Find(X509FindType.FindByThumbprint, "cd 54 88 85 0d 63 db ac 92 59 05 af ce b8 b1 de c3 67 9e 3f", false);
        store.Close();

        // Create an EndpointIdentity from the STS certificate
        EndpointIdentity identity = EndpointIdentity.CreateX509CertificateIdentity(certs[0]);

        // Set the IssuerAddress using the address of the STS and the previously created EndpointIdentity
        b.Security.Message.IssuerAddress = new EndpointAddress(new Uri("http://localhost:8000/sts/x509"), identity);

        // Set the IssuerBinding to a WSHttpBinding loaded from config
        b.Security.Message.IssuerBinding = new WSHttpBinding("Issuer");

        // Set the IssuerMetadataAddress using the metadata address of the STS and the previously created EndpointIdentity
        b.Security.Message.IssuerMetadataAddress = new EndpointAddress(new Uri("http://localhost:8001/sts/mex"), identity);

        // Create a ClaimTypeRequirement
        ClaimTypeRequirement ctr = new ClaimTypeRequirement("http://example.org/claim/c1", false);

        // Add the ClaimTypeRequirement to ClaimTypeRequirements
        b.Security.Message.ClaimTypeRequirements.Add(ctr);

        // Return the created binding
        return b;
    }
}

// Service class which implements the service contract.
public class CalculatorService : ICalculator
{
    public double Add(double n1, double n2)
    {
        double result = n1 + n2; return result;
    }
    public double Subtract(double n1, double n2)
    {
        double result = n1 - n2; return result;
    }
    public double Multiply(double n1, double n2)
    {
        double result = n1 * n2; return result;
    }
    public double Divide(double n1, double n2)
    {
        double result = n1 / n2; return result;
    }

    // Host the service within this EXE console application.
    public static void Main()
    {
        // Create a WSHttpBinding and set its property values.
        WSHttpBinding binding = new WSHttpBinding();
        binding.Name = "binding1";
        binding.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;
        binding.Security.Mode = SecurityMode.Message;
        binding.ReliableSession.Enabled = false;
        binding.TransactionFlow = false;
        //Specify a base address for the service endpoint.
        Uri baseAddress = new Uri(@"http://localhost:8000/servicemodelsamples/service");
        // Create a ServiceHost for the CalculatorService type
        // and provide it with a base address.
        ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);
        serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, baseAddress);
        // Open the ServiceHostBase to create listeners
        // and start listening for messages.
        serviceHost.Open();
        // The service can now be accessed.
        Console.WriteLine("The service is ready.");
        Console.WriteLine("Press <ENTER> to terminate service.");
        Console.WriteLine(); Console.ReadLine();
        // Close the ServiceHost to shutdown the service.
        serviceHost.Close();
    }
}


Imports System.ServiceModel
Imports System.Collections.Generic
Imports System.IdentityModel.Tokens
Imports System.Security.Cryptography.X509Certificates
Imports System.ServiceModel.Channels
Imports System.ServiceModel.Security
Imports System.ServiceModel.Security.Tokens
Imports System.Security.Permissions

' Define a service contract for the calculator. 
<ServiceContract()> _
Public Interface ICalculator
    <OperationContract(IsOneWay := False)> _
    Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double
    <OperationContract(IsOneWay := False)> _
    Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double
    <OperationContract(IsOneWay := False)> _
    Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double
    <OperationContract(IsOneWay := False)> _
    Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double
End Interface

Public NotInheritable Class CustomBindingCreator

    Public Shared Sub snippetSecurity()
        Dim wsHttpBinding As New WSHttpBinding()
        Dim whSecurity As WSHttpSecurity = wsHttpBinding.Security
    End Sub


    Public Shared Sub snippetCreateBindingElements()
        Dim wsHttpBinding As New WSHttpBinding()
        Dim beCollection As BindingElementCollection = wsHttpBinding.CreateBindingElements()
    End Sub


    Private Sub snippetCreateMessageSecurity()
        Dim wsHttpBinding As New WSHttpBinding()
    End Sub

    Public Shared Sub snippetGetTransport()
        Dim wsHttpBinding As New WSHttpBinding()
    End Sub

    Public Shared Sub snippetAllowCookies()
        Dim wsHttpBinding As New WSHttpBinding()
        wsHttpBinding.AllowCookies = True
    End Sub

    Public Shared Function GetBinding() As Binding
        ' securityMode is Message
        ' reliableSessionEnabled is true
        Dim binding As New WSHttpBinding(SecurityMode.Message, True)
        binding.Security.Message.ClientCredentialType = MessageCredentialType.Windows

        Dim security As WSHttpSecurity = binding.Security
        Return binding

    End Function

    Public Shared Function GetBinding2() As Binding

        ' The security mode is set to Message.
        Dim binding As New WSHttpBinding(SecurityMode.Message)
        binding.Security.Message.ClientCredentialType = MessageCredentialType.Windows
        Return binding

    End Function

    ' This method creates a WSFederationHttpBinding.
    Public Shared Function CreateWSFederationHttpBinding() As WSFederationHttpBinding
        ' Create an instance of the WSFederationHttpBinding
        Dim b As New WSFederationHttpBinding()

        ' Set the security mode to Message
        b.Security.Mode = WSFederationHttpSecurityMode.Message

        ' Set the Algorithm Suite to Basic256Rsa15
        b.Security.Message.AlgorithmSuite = SecurityAlgorithmSuite.Basic256Rsa15

        ' Set NegotiateServiceCredential to true
        b.Security.Message.NegotiateServiceCredential = True

        ' Set IssuedKeyType to Symmetric
        b.Security.Message.IssuedKeyType = SecurityKeyType.SymmetricKey

        ' Set IssuedTokenType to SAML 1.1
        b.Security.Message.IssuedTokenType = "http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#samlv1.1"

        ' Extract the STS certificate from the certificate store
        Dim store As New X509Store(StoreName.TrustedPeople, StoreLocation.CurrentUser)
        store.Open(OpenFlags.ReadOnly)
        Dim certs As X509Certificate2Collection = store.Certificates.Find(X509FindType.FindByThumbprint, "cd 54 88 85 0d 63 db ac 92 59 05 af ce b8 b1 de c3 67 9e 3f", False)
        store.Close()

        ' Create an EndpointIdentity from the STS certificate
        Dim identity As EndpointIdentity = EndpointIdentity.CreateX509CertificateIdentity(certs(0))

        ' Set the IssuerAddress using the address of the STS and the previously created EndpointIdentity
        b.Security.Message.IssuerAddress = New EndpointAddress(New Uri("http://localhost:8000/sts/x509"), identity)

        ' Set the IssuerBinding to a WSHttpBinding loaded from config
        b.Security.Message.IssuerBinding = New WSHttpBinding("Issuer")

        ' Set the IssuerMetadataAddress using the metadata address of the STS and the previously created EndpointIdentity
        b.Security.Message.IssuerMetadataAddress = New EndpointAddress(New Uri("http://localhost:8001/sts/mex"), identity)

        ' Create a ClaimTypeRequirement
        Dim ctr As New ClaimTypeRequirement("http://example.org/claim/c1", False)

        ' Add the ClaimTypeRequirement to ClaimTypeRequirements
        b.Security.Message.ClaimTypeRequirements.Add(ctr)

        ' Return the created binding
        Return b
    End Function

End Class

' Service class which implements the service contract. 
Public Class CalculatorService
    Implements ICalculator
    Public Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Add
        Dim result = n1 + n2
        Return result
    End Function
    Public Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Subtract
        Dim result = n1 - n2
        Return result
    End Function
    Public Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Multiply
        Dim result = n1 * n2
        Return result
    End Function
    Public Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Divide
        Dim result = n1 / n2
        Return result
    End Function


    ' Host the service within this EXE console application. 
    Public Shared Sub Main()
        ' Create a WSHttpBinding and set its property values. 
        Dim binding As New WSHttpBinding()
        With binding
            .Name = "binding1"
            .HostNameComparisonMode = HostNameComparisonMode.StrongWildcard
            .Security.Mode = SecurityMode.Message
            .ReliableSession.Enabled = False
            .TransactionFlow = False
        End With
        
        'Specify a base address for the service endpoint. 
        Dim baseAddress As New Uri("http://localhost:8000/servicemodelsamples/service")
        ' Create a ServiceHost for the CalculatorService type 
        ' and provide it with a base address. 
        Dim serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)
        serviceHost.AddServiceEndpoint(GetType(ICalculator), binding, baseAddress)
        ' Open the ServiceHostBase to create listeners 
        ' and start listening for messages. 
        serviceHost.Open()
        ' The service can now be accessed. 
        Console.WriteLine("The service is ready.")
        Console.WriteLine("Press <ENTER> to terminate service.")
        Console.WriteLine()
        Console.ReadLine()
        ' Close the ServiceHost to shutdown the service. 
        serviceHost.Close()
    End Sub
End Class

注釈

WSHttpBinding は BasicHttpBinding に似ていますが、より多くの Web サービス機能を提供します。 BasicHttpBinding と同じように HTTP トランスポートを使用し、メッセージセキュリティを提供します。さらに、トランザクション、信頼できるメッセージング、および WS-Addressing も提供します。これらは、既定で有効化されているか、または単一の制御設定により使用可能となります。

コンストラクター

WSHttpBinding()	WSHttpBinding クラスの新しいインスタンスを初期化します。
WSHttpBinding(SecurityMode)	バインドで使用されるセキュリティの種類を指定して、WSHttpBinding クラスの新しいインスタンスを初期化します。
WSHttpBinding(SecurityMode, Boolean)	バインドで使用するセキュリティの種類と、信頼できるセッションを有効にするかどうかを示す値を指定して、WSHttpBinding クラスの新しいインスタンスを初期化します。
WSHttpBinding(String)	構成名で指定されたバインディングを使用して、WSHttpBinding クラスの新しいインスタンスを初期化します。

プロパティ

AllowCookies	WCF クライアントが単一の Web サービスから送信されたクッキーを自動的に格納し、再送するかどうかを示す値を取得または設定します。
BypassProxyOnLocal	ローカルアドレスに対してプロキシサーバーをバイパスするかどうかを示す値を取得します。値の設定も可能です。 (継承元 WSHttpBindingBase)
CloseTimeout	接続の終了を待機する時間間隔を取得および設定します。これを超えるとトランスポートで例外が発生します。 (継承元 Binding)
EnvelopeVersion	このバインドによって処理されるメッセージに使用される SOAP のバージョンを取得します。 (継承元 WSHttpBindingBase)
HostNameComparisonMode	URI が一致した場合にサービスに到達するためにホスト名を使用するかどうかを示す値を取得または設定します。 (継承元 WSHttpBindingBase)
MaxBufferPoolSize	このバイディングを使用するエンドポイントが必要とするバッファーを管理するバッファーマネージャーに割り当てるメモリの最大量 (バイト単位) を取得または設定します。 (継承元 WSHttpBindingBase)
MaxReceivedMessageSize	バインディングで処理可能なメッセージの最大サイズ (バイト単位) を取得または設定します。 (継承元 WSHttpBindingBase)
MessageEncoding	SOAP メッセージのエンコードに MTOM または Text/XML が使用されるかどうかを取得または設定します。 (継承元 WSHttpBindingBase)
MessageVersion	バインディングで構成されるクライアントとサービスが使用するメッセージバージョンを取得します。 (継承元 Binding)
Name	バインディングの名前を取得または設定します。 (継承元 Binding)
Namespace	バインドの XML 名前空間を取得または設定します。 (継承元 Binding)
OpenTimeout	接続の確立を待機する時間間隔を取得および設定します。これを超えるとトランスポートで例外が発生します。 (継承元 Binding)
ProxyAddress	HTTP プロキシの URI アドレスを取得または設定します。 (継承元 WSHttpBindingBase)
ReaderQuotas	このバインディングを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を取得または設定します。 (継承元 WSHttpBindingBase)
ReceiveTimeout	アプリケーションメッセージが受信されない間に、接続が非アクティブになってから切断されるまでの時間を取得または設定します。 (継承元 Binding)
ReliableSession	システム指定のバインディングのいずれかを使用したときに使用できる、信頼できるセッションのバインド要素のプロパティにアクセスする便利な方法を提供するオブジェクトを取得します。 (継承元 WSHttpBindingBase)
Scheme	このバインディングで構成されたチャネルとリスナーのための URI トランスポートスキームを取得します。 (継承元 WSHttpBindingBase)
Security	このバインディングで使用されるセキュリティ設定を取得します。
SendTimeout	書き込み操作の完了を待機する時間間隔を取得および設定します。これを超えるとトランスポートで例外が発生します。 (継承元 Binding)
TextEncoding	メッセージテキストに使用される文字エンコーディングを取得または設定します。 (継承元 WSHttpBindingBase)
TransactionFlow	このバインディングが WS-Transactions のフローをサポートするかどうかを示す値を取得または設定します。 (継承元 WSHttpBindingBase)
UseDefaultWebProxy	使用できる場合にシステムの自動構成される HTTP プロキシを使用するかどうかを示す値を取得または設定します。 (継承元 WSHttpBindingBase)

メソッド

BuildChannelFactory<TChannel>(BindingParameterCollection)	指定した種類のチャネルを作成し、バインドパラメーターのコレクションで指定されている機能を満たすチャネルファクトリスタックを、クライアント上に構築します。
BuildChannelFactory<TChannel>(BindingParameterCollection)	指定した種類のチャネルを作成し、バインドパラメーターのコレクションで指定されている機能を満たすチャネルファクトリスタックを、クライアント上に構築します。 (継承元 Binding)
BuildChannelFactory<TChannel>(Object[])	指定した種類のチャネルを作成し、オブジェクト配列で指定されている機能を満たすチャネルファクトリスタックを、クライアント上に構築します。 (継承元 Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	指定した種類のチャネルを受け入れ、バインドパラメーターのコレクションで指定されている機能を満たすチャネルリスナーを、サービス上に構築します。 (継承元 Binding)
BuildChannelListener<TChannel>(Object[])	指定した種類のチャネルを受け入れ、指定した機能を満たすチャネルリスナーを、サービス上に構築します。 (継承元 Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	指定した種類のチャネルを受け入れ、指定した機能を満たすチャネルリスナーを、サービス上に構築します。 (継承元 Binding)
BuildChannelListener<TChannel>(Uri, Object[])	指定した種類のチャネルを受け入れ、指定した機能を満たすチャネルリスナーを、サービス上に構築します。 (継承元 Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	指定した種類のチャネルを受け入れ、指定した機能を満たすチャネルリスナーを、サービス上に構築します。 (継承元 Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	指定した種類のチャネルを受け入れ、指定した機能を満たすチャネルリスナーを、サービス上に構築します。 (継承元 Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	指定した種類のチャネルを受け入れ、指定した機能を満たすチャネルリスナーを、サービス上に構築します。 (継承元 Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	指定した種類のチャネルを受け入れ、指定した機能を満たすチャネルリスナーを、サービス上に構築します。 (継承元 Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	指定したバインドパラメーターのコレクションを満たすチャネルファクトリスタックを、現在のバインドがクライアント上に構築できるかどうかを示す値を返します。 (継承元 Binding)
CanBuildChannelFactory<TChannel>(Object[])	オブジェクト配列で指定した要件を満たすチャネルファクトリスタックを、現在のバインドがクライアント上に構築できるかどうかを示す値を返します。 (継承元 Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	指定したバインドパラメーターのコレクションを満たすチャネルリスナースタックを、現在のバインドがサービス上に構築できるかどうかを示す値を返します。 (継承元 Binding)
CanBuildChannelListener<TChannel>(Object[])	オブジェクトの配列で指定した条件を満たすチャネルリスナースタックを、現在のバインドがサービス上に構築できるかどうかを示す値を返します。 (継承元 Binding)
CreateBindingElements()	現在のバインディングに含まれるバインディング要素の順序付けられたコレクションを返します。
CreateMessageSecurity()	現在のバインドからセキュリティバインド要素を返します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetProperty<T>(BindingParameterCollection)	バインドスタックの適切な層から、要求のあった型指定されたオブジェクト (ある場合) を返します。 (継承元 Binding)
GetTransport()	現在のバインドからトランスポートバインド要素を返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ShouldSerializeName()	バインドの名前をシリアル化する必要があるかどうかを示す値を返します。 (継承元 Binding)
ShouldSerializeNamespace()	バインドの名前空間をシリアル化する必要があるかどうかを示す値を返します。 (継承元 Binding)
ShouldSerializeReaderQuotas()	ReaderQuotas プロパティが既定値から変更されたためにシリアル化する必要があるかどうかを示す値を返します。 (継承元 WSHttpBindingBase)
ShouldSerializeReliableSession()	ReliableSession プロパティが既定値から変更されたためにシリアル化する必要があるかどうかを示す値を返します。 (継承元 WSHttpBindingBase)
ShouldSerializeSecurity()	Security プロパティが既定値から変更されたためにシリアル化する必要があるかどうかを示す値を返します。
ShouldSerializeTextEncoding()	TextEncoding プロパティが既定値から変更されたためにシリアル化する必要があるかどうかを示す値を返します。 (継承元 WSHttpBindingBase)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

明示的なインターフェイスの実装

IBindingRuntimePreferences.ReceiveSynchronously

受信要求を同期処理するか、または非同期処理するかを示す値を取得します。

(継承元 WSHttpBindingBase)

適用対象

次の方法で共有