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. |
|
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. |
|
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. |
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 GetSocketOption 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 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
Concepts
Configuration of Remote Applications
Remote Object Configuration
Remote Object Configuration