Exporter (0) Imprimer
Développer tout

Classe NetOnewayRelayBinding

Représente une liaison pour une connexion unidirectionnelle sécurisée via le nuage.

Espace de noms :  Microsoft.ServiceBus
Assembly :  Microsoft.ServiceBus (en Microsoft.ServiceBus.dll)

public class NetOnewayRelayBinding : Binding, 
	IBindingRuntimePreferences

Le type NetOnewayRelayBinding expose les membres suivants.

  NomDescription
Méthode publiqueNetOnewayRelayBinding()()()()Initialise une nouvelle instance de la classe NetOnewayRelayBinding.
Méthode publiqueNetOnewayRelayBinding(String)Initialise une nouvelle instance de la classe NetOnewayRelayBinding, utilisant la configuration spécifiée.
Méthode protégéeNetOnewayRelayBinding(NetOnewayRelaySecurity)Initialise une nouvelle instance de la classe NetOnewayRelayBinding, utilisant les paramètres de sécurité spécifiés.
Méthode publiqueNetOnewayRelayBinding(EndToEndSecurityMode, RelayClientAuthenticationType)Initialise une nouvelle instance de la classe NetOnewayRelayBinding, utilisant le mode de sécurité et le type d'authentification spécifiés.
Méthode protégéeNetOnewayRelayBinding(RelayedOnewayConnectionMode, EndToEndSecurityMode, RelayClientAuthenticationType)Initialise une nouvelle instance de la classe NetOnewayRelayBinding, utilisant les modes de connexion et de sécurité, ainsi que le type d'authentification spécifiés.
Méthode protégéeNetOnewayRelayBinding(RelayedOnewayTransportBindingElement, BinaryMessageEncodingBindingElement, NetOnewayRelaySecurity)Initialise une nouvelle instance de la classe NetOnewayRelayBinding, utilisant le transport, l'encodage et la sécurité spécifiés.
Haut de la page

  NomDescription
Propriété publiqueCloseTimeout (hérité de Binding.)
Propriété publiqueEnvelopeVersionObtient la version de SOAP utilisée pour les messages traités par cette liaison.
Propriété publiqueListenBacklogObtient ou définit le nombre maximal de demandes de connexion pouvant être mises en file d'attente.
Propriété publiqueMaxBufferPoolSizeObtient ou définit la taille maximale autorisée pour un pool de tampons stockant les messages traités par la liaison.
Propriété publiqueMaxBufferSizeObtient ou définit une valeur spécifiant la taille maximale, en octets, du tampon utilisé pour stocker les messages en mémoire.
Propriété publiqueMaxConnectionsObtient ou définit une valeur contrôlant le nombre maximal de connexions à regrouper en pool en vue d'une réutilisation sur le client, ainsi que le nombre maximal de connexions dont la répartition peut être mise en attente sur le serveur.
Propriété publiqueMaxReceivedMessageSizeObtient ou définit la taille maximale d'un message reçu traité par la liaison.
Propriété protégéeMessageSecurityVersionObtient la version de sécurité de message.
Propriété publiqueMessageVersion (hérité de Binding.)
Propriété publiqueName (hérité de Binding.)
Propriété publiqueNamespace (hérité de Binding.)
Propriété publiqueOpenTimeout (hérité de Binding.)
Propriété publiqueReaderQuotasObtient ou définit des contraintes concernant la complexité des messages SOAP que peuvent traiter les points de terminaison configurés avec cette liaison.
Propriété publiqueReceiveTimeout (hérité de Binding.)
Propriété publiqueSchemeObtient le schéma URI pour le transport. (remplace Binding..::..Scheme.)
Propriété publiqueSecurityObtient un objet spécifiant le type de sécurité utilisé pour les services configurés avec cette liaison.
Propriété publiqueSendTimeout (hérité de Binding.)
Haut de la page

  NomDescription
Méthode protégéeApplyConfigurationApplique à l'instance actuelle de cet élément de liaison les paramètres de l'élément de configuration correspondant au nom spécifié.
Méthode publiqueBuildChannelFactory<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (hérité de Binding.)
Méthode publiqueBuildChannelFactory<(Of <<'(TChannel>)>>)(BindingParameterCollection) (hérité de Binding.)
Méthode publiqueBuildChannelListener<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (hérité de Binding.)
Méthode publiqueBuildChannelListener<(Of <<'(TChannel>)>>)(BindingParameterCollection) (hérité de Binding.)
Méthode publiqueBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, array<Object>[]()[][]) (hérité de Binding.)
Méthode publiqueBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, BindingParameterCollection) (hérité de Binding.)
Méthode publiqueBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, array<Object>[]()[][]) (hérité de Binding.)
Méthode publiqueBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, BindingParameterCollection) (hérité de Binding.)
Méthode publiqueBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, ListenUriMode, array<Object>[]()[][]) (hérité de Binding.)
Méthode publiqueBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, ListenUriMode, BindingParameterCollection) (hérité de Binding.)
Méthode publiqueCanBuildChannelFactory<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (hérité de Binding.)
Méthode publiqueCanBuildChannelFactory<(Of <<'(TChannel>)>>)(BindingParameterCollection) (hérité de Binding.)
Méthode publiqueCanBuildChannelListener<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (hérité de Binding.)
Méthode publiqueCanBuildChannelListener<(Of <<'(TChannel>)>>)(BindingParameterCollection) (hérité de Binding.)
Méthode publiqueCreateBindingElementsCrée un ensemble d'éléments de liaison. (remplace Binding..::..CreateBindingElements()()()().)
Méthode publiqueEquals (hérité de Object.)
Méthode protégéeFinalize (hérité de Object.)
Méthode publiqueGetHashCode (hérité de Object.)
Méthode publiqueGetProperty<(Of <<'(T>)>>) (hérité de Binding.)
Méthode publiqueGetType (hérité de Object.)
Méthode protégéeMemberwiseClone (hérité de Object.)
Méthode publiqueShouldSerializeName (hérité de Binding.)
Méthode publiqueShouldSerializeNamespace (hérité de Binding.)
Méthode publiqueToString (hérité de Object.)
Haut de la page

  NomDescription
Champ protégéencodingReprésente l'encodage pour la liaison. Avec les paramètres de sécurité et le type de transport, l'encodage constitue l'une des trois propriétés fondamentales d'une liaison.
Champ protégétransportSpécifie le type de transport pour la liaison. Avec les paramètres de sécurité et l'encodage, le type de transport constitue l'une des trois propriétés fondamentales d'une liaison.
Haut de la page

  NomDescription
Implémentation d'interface explicitePropriété privéeIBindingRuntimePreferences..::..ReceiveSynchronouslyObtient une valeur indiquant si les requêtes entrantes peuvent être gérées plus efficacement de façon synchrone ou asynchrone.
Haut de la page

RemarqueRemarque

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

Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft