IClientChannelSinkProvider

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

IClientChannelSinkProvider インターフェイス

リモート処理メッセージが流れているクライアント チャネルのクライアント チャネル シンクを作成します。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Interface IClientChannelSinkProvider

Visual Basic (使用法)

Dim instance As IClientChannelSinkProvider

C#

[ComVisibleAttribute(true)] 
public interface IClientChannelSinkProvider

C++

[ComVisibleAttribute(true)] 
public interface class IClientChannelSinkProvider

J#

/** @attribute ComVisibleAttribute(true) */ 
public interface IClientChannelSinkProvider

JScript

ComVisibleAttribute(true) 
public interface IClientChannelSinkProvider

解説

チャネル シンクは、IClientChannelSinkProvider インターフェイスの実装を通じてクライアント チャネルに接続されます。すべてのリモート処理クライアント チャンネルには、パラメータとして IClientChannelSinkProvider を受け取るコンストラクタが用意されています。

チャネル シンク プロバイダはチェインに格納されます。外部のチャネル シンク プロバイダをチャネル コンストラクタに渡す場合は、その前にすべてのチャネル シンク プロバイダを 1 つのチェインにまとめます。この処理を実行できるようにするために、IClientChannelSinkProvider は Next というプロパティを提供します。

複数のチャネル シンク プロバイダが構成ファイルで指定されている場合、リモート処理インフラストラクチャは、構成ファイルに出現する順序でそれらのプロバイダをチェインに含めます。RemotingConfiguration.Configure の呼び出し中にチャネルが作成されるとき、チャネル シンク プロバイダは作成されます。

使用例

このインターフェイスの実装を示すコード例を次に示します。

C#

public class ClientSinkProvider : IClientChannelSinkProvider
{

    // The next provider in the chain.
    private IClientChannelSinkProvider nextProvider;

    public IClientChannelSinkProvider Next
    {
        [SecurityPermission(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.Infrastructure)]
        get
        {
            return(nextProvider);
        }
        [SecurityPermission(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.Infrastructure)]
        set
        {
            nextProvider = value;
        }
    }

    [SecurityPermission(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.Infrastructure)]
    public IClientChannelSink CreateSink (IChannelSender channel,
 String url, Object remoteChannelData)
    {

        Console.WriteLine("Creating ClientSink for {0}",
 url);

        // Create the next sink in the chain.
        IClientChannelSink nextSink = nextProvider.CreateSink(channel, url, remoteChannelData);

        // Hook our sink up to it.
        return( new ClientSink(nextSink) );
    }

    // This constructor is required in order to use the provider in
 file-based configuration.
    // It need not do anything unless you want to use the information
 in the parameters.
    public ClientSinkProvider (IDictionary properties, ICollection
 providerData) {}
    
}

C++

[System::Security::Permissions::PermissionSet(System::Security::
   Permissions::SecurityAction::Demand, Name = "FullTrust")]
public ref class ClientSinkProvider: public
 IClientChannelSinkProvider
{
private:

   // The next provider in the chain.
   IClientChannelSinkProvider^ nextProvider;

public:
   property IClientChannelSinkProvider^ Next 
   {
      virtual IClientChannelSinkProvider^ get()
      {
         return (nextProvider);
      }

      virtual void set( IClientChannelSinkProvider^
 value )
      {
         nextProvider = value;
      }
   }

   virtual IClientChannelSink^ CreateSink( IChannelSender^ channel, String^ url,
 Object^ remoteChannelData )
   {
      Console::WriteLine( "Creating ClientSink for {0}",
 url );
      
      // Create the next sink in the chain.
      IClientChannelSink^ nextSink = nextProvider->CreateSink( channel, url, remoteChannelData
 );
      
      // Hook our sink up to it.
      return (gcnew ClientSink( nextSink ));
   }

   // This constructor is required in order to use the provider in file-based
 configuration.
   // It need not do anything unless you want to use the information
 in the parameters.
   ClientSinkProvider( IDictionary^ /*properties*/, ICollection^ /*providerData*/
 ){}
};

J#

/** @attribute SecurityPermission(SecurityAction.Demand, Flags = SecurityPermissionFlag.Infrastructure)
*/
public class ClientSinkProvider implements
 IClientChannelSinkProvider
{
    // The next provider in the chain.
    private IClientChannelSinkProvider nextProvider;

    /** @property 
     */
    public IClientChannelSinkProvider get_Next()
    {
        return nextProvider;
    }//get_Next

    /** @property
     */
    public void set_Next(IClientChannelSinkProvider
 value)
    {
        nextProvider = value;
    }//set_Next

    public IClientChannelSink CreateSink(IChannelSender channel,
 String url,
        Object remoteChannelData)
    {
        Console.WriteLine("Creating ClientSink for {0}",
 url);
        // Create the next sink in the chain.
        IClientChannelSink nextSink = nextProvider.CreateSink(channel, url,
            remoteChannelData);
        // Hook our sink up to it.
        return new ClientSink(nextSink);
    } //CreateSink

    // This constructor is required in order to use the provider in
 file-based 
    //configuration. It need not do anything unless you want to use
 the 
    // information in the parameters.
    public ClientSinkProvider(IDictionary properties, ICollection
 providerData)
    {
    } //ClientSinkProvider 
} //ClientSinkProvider

対応するクライアント シンクの実装例については、IClientChannelSink インターフェイスのドキュメントを参照してください。

プラットフォーム

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、1.1、1.0

参照

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

IClientChannelSinkProvider プロパティ

パブリック プロパティ

	名前	説明
	Next	チャネル シンク プロバイダ チェイン内の次のシンク プロバイダを取得または設定します。

参照

関連項目

IClientChannelSinkProvider インターフェイス
System.Runtime.Remoting.Channels 名前空間

IClientChannelSinkProvider メソッド

パブリック メソッド

	名前	説明
	CreateSink	シンク チェインを作成します。

参照

関連項目

IClientChannelSinkProvider インターフェイス
System.Runtime.Remoting.Channels 名前空間

IClientChannelSinkProvider メンバ

リモート処理メッセージが流れているクライアント チャネルのクライアント チャネル シンクを作成します。

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

パブリック プロパティ

	名前	説明
	Next	チャネル シンク プロバイダ チェイン内の次のシンク プロバイダを取得または設定します。

パブリック メソッド

	名前	説明
	CreateSink	シンク チェインを作成します。

参照

関連項目

IClientChannelSinkProvider インターフェイス
System.Runtime.Remoting.Channels 名前空間