Table of Contents

Class NetOnewayRelayBinding

Namespace
Microsoft.ServiceBus
Assembly
Microsoft.ServiceBus.dll

Represents a binding for a secure, one-way connection through the cloud.

public class NetOnewayRelayBinding : Binding, IBindingRuntimePreferences
Inheritance
NetOnewayRelayBinding
Implements
IBindingRuntimePreferences
Derived

Constructors

NetOnewayRelayBinding()

Initializes a new instance of the NetOnewayRelayBinding class.

public NetOnewayRelayBinding()

NetOnewayRelayBinding(EndToEndSecurityMode, RelayClientAuthenticationType)

Initializes a new instance of the NetOnewayRelayBinding class, using the specified security mode and authentication type.

public NetOnewayRelayBinding(EndToEndSecurityMode securityMode, RelayClientAuthenticationType relayClientAuthenticationType)

Parameters

securityMode EndToEndSecurityMode

The security mode.

relayClientAuthenticationType RelayClientAuthenticationType

The authentication type.

NetOnewayRelayBinding(NetOnewayRelaySecurity)

Initializes a new instance of the NetOnewayRelayBinding class, using the specified security settings.

protected NetOnewayRelayBinding(NetOnewayRelaySecurity security)

Parameters

security NetOnewayRelaySecurity

The security settings.

NetOnewayRelayBinding(RelayedOnewayConnectionMode, EndToEndSecurityMode, RelayClientAuthenticationType)

Initializes a new instance of the NetOnewayRelayBinding class, using the specified connection and security modes, as well as the authentication type.

protected NetOnewayRelayBinding(RelayedOnewayConnectionMode connectionMode, EndToEndSecurityMode securityMode, RelayClientAuthenticationType relayClientAuthenticationType)

Parameters

connectionMode RelayedOnewayConnectionMode

The connection mode.

securityMode EndToEndSecurityMode

The type of security used with the SOAP message and for the client.

relayClientAuthenticationType RelayClientAuthenticationType

The type of authentication used by the client.

NetOnewayRelayBinding(RelayedOnewayTransportBindingElement, BinaryMessageEncodingBindingElement, NetOnewayRelaySecurity)

Initializes a new instance of the NetOnewayRelayBinding class, using the specified transport, encoding, and security.

protected NetOnewayRelayBinding(RelayedOnewayTransportBindingElement transport, BinaryMessageEncodingBindingElement encoding, NetOnewayRelaySecurity security)

Parameters

transport RelayedOnewayTransportBindingElement

The transport element containing the core transport settings .

encoding BinaryMessageEncodingBindingElement

The encoding element.

security NetOnewayRelaySecurity

The security settings.

NetOnewayRelayBinding(string)

Initializes a new instance of the NetOnewayRelayBinding class using the specified configuration.

public NetOnewayRelayBinding(string configurationName)

Parameters

configurationName string

The name of the configuration to use.

Fields

encoding

Represents the encoding for the binding. Along with the security settings and transport type, the encoding represents the three core properties of a binding.

protected BinaryMessageEncodingBindingElement encoding

Field Value

BinaryMessageEncodingBindingElement

transport

Specifies the transport type for the binding. Along with the encoding and security settings, the transport type represents the three core properties of a binding.

protected RelayedOnewayTransportBindingElement transport

Field Value

RelayedOnewayTransportBindingElement

Properties

EnvelopeVersion

Gets the version of SOAP that is used for messages processed by this binding.

public EnvelopeVersion EnvelopeVersion { get; }

Property Value

EnvelopeVersion

Returns a System.ServiceModel.EnvelopeVersion that contains the envelope version.

ListenBacklog

Gets or sets the maximum number of queued connection requests that can be pending.

public int ListenBacklog { get; set; }

Property Value

int

Returns the maximum number of queued connection requests that can be pending. The default is 10.

MaxBufferPoolSize

Gets or sets the maximum size allowed for a buffer pool that stores messages processed by the binding.

public long MaxBufferPoolSize { get; set; }

Property Value

long

Returns the maximum size allowed for a buffer pool that stores messages processed by the binding. The default value is 65,536 bytes.

MaxBufferSize

Gets or sets a value that specifies the maximum size, in bytes, of the buffer used to store messages in memory.

public int MaxBufferSize { get; set; }

Property Value

int

Returns the maximum size, in bytes, of the buffer used to store messages in memory. The default value is 65,536 bytes.

MaxConnections

Gets or sets a value that controls the maximum number of connections to be pooled for subsequent reuse on the client and the maximum number of connections allowed to be pending dispatch on the server.

public int MaxConnections { get; set; }

Property Value

int

On the client, returns the maximum number of connections to be pooled for subsequent reuse; on the server, returns the maximum number of connections allowed to be pending dispatch.

MaxReceivedMessageSize

Gets or sets the maximum size for a received message that is processed by the binding.

public long MaxReceivedMessageSize { get; set; }

Property Value

long

Returns the maximum size, in bytes, for a received message that is processed by the binding. The default value is 65,536 bytes.

MessageSecurityVersion

Gets the message security version.

protected MessageSecurityVersion MessageSecurityVersion { get; }

Property Value

MessageSecurityVersion

Returns a System.ServiceModel.MessageSecurityVersion that contains the message security version. This currently returns MessageSecurityVersion..::.WSSecurity11WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11.

ReaderQuotas

Gets or sets constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

public XmlDictionaryReaderQuotas ReaderQuotas { get; set; }

Property Value

XmlDictionaryReaderQuotas

Returns a System.Xml.XmlDictionaryReaderQuotas instance that specifies the complexity constraints on SOAP messages exchanged. The default values for these constraints are provided in the following Remarks section.

Scheme

Gets the URI scheme for the transport.

public override string Scheme { get; }

Property Value

string

Returns the URI scheme for the transport. The default value is “sb”, indicating the Windows Azure Service Bus.

Security

Gets an object that specifies the type of security used with services configured with this binding.

public NetOnewayRelaySecurity Security { get; }

Property Value

NetOnewayRelaySecurity

Returns a NetOnewayRelaySecurity instance that contains the types of security used with this binding. This type contains the message security, the end-to-end security mode, relay client authentication type, and transport security settings.

Methods

ApplyConfiguration(string)

Applies the settings from the configuration element that corresponds to the specified name to the current instance of this binding element.

protected virtual void ApplyConfiguration(string configurationName)

Parameters

configurationName string

The name of the configuration element to take the settings from.

CreateBindingElements()

Creates a set of binding elements.

public override BindingElementCollection CreateBindingElements()

Returns

BindingElementCollection

Returns a System.ServiceModel.Channels.BindingElementCollection that contains the binding elements.