サーバーでアクティブにできる既知の型として、クライアント エンドで提供される WellKnownClientTypeEntry に記録されているオブジェクト Type を登録します。
Overloads Public Shared Sub RegisterWellKnownClientType( _
ByVal entry As WellKnownClientTypeEntry _)
[C#]
public static void RegisterWellKnownClientType(WellKnownClientTypeEntryentry);
[C++]
public: static void RegisterWellKnownClientType(WellKnownClientTypeEntry* entry);
[JScript]
public static function RegisterWellKnownClientType(
entry : WellKnownClientTypeEntry);
パラメータ
- entry
既知の型の構成設定。
例外
| 例外の種類 | 条件 |
|---|---|
| SecurityException | コールスタックの上位にある 1 つ以上の呼び出し元に、リモート処理の型とチャネルを構成するためのアクセス許可がありません。 |
解説
登録された既知のオブジェクトの URI を知っているすべてのクライアントは、 ChannelServices で優先するチャネルを登録し、New または Activator.GetObject を呼び出してそのオブジェクトをアクティブにすることにより、このオブジェクト用にプロキシを取得できます。New で既知のオブジェクトをアクティブにするには、初めに RegisterWellKnownClientType メソッドを使用して、その既知のオブジェクトの型をクライアント側で登録しておく必要があります。 RegisterWellKnownClientType メソッドを呼び出すと、リモート オブジェクトの場所がリモート処理インフラストラクチャに通知され、New キーワードでオブジェクトを作成できるようになります。一方、 Activator.GetObject メソッドを使用して、既知のオブジェクトをアクティブにする場合は、そのオブジェクトの URL を引数として指定する必要があります。このため、クライアント エンドでの事前の登録は必要ありません。
既知のオブジェクトの詳細については、「 サーバー アクティベーション 」を参照してください。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- SecurityPermission (リモート処理インフラストラクチャを構成するために必要なアクセス許可)要求値: SecurityAction.Demand; アクセス許可値: SecurityPermissionFlag.RemotingConfiguration
参照
RemotingConfiguration クラス | RemotingConfiguration メンバ | System.Runtime.Remoting 名前空間 | RemotingConfiguration.RegisterWellKnownClientType オーバーロードの一覧 | WellKnownClientTypeEntry | WellKnownServiceTypeEntry