IpcChannel 建構函式

定義

命名空間:

System.Runtime.Remoting.Channels.Ipc

組件:

System.Runtime.Remoting.dll

初始化 IpcChannel 類別的新執行個體。

多載

IpcChannel()	初始化 IpcChannel 類別的新執行個體，只啟動用戶端通道，不啟動伺服器通道。
IpcChannel(String)	使用接聽指定 IPC 連接埠的伺服器通道，初始化 IpcChannel 類別的新執行個體。
IpcChannel(IDictionary, IClientChannelSinkProvider, IServerChannelSinkProvider)	使用指定的組態屬性和接收，初始化 IpcChannel 類別的新執行個體。
IpcChannel(IDictionary, IClientChannelSinkProvider, IServerChannelSinkProvider, CommonSecurityDescriptor)	使用指定的組態屬性和接收，初始化 IpcChannel 類別的新執行個體。

IpcChannel()

初始化 IpcChannel 類別的新執行個體，只啟動用戶端通道，不啟動伺服器通道。

public:
 IpcChannel();

public IpcChannel ();

Public Sub New ()

範例

下列程式代碼範例示範如何使用這個建構函式。 此程式代碼範例是提供給 類別之較大範例的 IpcChannel 一部分。

// Create the channel.
IpcChannel^ channel = gcnew IpcChannel;

// Create the channel.
IpcChannel channel = new IpcChannel();

IpcChannel(String)

使用接聽指定 IPC 連接埠的伺服器通道，初始化 IpcChannel 類別的新執行個體。

public:
 IpcChannel(System::String ^ portName);

public IpcChannel (string portName);

new System.Runtime.Remoting.Channels.Ipc.IpcChannel : string -> System.Runtime.Remoting.Channels.Ipc.IpcChannel

Public Sub New (portName As String)

參數

portName

String

IPC 連接埠的名稱。

範例

下列程式代碼範例示範如何使用這個建構函式。 此程式代碼範例是提供給 類別之較大範例的 IpcChannel 一部分。

// Create the server channel.
IpcChannel^ serverChannel = gcnew IpcChannel( L"localhost:9090" );

// Create the server channel.
IpcChannel serverChannel =
    new IpcChannel("localhost:9090");

IpcChannel(IDictionary, IClientChannelSinkProvider, IServerChannelSinkProvider)

使用指定的組態屬性和接收，初始化 IpcChannel 類別的新執行個體。

public:
 IpcChannel(System::Collections::IDictionary ^ properties, System::Runtime::Remoting::Channels::IClientChannelSinkProvider ^ clientSinkProvider, System::Runtime::Remoting::Channels::IServerChannelSinkProvider ^ serverSinkProvider);

public IpcChannel (System.Collections.IDictionary properties, System.Runtime.Remoting.Channels.IClientChannelSinkProvider clientSinkProvider, System.Runtime.Remoting.Channels.IServerChannelSinkProvider serverSinkProvider);

new System.Runtime.Remoting.Channels.Ipc.IpcChannel : System.Collections.IDictionary * System.Runtime.Remoting.Channels.IClientChannelSinkProvider * System.Runtime.Remoting.Channels.IServerChannelSinkProvider -> System.Runtime.Remoting.Channels.Ipc.IpcChannel

Public Sub New (properties As IDictionary, clientSinkProvider As IClientChannelSinkProvider, serverSinkProvider As IServerChannelSinkProvider)

參數

properties

IDictionary

IDictionary 集合，指定用戶端和伺服器通道將使用的組態屬性值。

clientSinkProvider

IClientChannelSinkProvider

用戶端通道要使用的 IClientChannelSinkProvider 實作。

serverSinkProvider

IServerChannelSinkProvider

伺服器通道要使用的 IServerChannelSinkProvider 實作。

範例

下列程式代碼範例示範如何使用這個建構函式。 此程式代碼範例是提供給 類別之較大範例的 IpcChannel 一部分。

// Create the server channel.
System::Collections::IDictionary^ properties = gcnew System::Collections::Hashtable;
properties->default[ L"name" ] = L"ipc";
properties->default[ L"priority" ] = L"20";
properties->default[ L"portName" ] = L"localhost:9090";
IpcChannel^ serverChannel = gcnew IpcChannel( properties,nullptr,nullptr );

// Create the server channel.
System.Collections.IDictionary properties =
    new System.Collections.Hashtable();
properties["name"] = "ipc";
properties["priority"] = "20";
properties["portName"] = "localhost:9090";
IpcChannel serverChannel = new IpcChannel(properties, null, null);

備註

如需通道組態屬性的詳細資訊，請參閱 通道和格式器組態屬性。

通道接收提供外掛程式點，允許存取流經通道的基礎訊息，以及傳輸機制用來將訊息傳送至遠端物件的數據流。 通道接收也負責傳輸客戶端與伺服器之間的訊息。 通道接收會在鏈結中連結在一起，而且所有通道訊息都會流經這個接收鏈結，然後再最後串行化和傳輸訊息。 如果您不需要接收功能，請將 clientSinkProvider 和 serverSinkProvider 參數設定為 null。

警告

在 自變數中將 exclusiveAddressUse 屬性設定為 false 時，可以針對相同的命名管道註冊數IpcServerChannel個properties物件。 在這種情況下，要求可以移至任何已註冊的通道。 只有在也使用 ALC 時，才會將此設定視為安全。

另請參閱

• 通道和格式子組態屬性

IpcChannel(IDictionary, IClientChannelSinkProvider, IServerChannelSinkProvider, CommonSecurityDescriptor)

使用指定的組態屬性和接收，初始化 IpcChannel 類別的新執行個體。

public:
 IpcChannel(System::Collections::IDictionary ^ properties, System::Runtime::Remoting::Channels::IClientChannelSinkProvider ^ clientSinkProvider, System::Runtime::Remoting::Channels::IServerChannelSinkProvider ^ serverSinkProvider, System::Security::AccessControl::CommonSecurityDescriptor ^ securityDescriptor);

public IpcChannel (System.Collections.IDictionary properties, System.Runtime.Remoting.Channels.IClientChannelSinkProvider clientSinkProvider, System.Runtime.Remoting.Channels.IServerChannelSinkProvider serverSinkProvider, System.Security.AccessControl.CommonSecurityDescriptor securityDescriptor);

new System.Runtime.Remoting.Channels.Ipc.IpcChannel : System.Collections.IDictionary * System.Runtime.Remoting.Channels.IClientChannelSinkProvider * System.Runtime.Remoting.Channels.IServerChannelSinkProvider * System.Security.AccessControl.CommonSecurityDescriptor -> System.Runtime.Remoting.Channels.Ipc.IpcChannel

Public Sub New (properties As IDictionary, clientSinkProvider As IClientChannelSinkProvider, serverSinkProvider As IServerChannelSinkProvider, securityDescriptor As CommonSecurityDescriptor)

參數

properties

IDictionary

IDictionary 集合，指定用戶端和伺服器通道將使用的組態屬性值。

clientSinkProvider

IClientChannelSinkProvider

用戶端通道要使用的 IClientChannelSinkProvider 實作。

serverSinkProvider

IServerChannelSinkProvider

伺服器通道要使用的 IServerChannelSinkProvider 實作。

securityDescriptor

CommonSecurityDescriptor

安全性描述元。