IpcClientChannel

.NET Framework クラス ライブラリ リファレンス

IpcClientChannel クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

IPC プロトコルを使用してメッセージを送信するリモート呼び出しのクライアント チャネルを実装します。

名前空間: System.Runtime.Remoting.Channels.Ipc
アセンブリ: System.Runtime.Remoting (system.runtime.remoting.dll 内)
構文

Visual Basic (宣言)

Public Class IpcClientChannel
    Implements IChannelSender, IChannel, ISecurableChannel

Visual Basic (使用法)

Dim instance As IpcClientChannel

C#

public class IpcClientChannel : IChannelSender,
 IChannel, ISecurableChannel

C++

public ref class IpcClientChannel : IChannelSender,
 IChannel, ISecurableChannel

J#

public class IpcClientChannel implements IChannelSender,
 IChannel, 
    ISecurableChannel

JScript

public class IpcClientChannel implements IChannelSender,
 IChannel, 
    ISecurableChannel

解説

チャネルは、リモート呼び出しを転送するために .NET Framework のリモート処理インフラストラクチャによって使用されます。クライアントがリモート オブジェクトを呼び出すと、この呼び出しは、クライアント チャネルからサーバー チャネルに送信されるメッセージとしてシリアル化されます。メッセージの受信後、このメッセージが逆シリアル化され、処理されます。戻り値は、サーバー チャネルからクライアント チャネルに送信されます。

IpcClientChannel クラスは、Windows のプロセス間通信 (IPC) システムを使用して、同じコンピュータ上のアプリケーション ドメイン間でメッセージを転送します。同じコンピュータ上のアプリケーション ドメイン間で通信する場合、IPC チャネルは TCP チャネルや HTTP チャネルよりもはるかに高速です。

クライアント側でメッセージの追加的な処理を実行するには、IpcClientChannel オブジェクトによって処理されるすべてのメッセージが通過する IClientChannelSinkProvider インターフェイスの実装を指定します。

既定では、IpcClientChannel クラスはバイナリ フォーマッタを使用してすべてのメッセージをシリアル化します。

IpcClientChannel オブジェクトには、構成ファイルを使用して (静的 RemotingConfiguration.Configure メソッドを呼び出す)、またはプログラムで (IpcClientChannel コンストラクタに IDictionary コレクションを渡す)、実行時に設定できる構成プロパティが関連付けられています。これらの構成プロパティの一覧については、IpcClientChannel コンストラクタのトピックを参照してください。

使用例

IpcClientChannel クラスを使用するコード例を次に示します。

C#

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Ipc;


public class Client
{
    public static void Main
 ()
    {
        IpcClientChannel clientChannel = new IpcClientChannel();
        ChannelServices.RegisterChannel(clientChannel);

        RemotingConfiguration.RegisterWellKnownClientType( typeof(Counter) , "ipc://remote/counter"
 );

        Counter counter = new Counter();
        Console.WriteLine("This is call number {0}.", counter.Count);
    }

}

C++

#using <System.Runtime.Remoting.dll>
#using <System.dll>
#using <Counter.dll>

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Ipc;

public ref class Client
{
public:
   void ClientTest()
   {
      IpcClientChannel^ clientChannel = gcnew IpcClientChannel;
      ChannelServices::RegisterChannel( clientChannel );

      RemotingConfiguration::RegisterWellKnownClientType( Counter::typeid, L"ipc://remote/counter"
 );
      Counter^ counter = gcnew Counter;
      Console::WriteLine( L"This is call number {0}.", counter->Count
 );
   }
};

int main()
{
   Client^ c = gcnew Client;
   c->ClientTest();
}

J#

import System.*;
import System.Runtime.Remoting.*;
import System.Runtime.Remoting.Channels.*;
import System.Runtime.Remoting.Channels.Ipc.*;

public class Client
{
    public static void main(String[]
 args)
    {
        IpcClientChannel clientChannel = new IpcClientChannel();
        ChannelServices.RegisterChannel(clientChannel);

        RemotingConfiguration.RegisterWellKnownClientType(
            Counter.class.ToType(), "ipc://remote/counter");
        Counter counter = new Counter();
        Console.WriteLine("This is call number {0}.", 
            System.Convert.ToString(counter.get_Count()));
    } //main
} //Client 

上記のコードでは、次のリモート オブジェクトを使用しています。

C#

using System;

public class Counter : MarshalByRefObject {

  private int count = 0;

  public int Count { get
 {
    return(count++);
  } }

}

C++

using namespace System;
public ref class Counter: public
 MarshalByRefObject
{
private:
   int count;

public:
   Counter()
   {
      count = 0;
   }

   property int Count 
   {
      int get()
      {
         return (count)++;
      }
   }
};

J#

import System.*;

public class Counter extends MarshalByRefObject
{
    private int count = 0;

    /** @property 
     */
    public int get_Count()
    {
        return count++;
    } //get_Count
} //Counter 

このオブジェクトをリモートで公開するサーバーの例については、IpcServerChannel のトピックを参照してください。

継承階層

System.Object
  System.Runtime.Remoting.Channels.Ipc.IpcClientChannel

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IpcClientChannel メンバ
System.Runtime.Remoting.Channels.Ipc 名前空間

IpcClientChannel コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

IpcServerChannel クラスの新しいインスタンスを初期化します。

名前空間: System.Runtime.Remoting.Channels.Ipc
アセンブリ: System.Runtime.Remoting (system.runtime.remoting.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New IpcClientChannel

C#

public IpcClientChannel ()

C++

public:
IpcClientChannel ()

J#

public IpcClientChannel ()

JScript

public function IpcClientChannel ()

解説

このコンストラクタによって返される TcpClientChannel インスタンスの構成プロパティは、すべて既定値に設定されます。各構成プロパティの既定値を次の表に示します。

構成プロパティ	説明
name	既定の名前は "ipc client" です。各チャネルに一意な名前が付けられている必要があります。
priority	既定の優先順位は 1 です。

使用例

このコンストラクタを使用するコードの例を次に示します。

C#

IpcClientChannel clientChannel = new IpcClientChannel();
ChannelServices.RegisterChannel(clientChannel);

C++

IpcClientChannel^ clientChannel = gcnew IpcClientChannel;
ChannelServices::RegisterChannel( clientChannel );

J#

IpcClientChannel clientChannel = new IpcClientChannel();
ChannelServices.RegisterChannel(clientChannel);

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IpcClientChannel クラス
IpcClientChannel メンバ
System.Runtime.Remoting.Channels.Ipc 名前空間

IpcClientChannel コンストラクタ (IDictionary, IClientChannelSinkProvider)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

構成プロパティとシンクを指定して、IpcClientChannel クラスの新しいインスタンスを初期化します。

名前空間: System.Runtime.Remoting.Channels.Ipc
アセンブリ: System.Runtime.Remoting (system.runtime.remoting.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    properties As IDictionary, _
    sinkProvider As IClientChannelSinkProvider _
)

Visual Basic (使用法)

Dim properties As IDictionary
Dim sinkProvider As IClientChannelSinkProvider

Dim instance As New IpcClientChannel(properties,
 sinkProvider)

C#

public IpcClientChannel (
    IDictionary properties,
    IClientChannelSinkProvider sinkProvider
)

C++

public:
IpcClientChannel (
    IDictionary^ properties, 
    IClientChannelSinkProvider^ sinkProvider
)

J#

public IpcClientChannel (
    IDictionary properties, 
    IClientChannelSinkProvider sinkProvider
)

JScript

public function IpcClientChannel (
    properties : IDictionary, 
    sinkProvider : IClientChannelSinkProvider
)

パラメータ

properties

チャネルで使用される構成プロパティの値を指定する IDictionary コレクション。

sinkProvider

チャネルによって使用される IServerChannelSinkProvider の実装。

解説

チャネル構成プロパティの詳細については、「チャネルおよびフォーマッタの構成プロパティ」を参照してください。

シンク機能が不要な場合は、sinkProvider パラメータを null 参照 (Visual Basic では Nothing) に設定します。

使用例

このコンストラクタを使用するコードの例を次に示します。

C#

// Create the client channel.
System.Collections.IDictionary properties = 
    new System.Collections.Hashtable();
properties["name"] = "ipc client";
properties["priority"] = "1";
System.Runtime.Remoting.Channels.IClientChannelSinkProvider 
    sinkProvider = null;
IpcClientChannel clientChannel = 
    new IpcClientChannel(properties, sinkProvider);

C++

// Create the client channel.
System::Collections::IDictionary^ properties = gcnew System::Collections::Hashtable;
properties->default[ L"name" ] = L"ipc client";
properties->default[ L"priority" ] = L"1";
IClientChannelSinkProvider^ sinkProvider = nullptr;
IpcClientChannel^ clientChannel = gcnew IpcClientChannel( properties,sinkProvider
 );

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IpcClientChannel クラス
IpcClientChannel メンバ
System.Runtime.Remoting.Channels.Ipc 名前空間
その他の技術情報
チャネルおよびフォーマッタの構成プロパティ

IpcClientChannel コンストラクタ (String, IClientChannelSinkProvider)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

名前とシンクを指定して、IpcClientChannel クラスの新しいインスタンスを初期化します。

名前空間: System.Runtime.Remoting.Channels.Ipc
アセンブリ: System.Runtime.Remoting (system.runtime.remoting.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    name As String, _
    sinkProvider As IClientChannelSinkProvider _
)

Visual Basic (使用法)

Dim name As String
Dim sinkProvider As IClientChannelSinkProvider

Dim instance As New IpcClientChannel(name,
 sinkProvider)

C#

public IpcClientChannel (
    string name,
    IClientChannelSinkProvider sinkProvider
)

C++

public:
IpcClientChannel (
    String^ name, 
    IClientChannelSinkProvider^ sinkProvider
)

J#

public IpcClientChannel (
    String name, 
    IClientChannelSinkProvider sinkProvider
)

JScript

public function IpcClientChannel (
    name : String, 
    sinkProvider : IClientChannelSinkProvider
)

パラメータ

name

チャネルの名前。

sinkProvider

チャネルによって使用される IClientChannelSinkProvider の実装。

解説

このコンストラクタは、name パラメータを使用して ChannelName プロパティを設定します。複数のチャネルを登録する場合は、各チャネルに一意の名前を付ける必要があります。

シンク機能が不要な場合は、sinkProvider パラメータを null 参照 (Visual Basic では Nothing) に設定します。

使用例

このコンストラクタを使用するコードの例を次に示します。

C#

// Create the client channel.
string name = "ipc client";
System.Runtime.Remoting.Channels.IClientChannelSinkProvider 
    sinkProvider = null;
IpcClientChannel clientChannel = 
    new IpcClientChannel(name, sinkProvider);

C++

// Create the client channel.
String^ name = L"ipc client";
IClientChannelSinkProvider^ sinkProvider = nullptr;
IpcClientChannel^ clientChannel = gcnew IpcClientChannel( name,sinkProvider );

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IpcClientChannel クラス
IpcClientChannel メンバ
System.Runtime.Remoting.Channels.Ipc 名前空間

IpcClientChannel コンストラクタ

IpcServerChannel クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
IpcClientChannel ()	IpcServerChannel クラスの新しいインスタンスを初期化します。
IpcClientChannel (IDictionary, IClientChannelSinkProvider)	構成プロパティとシンクを指定して、IpcClientChannel クラスの新しいインスタンスを初期化します。
IpcClientChannel (String, IClientChannelSinkProvider)	名前とシンクを指定して、IpcClientChannel クラスの新しいインスタンスを初期化します。

参照

関連項目

IpcClientChannel クラス
IpcClientChannel メンバ
System.Runtime.Remoting.Channels.Ipc 名前空間

IpcClientChannel プロパティ

パブリック プロパティ

	名前	説明
	ChannelName	現在のチャネルの名前を取得します。
	ChannelPriority	現在のチャネルの優先順位を取得します。
	IsSecured

参照

関連項目

IpcClientChannel クラス
System.Runtime.Remoting.Channels.Ipc 名前空間

IpcClientChannel メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateMessageSink	指定した URL またはチャネル データ オブジェクトにメッセージを配信するチャネル メッセージ シンクを返します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Parse	指定した URL からチャネル URI と既知のリモート オブジェクト URI を抽出します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

IpcClientChannel クラス
System.Runtime.Remoting.Channels.Ipc 名前空間

IpcClientChannel メンバ

IPC プロトコルを使用してメッセージを送信するリモート呼び出しのクライアント チャネルを実装します。

IpcClientChannel データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	IpcClientChannel	オーバーロードされます。 IpcServerChannel クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	ChannelName	現在のチャネルの名前を取得します。
	ChannelPriority	現在のチャネルの優先順位を取得します。
	IsSecured

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateMessageSink	指定した URL またはチャネル データ オブジェクトにメッセージを配信するチャネル メッセージ シンクを返します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Parse	指定した URL からチャネル URI と既知のリモート オブジェクト URI を抽出します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

IpcClientChannel クラス
System.Runtime.Remoting.Channels.Ipc 名前空間