Продажи: 1-800-867-1389

Класс 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Представляет кодировку привязки. Вместе с параметрами безопасности и типом транспорта кодировка — одно из трех основных свойств привязки.
Защищенное полеtransportУказывает тип транспорта для привязки. Вместе с параметрами безопасности и кодировкой тип транспорта — одно из трех основных свойств привязки.
В начало

  ИмяОписание
Явная реализация интерфейсаЗакрытое свойствоIBindingRuntimePreferences..::..ReceiveSynchronouslyВозвращает значение, указывающее, как эффективнее обрабатывать входящие запросы, — синхронно или асинхронно.
В начало

ПримечаниеПримечание

By default, NetOnewayRelayBinding uses Transport Security.

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 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 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 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 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();

Любые открытые статический (Shared в Visual Basic) элементы этого типа потокобезопасны. Потокобезопасность с элементами экземпляров не гарантируется.
Была ли вам полезна эта информация?
(1500 символов осталось)
Спасибо за ваш отзыв

Добавления сообщества

ДОБАВИТЬ
Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft