IpcServerChannel IpcServerChannel IpcServerChannel IpcServerChannel Class

定義

IPC システムを使用してメッセージを送信するリモート呼び出しのサーバー チャネルを実装します。Implements a server channel for remote calls that uses the IPC system to transmit messages.

public ref class IpcServerChannel : System::Runtime::Remoting::Channels::IChannelReceiver, System::Runtime::Remoting::Channels::ISecurableChannel
public class IpcServerChannel : System.Runtime.Remoting.Channels.IChannelReceiver, System.Runtime.Remoting.Channels.ISecurableChannel
type IpcServerChannel = class
    interface IChannelReceiver
    interface IChannel
    interface ISecurableChannel
Public Class IpcServerChannel
Implements IChannelReceiver, ISecurableChannel
継承
IpcServerChannelIpcServerChannelIpcServerChannelIpcServerChannel
実装

次のコード例は、使用する方法を示しています、IpcServerChannelクラス。The following code example illustrates how to use the IpcServerChannel class.

#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 IpcServer
{
public:
   void IpcServerTest()
   {
      // Create and register an IPC channel
      IpcServerChannel^ serverChannel = gcnew IpcServerChannel( L"remote" );
      ChannelServices::RegisterChannel( serverChannel );

      // Expose an object
      RemotingConfiguration::RegisterWellKnownServiceType( Counter::typeid, L"counter", WellKnownObjectMode::Singleton );
      
      // Wait for calls
      Console::WriteLine( L"Listening on {0}", serverChannel->GetChannelUri() );

      Console::ReadLine();
   }
};

int main()
{
   IpcServer^ is = gcnew IpcServer;
   is->IpcServerTest();
}
using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Ipc;

public class IpcServer
{

    public static void Main ()
    {
        // Create and register an IPC channel
        IpcServerChannel serverChannel = new IpcServerChannel("remote");
        ChannelServices.RegisterChannel(serverChannel);

        // Expose an object
        RemotingConfiguration.RegisterWellKnownServiceType( typeof(Counter), "counter", WellKnownObjectMode.Singleton );

        // Wait for calls
        Console.WriteLine("Listening on {0}", serverChannel.GetChannelUri());
        Console.ReadLine();
    }

}

上記のコードを使用して、次のリモート オブジェクトを公開できます。The preceding code is used to expose the following remote object.

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

public:
   Counter()
   {
      count = 0;
   }

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

public class Counter : MarshalByRefObject {

  private int count = 0;

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

}

このオブジェクトをリモートで使用するクライアントの例は、次を参照してください。IpcClientChannelします。For an example of a client using this object remotely, see IpcClientChannel.

注釈

重要

このクラスのメソッドを信頼されていないデータを指定して呼び出すことには、セキュリティ上のリスクが伴います。Calling methods from this class with untrusted data is a security risk. このクラスのメソッドの呼び出しは、信頼されたデータだけを指定して実行してください。Call the methods from this class only with trusted data. 詳しくは、「Data Validation」(データの入力規則) を参照してください。For more information, see Data Validation.

チャネルは、リモート呼び出しを転送する、.NET Framework リモート処理インフラストラクチャによって使用されます。Channels are used by the .NET Framework remoting infrastructure to transport remote calls. クライアントがリモート オブジェクトを呼び出すときに、呼び出しは、クライアント チャネルが送信され、サーバー チャネルで受信されるメッセージにシリアル化します。When a client calls a remote object, the call is serialized into a message that is sent by a client channel and received by a server channel. メッセージを受信すると、これとは逆シリアル化、処理します。After the message is received, it is deserialized and processed. 戻り値はすべてがサーバー チャネルによって送信され、クライアント チャネルで受信します。Any returned values are transmitted by the server channel and received by the client channel.

IpcServerChannelクラスは、同じコンピューター上のアプリケーション ドメイン間でメッセージの転送を Windows のプロセス間通信 (IPC) システムを使用します。The IpcServerChannel class uses the Windows interprocess communication (IPC) system to transport messages between application domains on the same computer. 同じコンピューター上のアプリケーション ドメイン間で通信している場合、IPC チャネルは TCP または HTTP チャネルより高速です。When communicating between application domains on the same computer, the IPC channel is much faster than the TCP or HTTP channels.

サーバー側でメッセージの追加の処理を実行する指定の実装、IServerChannelSinkProviderによって処理されるすべてのメッセージのインターフェイス、IpcServerChannelインスタンスが渡されます。To perform additional processing of messages on the server side, specify an implementation of the IServerChannelSinkProvider interface through which all messages processed by the IpcServerChannel instance are passed.

IpcServerChannelインスタンスがバイナリ形式または SOAP 形式でシリアル化されたメッセージを受け入れます。The IpcServerChannel instance accepts messages serialized in either binary or SOAP format.

AIpcServerChannelオブジェクトで設定できる構成プロパティが関連付けられている構成ファイルのいずれかの実行時 (静的なを呼び出すことによってRemotingConfiguration.Configureメソッド) またはプログラムによって (を渡すことによって、IDictionaryコレクション、 IpcServerChannelコンス トラクター)。A IpcServerChannel object has associated configuration properties that can be set at run time either in a configuration file (by invoking the static RemotingConfiguration.Configure method) or programmatically (by passing an IDictionary collection to the IpcServerChannel constructor). これらの構成プロパティの一覧は、ドキュメントを参照してください、IpcServerChannelコンス トラクター。For a list of these configuration properties, see the documentation for the IpcServerChannel constructor.

注意事項

設定するときに、exclusiveAddressUseプロパティをfalseで、properties引数、いくつかIpcServerChannel同じ名前付きパイプのオブジェクトを登録することができます。When setting the exclusiveAddressUse property to false in the properties argument, several IpcServerChannel objects can be registered for the same named pipe. このような場合は、要求が登録されているチャネルのいずれかに移動できます。In such a case requests can go to any of the channels registered. この設定は、Alc も使用されている場合にのみセキュリティで保護されたと見なされます。This setting is considered secure only if ALCs are also used.

コンストラクター

IpcServerChannel(IDictionary, IServerChannelSinkProvider) IpcServerChannel(IDictionary, IServerChannelSinkProvider) IpcServerChannel(IDictionary, IServerChannelSinkProvider) IpcServerChannel(IDictionary, IServerChannelSinkProvider)

チャネル プロパティとシンクを指定して、IpcServerChannel クラスの新しいインスタンスを初期化します。Initializes a new instance of the IpcServerChannel class with the specified channel properties and sink.

IpcServerChannel(IDictionary, IServerChannelSinkProvider, CommonSecurityDescriptor) IpcServerChannel(IDictionary, IServerChannelSinkProvider, CommonSecurityDescriptor) IpcServerChannel(IDictionary, IServerChannelSinkProvider, CommonSecurityDescriptor) IpcServerChannel(IDictionary, IServerChannelSinkProvider, CommonSecurityDescriptor)

チャネル プロパティ、シンク、およびセキュリティ記述子を指定して、IpcServerChannel クラスの新しいインスタンスを初期化します。Initializes a new instance of the IpcServerChannel class with the specified channel properties, sink, and security descriptor.

IpcServerChannel(String) IpcServerChannel(String) IpcServerChannel(String) IpcServerChannel(String)

IPC ポート名を指定して IpcServerChannel クラスの新しいインスタンスを初期化します。Initializes a new instance of the IpcServerChannel class with the specified IPC port name.

IpcServerChannel(String, String) IpcServerChannel(String, String) IpcServerChannel(String, String) IpcServerChannel(String, String)

チャネル名と IPC ポート名を指定して、IpcServerChannel クラスの新しいインスタンスを初期化します。Initializes a new instance of the IpcServerChannel class with the specified channel name and IPC port name.

IpcServerChannel(String, String, IServerChannelSinkProvider) IpcServerChannel(String, String, IServerChannelSinkProvider) IpcServerChannel(String, String, IServerChannelSinkProvider) IpcServerChannel(String, String, IServerChannelSinkProvider)

チャネル名、IPC ポート名、およびシンクを指定して、IpcServerChannel クラスの新しいインスタンスを初期化します。Initializes a new instance of the IpcServerChannel class with the specified channel name, IPC port name, and sink.

プロパティ

ChannelData ChannelData ChannelData ChannelData

チャネル固有のデータを取得します。Gets channel-specific data.

ChannelName ChannelName ChannelName ChannelName

現在のチャネルの名前を取得します。Gets the name of the current channel.

ChannelPriority ChannelPriority ChannelPriority ChannelPriority

現在のチャネルの優先順位を取得します。Gets the priority of the current channel.

IsSecured IsSecured IsSecured IsSecured

現在のチャネルをセキュリティで保護しているかどうかを示すブール値を取得または設定します。Gets or sets a Boolean value that indicates whether the current channel is secure.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetChannelUri() GetChannelUri() GetChannelUri() GetChannelUri()

現在のチャネルの URI を返します。Returns the URI of the current channel.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
GetUrlsForUri(String) GetUrlsForUri(String) GetUrlsForUri(String) GetUrlsForUri(String)

指定した URI を持つオブジェクトのすべての URL のうち、現在の IpcChannel インスタンスでホストされている URL の配列を返します。Returns an array of all the URLs for the object with the specified URI, hosted on the current IpcChannel instance.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
Parse(String, String) Parse(String, String) Parse(String, String) Parse(String, String)

指定した URL からチャネル URI と既知のリモート オブジェクト URI を抽出します。Extracts the channel URI and the remote well-known object URI from the specified URL.

StartListening(Object) StartListening(Object) StartListening(Object) StartListening(Object)

現在のチャネルに対して、要求の待機を開始するように指示します。Instructs the current channel to start listening for requests.

StopListening(Object) StopListening(Object) StopListening(Object) StopListening(Object)

現在のチャネルに対して、要求の待機を停止するように指示します。Instructs the current channel to stop listening for requests.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象