영업: 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();

이 유형의 모든 공용 static(Visual Basic에서는 Shared) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.
이 정보가 도움이 되었습니까?
(1500자 남음)
의견을 주셔서 감사합니다.

커뮤니티 추가 항목

표시:
© 2015 Microsoft