Share via


Server Channel Properties

This topic is specific to a legacy technology that is retained for backward compatibility with existing applications and is not recommended for new development. Distributed applications should now be developed using the Windows Communication Foundation (WCF).

The following table shows the server channel properties that can be specified.

Property Description Types that support this property

authorizationModule

A string that specifies the assembly, namespace, and class name of a class that implements the IAuthorizeRemotingConnection interface. The format of the string must be AuthorizationModuleNameSpace.AuthorizationModuleClass,AuthorizationModuleAssembly.

TcpChannel

TcpServerChannel

authorizedGroup

A string that specifies the group or user that has permission to connect to this channel. The default is to allow access to all authorized users.

IpcChannel

IpcServerChannel

bindTo

A string that specifies the IP address of the network interface card (NIC) to which the server channel should bind. The default value is System.Net.IPAddress.Any.

HttpChannel

HttpServerChannel

TcpChannel

TcpServerChannel

exclusiveAddressUse

A Boolean value (true or false) that specifies whether the channel prevents other applications from reusing the IP address/port combination. The default is true. When set to true, this property sets the SocketOptionName server socket option to SocketOptionName.ExclusiveAddressUse.

This property is supported only by the .NET Framework version 1.1 on the following platforms: Windows NT 4.0 with Service Pack 4 or later, Windows Me, Windows 2000, Windows XP Home Edition, Windows XP Professional, and Windows Server 2003.

Changing this property requires administrator privileges on platforms prior to Windows XP Service Pack 2 or Windows Server 2003.

HttpChannel

HttpServerChannel

TcpChannel

TcpServerChannel

impersonate

A Boolean value (true or false) that specifies whether the server should impersonate the client. The default is false.

TcpChannel

TcpServerChannel

listen

A Boolean value (true or false) that specifies whether to allow activation to hook in IChannelReceiverHook.WantsToListen. The default is true.

HttpChannel

HttpServerChannel

port

An integer that specifies the port on which the channel listens. If you specify 0, the remoting system automatically chooses an open port.

HttpChannel

HttpServerChannel

TcpChannel

TcpServerChannel

portName

A string that specifies the name of the port that the server exposes. This property is required for an IpcChannel or IpcServerChannel.

IpcChannel

IpcServerChannel

rejectRemoteRequests

A Boolean value (true or false) that specifies whether to refuse requests from other computers. Specifying true allows only remoting calls from the local computer. The default is false.

TcpChannel

TcpServerChannel

suppressChannelData

A Boolean value (true or false) that specifies whether the channel contributes to the channel data that is available from the ChannelData, ChannelData, or ChannelData properties. The default is false.

HttpChannel

HttpServerChannel

TcpChannel

TcpServerChannel

IpcChannel

IpcServerChannel

useIpAddress

A Boolean value (true or false) that specifies whether to use the IP address in the publication URL instead of the computer name. For example, wireless networks often shuffle a portable computer's IP address as it moves throughout the network. Specifying false for this value causes the computer name to be used instead of the address, so that remote communications do not disconnect while roaming. The default is true. This value can be overridden by the machineName property when that property is used with a server channel. For more information, see the machineName property.

HttpChannel

HttpServerChannel

TcpChannel

TcpServerChannel

See Also

Tasks

How to: Configure a Channel in a Configuration File
How to: Configure a Channel Programmatically

Reference

Remoting Settings Schema

Concepts

Configuration of Remote Applications
Remote Object Configuration
Remote Object Configuration