VERTRIEB: 1-800-867-1380

NetOnewayRelayBinding-Klasse

Stellt eine Bindung für eine sichere unidirektionale Verbindung durch die Cloud dar.

Namespace:  Microsoft.ServiceBus
Assembly:  Microsoft.ServiceBus (in Microsoft.ServiceBus.dll)

public class NetOnewayRelayBinding : Binding, 
	IBindingRuntimePreferences

Der NetOnewayRelayBinding-Typ macht folgende Elemente verfügbar.

  NameBeschreibung
Öffentliche MethodeNetOnewayRelayBinding()()()()Initialisiert eine neue Instanz der NetOnewayRelayBinding-Klasse.
Öffentliche MethodeNetOnewayRelayBinding(String)Initialisiert mithilfe der angegebenen Konfiguration eine neue Instanz der NetOnewayRelayBinding-Klasse.
Geschützte MethodeNetOnewayRelayBinding(NetOnewayRelaySecurity)Initialisiert mithilfe der angegebenen Sicherheitseinstellungen eine neue Instanz der NetOnewayRelayBinding-Klasse.
Öffentliche MethodeNetOnewayRelayBinding(EndToEndSecurityMode, RelayClientAuthenticationType)Initialisiert eine neue Instanz der NetOnewayRelayBinding-Klasse mithilfe des angegebenen Sicherheitsmodus und Authentifizierungstyps.
Geschützte MethodeNetOnewayRelayBinding(RelayedOnewayConnectionMode, EndToEndSecurityMode, RelayClientAuthenticationType)Initialisiert eine neue Instanz der NetOnewayRelayBinding-Klasse mithilfe der angegebenen Verbindungs- und Sicherheitsmodi und des Authentifizierungstyps.
Geschützte MethodeNetOnewayRelayBinding(RelayedOnewayTransportBindingElement, BinaryMessageEncodingBindingElement, NetOnewayRelaySecurity)Initialisiert mithilfe der angegebenen Transport-, Codierungs- und Sicherheitseinstellungen eine neue Instanz der NetOnewayRelayBinding-Klasse.
Zum Anfang

  NameBeschreibung
Öffentliche EigenschaftCloseTimeout (Geerbt von Binding.)
Öffentliche EigenschaftEnvelopeVersionRuft die Version von SOAP ab, die für Nachrichten verwendet wird, die von dieser Bindung verarbeitet werden.
Öffentliche EigenschaftListenBacklogRuft die maximale Anzahl von Verbindungsanforderungen in der Warteschlange ab, die ausstehen können, oder legt diese Anzahl fest.
Öffentliche EigenschaftMaxBufferPoolSizeRuft die maximal zulässige Größe für einen Pufferpool ab, der von der Bindung verarbeitete Nachrichten speichert, oder legt sie fest.
Öffentliche EigenschaftMaxBufferSizeRuft einen Wert ab, der die maximale Größe des Puffers (in Byte) angibt, der zum Speichern von Nachrichten im Arbeitsspeicher verwendet wird, oder legt diesen Wert fest.
Öffentliche EigenschaftMaxConnectionsRuft einen Wert ab, der die maximale Anzahl von Verbindungen steuert, die für die nachfolgende Wiederverwendung auf dem Client in einem Pool zusammengefasst werden, sowie die maximale Anzahl von Verbindungen, für die auf dem Server die Verteilung ausstehen darf, oder legt diesen Wert fest.
Öffentliche EigenschaftMaxReceivedMessageSizeRuft die maximale Größe einer empfangenen Nachricht ab, die von der Bindung verarbeitet wird, oder legt sie fest.
Geschützte EigenschaftMessageSecurityVersionRuft die Nachrichtensicherheitsversion ab.
Öffentliche EigenschaftMessageVersion (Geerbt von Binding.)
Öffentliche EigenschaftName (Geerbt von Binding.)
Öffentliche EigenschaftNamespace (Geerbt von Binding.)
Öffentliche EigenschaftOpenTimeout (Geerbt von Binding.)
Öffentliche EigenschaftReaderQuotasRuft Einschränkungen für die Komplexität von SOAP-Nachrichten ab, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert sind, oder legt sie fest.
Öffentliche EigenschaftReceiveTimeout (Geerbt von Binding.)
Öffentliche EigenschaftSchemeRuft das URI-Schema für den Transport ab. (Überschreibt Binding..::..Scheme.)
Öffentliche EigenschaftSecurityRuft ein Objekt ab, das den Sicherheitstyp angibt, der mit Diensten verwendet wird, die mit dieser Bindung konfiguriert sind.
Öffentliche EigenschaftSendTimeout (Geerbt von Binding.)
Zum Anfang

  NameBeschreibung
Geschützte MethodeApplyConfigurationWendet die Einstellungen aus dem Konfigurationselement, das dem angegebenen Namen entspricht, auf die aktuelle Instanz dieses Bindungselements an.
Öffentliche MethodeBuildChannelFactory<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (Geerbt von Binding.)
Öffentliche MethodeBuildChannelFactory<(Of <<'(TChannel>)>>)(BindingParameterCollection) (Geerbt von Binding.)
Öffentliche MethodeBuildChannelListener<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (Geerbt von Binding.)
Öffentliche MethodeBuildChannelListener<(Of <<'(TChannel>)>>)(BindingParameterCollection) (Geerbt von Binding.)
Öffentliche MethodeBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, array<Object>[]()[][]) (Geerbt von Binding.)
Öffentliche MethodeBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, BindingParameterCollection) (Geerbt von Binding.)
Öffentliche MethodeBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, array<Object>[]()[][]) (Geerbt von Binding.)
Öffentliche MethodeBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, BindingParameterCollection) (Geerbt von Binding.)
Öffentliche MethodeBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, ListenUriMode, array<Object>[]()[][]) (Geerbt von Binding.)
Öffentliche MethodeBuildChannelListener<(Of <<'(TChannel>)>>)(Uri, String, ListenUriMode, BindingParameterCollection) (Geerbt von Binding.)
Öffentliche MethodeCanBuildChannelFactory<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (Geerbt von Binding.)
Öffentliche MethodeCanBuildChannelFactory<(Of <<'(TChannel>)>>)(BindingParameterCollection) (Geerbt von Binding.)
Öffentliche MethodeCanBuildChannelListener<(Of <<'(TChannel>)>>)(array<Object>[]()[][]) (Geerbt von Binding.)
Öffentliche MethodeCanBuildChannelListener<(Of <<'(TChannel>)>>)(BindingParameterCollection) (Geerbt von Binding.)
Öffentliche MethodeCreateBindingElementsErstellt eine Sammlung von Bindungselementen. (Überschreibt Binding..::..CreateBindingElements()()()().)
Öffentliche MethodeEquals (Geerbt von Object.)
Geschützte MethodeFinalize (Geerbt von Object.)
Öffentliche MethodeGetHashCode (Geerbt von Object.)
Öffentliche MethodeGetProperty<(Of <<'(T>)>>) (Geerbt von Binding.)
Öffentliche MethodeGetType (Geerbt von Object.)
Geschützte MethodeMemberwiseClone (Geerbt von Object.)
Öffentliche MethodeShouldSerializeName (Geerbt von Binding.)
Öffentliche MethodeShouldSerializeNamespace (Geerbt von Binding.)
Öffentliche MethodeToString (Geerbt von Object.)
Zum Anfang

  NameBeschreibung
Geschütztes FeldencodingStellt die Codierung für die Bindung dar. Zusammen mit den Sicherheitseinstellungen und dem Transporttyp bildet die Codierung die drei Kerneigenschaften einer Bindung.
Geschütztes FeldtransportGibt den für Transporttyp für die Bindung an. Zusammen mit den Codierungs- und Sicherheitseinstellungen bildet der Transporttyp die drei Kerneigenschaften einer Bindung.
Zum Anfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate EigenschaftIBindingRuntimePreferences..::..ReceiveSynchronouslyRuft einen Wert ab, der angibt, ob eingehende Anforderungen effizienter synchron oder asynchron verarbeitet werden können.
Zum Anfang

HinweisHinweis

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

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft