セールス: 1-800-867-1380

NetOnewayRelayBinding クラス

クラウド経由のセキュリティで保護された一方向接続のバインドを表します。

名前空間:  Microsoft.ServiceBus
アセンブリ:  Microsoft.ServiceBus (Microsoft.ServiceBus.dll)

public class NetOnewayRelayBinding : Binding, 
	IBindingRuntimePreferences

NetOnewayRelayBinding 型は、以下のメンバーを公開しています。

  名前説明
パブリック メソッドNetOnewayRelayBinding()()()()NetOnewayRelayBinding クラスの新しいインスタンスを初期化します。
パブリック メソッドNetOnewayRelayBinding(String)指定された構成を使用して NetOnewayRelayBinding クラスの新しいインスタンスを初期化します。
プロテクト メソッドNetOnewayRelayBinding(NetOnewayRelaySecurity)指定したセキュリティ設定を使用して、NetOnewayRelayBinding クラスの新しいインスタンスを初期化します。
パブリック メソッドNetOnewayRelayBinding(EndToEndSecurityMode, RelayClientAuthenticationType)指定したセキュリティ モードと認証の種類を使用して、NetOnewayRelayBinding クラスの新しいインスタンスを初期化します。
プロテクト メソッドNetOnewayRelayBinding(RelayedOnewayConnectionMode, EndToEndSecurityMode, RelayClientAuthenticationType)指定した接続モード、セキュリティ モード、および認証の種類を使用して、NetOnewayRelayBinding クラスの新しいインスタンスを初期化します。
プロテクト メソッドNetOnewayRelayBinding(RelayedOnewayTransportBindingElement, BinaryMessageEncodingBindingElement, NetOnewayRelaySecurity)指定されたトランスポート、エンコード、およびセキュリティを使用して、NetOnewayRelayBinding クラスの新しいインスタンスを初期化します。
先頭に戻る

  名前説明
パブリック プロパティCloseTimeout (Binding から継承されています。)
パブリック プロパティEnvelopeVersionこのバインドで処理されたメッセージに使用される SOAP のバージョンを取得します。
パブリック プロパティListenBacklogキューに入れて保留できる接続要求の最大数を取得または設定します。
パブリック プロパティMaxBufferPoolSizeバインドによって処理されるメッセージを格納するバッファー プールの最大サイズを取得または設定します。
パブリック プロパティMaxBufferSizeメモリにメッセージを格納するために使用されるバッファーの最大サイズ (バイト単位) を指定する値を取得または設定します。
パブリック プロパティMaxConnectionsクライアントでそれ以降に再利用するためにプールされる接続の最大数と、サーバー上でディスパッチ保留中となることが許可される接続の最大数を制御する値を取得または設定します。
パブリック プロパティMaxReceivedMessageSizeバインドによって処理される受信メッセージの最大サイズを取得または設定します。
プロテクト プロパティMessageSecurityVersionメッセージのセキュリティ バージョンを取得します。
パブリック プロパティMessageVersion (Binding から継承されています。)
パブリック プロパティName (Binding から継承されています。)
パブリック プロパティNamespace (Binding から継承されています。)
パブリック プロパティOpenTimeout (Binding から継承されています。)
パブリック プロパティReaderQuotasこのバインドで構成されたエンドポイントによって処理できる SOAP メッセージの複雑さの制限を取得または設定します。
パブリック プロパティReceiveTimeout (Binding から継承されています。)
パブリック プロパティSchemeトランスポートの URI スキームを取得します。 (Binding..::..Scheme をオーバーライドします。)
パブリック プロパティSecurityこのバインドで構成されたサービスで使用されるセキュリティの種類を指定するオブジェクトを取得します。
パブリック プロパティSendTimeout (Binding から継承されています。)
先頭に戻る

  名前説明
プロテクト メソッドApplyConfiguration指定された名前に対応する構成要素から、このバインド要素の現在のインスタンスに設定を適用します。
パブリック メソッドBuildChannelFactory<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (Binding から継承されています。)
パブリック メソッドBuildChannelFactory<(Of <<'(TChannel>)>>)(BindingParameterCollection) (Binding から継承されています。)
パブリック メソッドBuildChannelListener<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (Binding から継承されています。)
パブリック メソッドBuildChannelListener<(Of <<'(TChannel>)>>)(BindingParameterCollection) (Binding から継承されています。)
パブリック メソッドBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, array<Object>[]()[][]) (Binding から継承されています。)
パブリック メソッドBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, BindingParameterCollection) (Binding から継承されています。)
パブリック メソッドBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, array<Object>[]()[][]) (Binding から継承されています。)
パブリック メソッドBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, BindingParameterCollection) (Binding から継承されています。)
パブリック メソッドBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, ListenUriMode, array<Object>[]()[][]) (Binding から継承されています。)
パブリック メソッドBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, ListenUriMode, BindingParameterCollection) (Binding から継承されています。)
パブリック メソッドCanBuildChannelFactory<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (Binding から継承されています。)
パブリック メソッドCanBuildChannelFactory<(Of <<'(TChannel>)>>)(BindingParameterCollection) (Binding から継承されています。)
パブリック メソッドCanBuildChannelListener<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (Binding から継承されています。)
パブリック メソッドCanBuildChannelListener<(Of <<'(TChannel>)>>)(BindingParameterCollection) (Binding から継承されています。)
パブリック メソッドCreateBindingElementsバインド要素のセットを作成します。 (Binding..::..CreateBindingElements()()()() をオーバーライドします。)
パブリック メソッドEquals (Object から継承されています。)
プロテクト メソッドFinalize (Object から継承されています。)
パブリック メソッドGetHashCode (Object から継承されています。)
パブリック メソッドGetProperty<(Of <<'(T>)>>) (Binding から継承されています。)
パブリック メソッドGetType (Object から継承されています。)
プロテクト メソッドMemberwiseClone (Object から継承されています。)
パブリック メソッドShouldSerializeName (Binding から継承されています。)
パブリック メソッドShouldSerializeNamespace (Binding から継承されています。)
パブリック メソッドToString (Object から継承されています。)
先頭に戻る

  名前説明
プロテクト フィールドencodingバインドのエンコードを表します。エンコードは、セキュリティ設定やトランスポートの種類と並ぶ、バインドの 3 つのコア プロパティです。
プロテクト フィールドtransportバインドのトランスポートの種類を表します。トランスポートの種類は、エンコード設定やセキュリティ設定と並ぶ、バインドの 3 つのコア プロパティです。
先頭に戻る

  名前説明
明示的なインターフェイスの実装プライベート プロパティIBindingRuntimePreferences..::..ReceiveSynchronously受信した要求を処理するには同期と非同期のどちらの方が効率的かを示す値を取得します。
先頭に戻る

注意

By default, NetOnewayRelayBinding uses Transport Security.

Windows Azure Service Bus supports only Full Trust code access security.

The following example shows how to define and use NetOneWayRelayBinding with the default configuration for a service and client in an application configuration file.

<system.serviceModel>

  <bindings>
    <!-- Application Binding -->
    <netOnewayRelayBinding>
      <binding name="default" />
    </netOnewayRelayBinding>
  </bindings>

  <client>
    <!-- Application Endpoint -->
    <endpoint name="RelayEndpoint"
              contract="Microsoft.ServiceBus.Samples.IOnewayContract"
              binding="netOnewayRelayBinding"
              bindingConfiguration="default"
              behaviorConfiguration="ReplaceWithEndpointBehaviorName"
              address="ReplaceWithEndpointAddress" />
  </client>

  <services>
    <service name="Microsoft.ServiceBus.Samples.OnewayService">
      <!-- Keep address empty to use host base address, or -->
      <!-- replace with endpoint address. -->
      <endpoint name="RelayEndpoint"
                contract="Microsoft.ServiceBus.Samples.IOnewayContract"                   
                binding="netOnewayRelayBinding" 
                bindingConfiguration="default"
                behaviorConfiguration="ReplaceWithEndpointBehaviorName"
                address="" />
    </service>
  </services>
     
  <behaviors>
    <endpointBehaviors>
      <!-- Add endpoint behavior here. -->
    </endpointBehaviors>
  </behaviors>

</system.serviceModel>

The following example is similar to the previous example except that it defines a custom configuration for NetOneWayRelayBinding. It turns off the security mode and client authentication, which means that SOAP messages are sent unsecured and that the client is not required to present a security token to the Windows Azure Service Bus.

<system.serviceModel>

  <bindings>
    <!-- Application Binding -->
    <netOnewayRelayBinding>
      <binding name="customBinding">
        <!-- Turn off SSL and client authentication -->
        <security mode="None" relayClientAuthenticationType="None" />
      </binding>
    </netOnewayRelayBinding>
  </bindings>

  <client>
    <!-- Application Endpoint -->
    <!-- No behavior configuration is added to this endpoint as the client does not need to authenticate. -->
    <endpoint name="RelayEndpoint"
              contract="Microsoft.ServiceBus.Samples.IOnewayContract"
              binding="netOnewayRelayBinding"
              bindingConfiguration="customBinding"              
              address="ReplaceWithEndpointAddress" />
  </client>

  <services>
    <service name="Microsoft.ServiceBus.Samples.OnewayService">
      <!-- Keep address empty to use host base address, or -->
      <!-- replace with endpoint address. -->
      <endpoint name="RelayEndpoint"
                contract="Microsoft.ServiceBus.Samples.IOnewayContract"                   
                binding="netOnewayRelayBinding" 
                bindingConfiguration="customBinding"
                behaviorConfiguration="ReplaceWithEndpointBehaviorName"
                address="" />
    </service>
  </services>

  <behaviors>
    <endpointBehaviors>
      <!-- Add endpoint behavior here. -->
    </endpointBehaviors>
  </behaviors>

</system.serviceModel>

The following example illustrates the use of NetOneWayRelayBinding programmatically with its default settings. The default settings of NetOneWayRelayBinding for the end-to-end security mode and client authentication type are EndToEndSecurityMode.Transport and RelayClientAuthenticationType.RelayAccessToken respectively. This example is a modified version of the NetOneWay SDK sample, which specifies the binding for the service endpoint and the client channel programmatically instead of specifying it in the application configuration file. The NetOneWay SDK sample can be found in the SDK install directory under \Samples\ServiceBus\ExploringFeatures\Bindings\NetOneWay.

This example starts by specifying the credentials the service and the client are expected to send to the Windows Azure Service Bus by creating an endpoint behavior. Next, it creates the binding, the service address, and starts the service host. After starting the service, a channel factory is created for the IOneWayChannel channel type that is used to generate a client channel to the service. Finally, the client channel is opened.

// Configure the credentials through an endpoint behavior.
TransportClientEndpointBehavior relayCredentials = new TransportClientEndpointBehavior();
relayCredentials.CredentialType = TransportClientCredentialType.SharedSecret;
relayCredentials.Credentials.SharedSecret.IssuerName = issuerName;
relayCredentials.Credentials.SharedSecret.IssuerSecret = issuerSecret;

// Create the binding with default settings.
NetOnewayRelayBinding binding = new NetOnewayRelayBinding();

// Get the service address.
Uri address = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, "OnewayService");

// Create the service host.
ServiceHost host = new ServiceHost(typeof(OnewayService), address);
// Add the service endpoint with the OneWayRelayBinding.
host.AddServiceEndpoint(typeof(IOnewayContract), binding, address);
// Add the credentials through the endpoint behavior.
host.Description.Endpoints[0].Behaviors.Add(relayCredentials);
// Start the service.
host.Open();

// Create a channel factory for the IOnewayChannel channel type.
// This channel factory is used to create client channels to the service. 
// Each client channel the channel factory creates is configured to use the 
// NetOneWayRelayBinding that is passed to the constructor of the channel factory.
ChannelFactory<IOnewayChannel> channelFactory = new ChannelFactory<IOnewayChannel>(
    binding, new EndpointAddress(address));
channelFactory.Endpoint.Behaviors.Add(relayCredentials);

// Create and open the client channel.
IOnewayChannel channel = channelFactory.CreateChannel();
channel.Open();

The following example is similar to the previous example except that it uses NetOneWayRelayBinding with custom settings. It turns off the security mode and client authentication, which means that SOAP messages are sent unsecured and that the client is not required to present a security token to the Windows Azure Service Bus. Since the client is not required to authenticate, no endpoint behavior for the credentials is added to the client channel. Note that the behavior is still added to the service endpoint because the service application always authenticates with the Windows Azure Service Bus.

// Configure the credentials through an endpoint behavior.
TransportClientEndpointBehavior relayCredentials = new TransportClientEndpointBehavior();
relayCredentials.CredentialType = TransportClientCredentialType.SharedSecret;
relayCredentials.Credentials.SharedSecret.IssuerName = issuerName;
relayCredentials.Credentials.SharedSecret.IssuerSecret = issuerSecret;

// Create the binding with custom settings.
NetOnewayRelayBinding binding = new NetOnewayRelayBinding();
// SOAP messages are not SSL-protected.
binding.Security.Mode = EndToEndSecurityMode.None;
// The client is not required to present a security token to the
// AppFabric Service Bus.
binding.Security.RelayClientAuthenticationType = RelayClientAuthenticationType.None;

// Get the service address.
Uri address = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, "OnewayService");

// Create the service host.
ServiceHost host = new ServiceHost(typeof(OnewayService), address);
// Add the service endpoint with the OneWayRelayBinding.
host.AddServiceEndpoint(typeof(IOnewayContract), binding, address);
// Add the credentials through the endpoint behavior.
host.Description.Endpoints[0].Behaviors.Add(relayCredentials);
// Start the service.
host.Open();

// Create a channel factory for the IOnewayChannel channel type.
// This channel factory is used to create client channels to the service. 
// Each client channel the channel factory creates is configured to use the 
// NetOneWayRelayBinding that is passed to the constructor of the channel factory.
ChannelFactory<IOnewayChannel> channelFactory = new ChannelFactory<IOnewayChannel>(
    binding, new EndpointAddress(address));

// Create and open the client channel.
IOnewayChannel channel = channelFactory.CreateChannel();
channel.Open();

この型の public static (Visual Basic では Shared) のメンバーはすべて、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。
この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました

コミュニティの追加

追加
表示:
© 2014 Microsoft