IChannelReceiverHook.AddHookChannelUri メソッド

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

IChannelReceiverHook.AddHookChannelUri メソッド

チャネル フックが待機する URI を追加します。

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

Visual Basic (宣言)

Sub AddHookChannelUri ( _
    channelUri As String _
)

Visual Basic (使用法)

Dim instance As IChannelReceiverHook
Dim channelUri As String

instance.AddHookChannelUri(channelUri)

C#

void AddHookChannelUri (
    string channelUri
)

C++

void AddHookChannelUri (
    String^ channelUri
)

J#

void AddHookChannelUri (
    String channelUri
)

JScript

function AddHookChannelUri (
    channelUri : String
)

パラメータ

channelUri

チャネル フックが待機する URI。

例外

例外の種類	条件
SecurityException	直前の呼び出し元に、インフラストラクチャ アクセス許可がありません。

解説

クライアント コードでは、このメソッドを直接呼び出さないでください。

使用例

Visual Basic

Class CustomChannel
   Inherits BaseChannelWithProperties
   Implements IChannelReceiverHook, IChannelReceiver, IChannel,
 IChannelSender

   Public Sub AddHookChannelUri(ByVal
 channelUri As String) _
                        Implements IChannelReceiverHook.AddHookChannelUri

      If Not (channelUri Is
 Nothing) Then
         Dim uris As String()
 = dataStore.ChannelUris

         ' This implementation only allows one URI to be hooked in.
         If uris Is Nothing
 Then
            Dim newUris(1) As String
            newUris(0) = channelUri
            dataStore.ChannelUris = newUris
            wantsListen = False
         Else
            Dim msg As String
            msg = "This channel is already listening for data,
 and " + _
                  "can't be hooked into at this stage."
            Throw New System.Runtime.Remoting.RemotingException(msg)
         End If
      End If
   End Sub

   ' The rest of CustomChannel's implementation.

C#

class CustomChannel : BaseChannelWithProperties, IChannelReceiverHook
,
                      IChannelReceiver, IChannel, IChannelSender {

   public void AddHookChannelUri(string
 channelUri) {

      if (channelUri != null) {
         string [] uris = dataStore.ChannelUris;
             
         // This implementation only allows one URI to be hooked in.
         if (uris == null) {
            string [] newUris = new string[1];
            newUris[0] = channelUri;
            dataStore.ChannelUris = newUris;
            wantsToListen = false;
         } else {
            string msg = "This channel is already listening
 for " +
               "data, and can't be hooked into at this stage.";
            throw new System.Runtime.Remoting.RemotingException(msg);
         }
      }
   }
   // The rest of CustomChannel's implementation.

C++

ref class CustomChannel: public BaseChannelWithProperties,
 public IChannelReceiverHook, public IChannelReceiver,
 public IChannel, public IChannelSender
{
public:
   virtual void AddHookChannelUri( String^ channelUri )
   {
      if ( channelUri != nullptr )
      {
         array<String^>^uris = dataStore->ChannelUris;

         // This implementation only allows one URI to be hooked in.
         if ( uris == nullptr )
         {
            array<String^>^newUris = gcnew array<String^>(1);
            newUris[ 0 ] = channelUri;
            dataStore->ChannelUris = newUris;
            wantsToListen = false;
         }
         else
         {
            String^ msg = "This channel is already listening for
 data, and can't be hooked into at this stage.";
            throw gcnew System::Runtime::Remoting::RemotingException( msg );
         }
      }
   }

   // The rest of CustomChannel's implementation.

J#

/** @attribute SecurityPermission(SecurityAction.Demand,
   Flags = SecurityPermissionFlag.Infrastructure)
 */
/** @attribute SecurityPermission(SecurityAction.InheritanceDemand, Flags = SecurityPermissionFlag.Infrastructure)
*/
class CustomChannel extends  BaseChannelWithProperties
    implements  IChannelReceiverHook,IChannelReceiver,IChannel,IChannelSender
{
    public void AddHookChannelUri(String channelUri)
    {
        if (channelUri != null) {
            String uris[] = dataStore.get_ChannelUris();

            // This implementation only allows one URI to be hooked
 in.
            if (uris == null) {
                String newUris[] = new String[1];
                newUris.set_Item(0, channelUri);
                dataStore.set_ChannelUris(newUris);
                wantsToListen = false;
            }
            else {
                try {
                    String msg = "This channel is already listening for
 " 
                        + "data, and can't be hooked into at this
 stage.";
                }
                catch (System.Runtime.Remoting.RemotingException
 srrre) {
                }
            }
        }
    } //AddHookChannelUri
// The rest of CustomChannel's implementation.

.NET Framework のセキュリティ

• SecurityPermission  (インフラストラクチャ コードを操作するために必要なアクセス許可)。要求値 : SecurityAction.LinkDemand; アクセス許可値 : SecurityPermissionFlag.Infrastructure

プラットフォーム

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

参照

関連項目
IChannelReceiverHook インターフェイス
IChannelReceiverHook メンバ
System.Runtime.Remoting.Channels 名前空間