WellKnownClientTypeEntryとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

WellKnownClientTypeEntry クラス

サーバー側でアクティブ化される型 (単一の呼び出しまたはシングルトン) としてクライアントに登録されたオブジェクト型の値を保持します。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Class WellKnownClientTypeEntry
    Inherits TypeEntry

Visual Basic (使用法)

Dim instance As WellKnownClientTypeEntry

[ComVisibleAttribute(true)] 
public class WellKnownClientTypeEntry : TypeEntry

C++

[ComVisibleAttribute(true)] 
public ref class WellKnownClientTypeEntry :
 public TypeEntry

/** @attribute ComVisibleAttribute(true) */ 
public class WellKnownClientTypeEntry extends
 TypeEntry

JScript

ComVisibleAttribute(true) 
public class WellKnownClientTypeEntry extends
 TypeEntry

解説

サーバー側でアクティブ化される型には、単一の呼び出しまたはシングルトンがあります。クラスが単一呼び出し型として登録されている場合は、クライアントからの呼び出しが到達するたびに、新しいインスタンスが作成されます。シングルトンオブジェクトのすべての呼び出しは、オブジェクトが収集されていない限り、そのオブジェクトの 1 つのインスタンスによって処理されます。

登録されたサーバー側でアクティブ化されるオブジェクトの URI を知っているすべてのクライアントは、ChannelServices で優先するチャネルを登録し、new または Activator.GetObject を呼び出してそのオブジェクトをアクティブにすることにより、このオブジェクトに対するプロキシを取得できます。new でサーバー側でアクティブ化されるオブジェクトをアクティブにするには、初めに RegisterWellKnownClientType メソッドを使用して、そのサーバー側でアクティブ化されるオブジェクトの型をクライアント側で登録しておく必要があります。RegisterWellKnownClientType を呼び出すと、new キーワードに作成を許可するリモートオブジェクトの場所がリモート処理インフラストラクチャに通知されます。一方、Activator.GetObject メソッドを使用して、サーバー側でアクティブ化されるオブジェクトをアクティブにする場合は、そのオブジェクトの URL を引数として指定する必要があります。このため、クライアント側での事前の登録は必要ありません。

サーバー側でアクティブ化されるオブジェクトとリモートオブジェクトアクティベーションの詳細については、「リモートオブジェクトのアクティべーション」を参照してください。

使用例

Visual Basic

Imports System
Imports System.Runtime.Remoting
Imports System.Runtime.Remoting.Channels
Imports System.Runtime.Remoting.Channels.Http

Public Class MyClient
   
   Public Shared Sub Main()
      ' Create a 'HttpChannel' object and  register with channel services.
      ChannelServices.RegisterChannel(New HttpChannel())
      Console.WriteLine(" Start calling from Client One.......")
      Dim myWellKnownClientTypeEntry As New
 WellKnownClientTypeEntry(GetType(HelloServer), _ 
                                                  "http://localhost:8086/SayHello")
      myWellKnownClientTypeEntry.ApplicationUrl = "http://localhost:8086/SayHello"
      RemotingConfiguration.RegisterWellKnownClientType(myWellKnownClientTypeEntry)
      ' Get the proxy object for the remote object.
      Dim myHelloServerObject As New
 HelloServer()
      ' Retrieve an array of object types registered on the 
      ' client end as well-known types.
      Dim myWellKnownClientTypeEntryCollection As
 WellKnownClientTypeEntry() = _ 
                                       RemotingConfiguration.GetRegisteredWellKnownClientTypes()
      Console.WriteLine("The Application Url to activate the Remote
 Object :" + _ 
                                           myWellKnownClientTypeEntryCollection(0).ApplicationUrl)
      Console.WriteLine("The 'WellKnownClientTypeEntry' object
 :" + _ 
                                              myWellKnownClientTypeEntryCollection(0).ToString())
      ' Make remote method calls.
      Dim i As Integer
      For i = 0 To 4
         Console.WriteLine(myHelloServerObject.HelloMethod(" Client
 One"))
      Next i
   End Sub 'Main
End Class 'MyClient

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Http;

public class MyClient 
{
   public static void Main()
   {
   // Create a 'HttpChannel' object and  register with channel services.
   ChannelServices.RegisterChannel(new HttpChannel());
   Console.WriteLine(" Start calling from Client One.......");
   WellKnownClientTypeEntry myWellKnownClientTypeEntry = 
                  new WellKnownClientTypeEntry(typeof(HelloServer)
,
                                  "http://localhost:8086/SayHello");
   myWellKnownClientTypeEntry.ApplicationUrl="http://localhost:8086/SayHello";
   RemotingConfiguration.RegisterWellKnownClientType(myWellKnownClientTypeEntry);
   // Get the proxy object for the remote object.
   HelloServer myHelloServerObject = new HelloServer();
   // Retrieve an array of object types registered on the 
   // client end as well-known types.
   WellKnownClientTypeEntry [] myWellKnownClientTypeEntryCollection = 
          RemotingConfiguration.GetRegisteredWellKnownClientTypes();
   Console.WriteLine("The Application Url to activate the Remote Object :"
        +myWellKnownClientTypeEntryCollection[0].ApplicationUrl);
   Console.WriteLine("The 'WellKnownClientTypeEntry' object :"
            +myWellKnownClientTypeEntryCollection[0].ToString());
   // Make remote method calls.
   for (int i = 0; i < 5; i++)
         Console.WriteLine(myHelloServerObject.HelloMethod(" Client One"));
   }
}

C++

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

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

int main()
{
   // Create a 'HttpChannel' object and  register with channel services.
   ChannelServices::RegisterChannel( gcnew HttpChannel );
   Console::WriteLine( " Start calling from Client One......." );
   WellKnownClientTypeEntry^ myWellKnownClientTypeEntry = gcnew WellKnownClientTypeEntry(
 HelloServer::typeid,"http://localhost:8086/SayHello" );
   myWellKnownClientTypeEntry->ApplicationUrl = "http://localhost:8086/SayHello";
   RemotingConfiguration::RegisterWellKnownClientType( myWellKnownClientTypeEntry
 );

   // Get the proxy object for the remote object.
   HelloServer^ myHelloServerObject = gcnew HelloServer;

   // Retrieve an array of object types registered on the 
   // client end as well-known types.
   array<WellKnownClientTypeEntry^>^myWellKnownClientTypeEntryCollection =
 RemotingConfiguration::GetRegisteredWellKnownClientTypes();
   Console::WriteLine( "The Application Url to activate the Remote Object :{0}",
 myWellKnownClientTypeEntryCollection[ 0 ]->ApplicationUrl );
   Console::WriteLine( "The 'WellKnownClientTypeEntry' object :{0}", myWellKnownClientTypeEntryCollection[
 0 ] );

   // Make remote method calls.
   for ( int i = 0; i < 5; i++ )
      Console::WriteLine( myHelloServerObject->HelloMethod( " Client One"
 ) );
}

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

public class MyClient
{
    public static void main(String[]
 args)
    {
        // Create a 'HttpChannel' object and  register with channel
 services.
        ChannelServices.RegisterChannel(new HttpChannel());
        Console.WriteLine(" Start calling from Client One.......");
        WellKnownClientTypeEntry myWellKnownClientTypeEntry = 
            new WellKnownClientTypeEntry(HelloServer.class.ToType()
,
            "http://localhost:8086/SayHello");
        myWellKnownClientTypeEntry.
            set_ApplicationUrl("http://localhost:8086/SayHello");
        RemotingConfiguration.RegisterWellKnownClientType(
            myWellKnownClientTypeEntry);
        // Get the proxy object for the remote object.
        HelloServer myHelloServerObject = new HelloServer();
        // Retrieve an array of object types registered on the 
        // client end as well-known types.
        WellKnownClientTypeEntry myWellKnownClientTypeEntryCollection[] =
            RemotingConfiguration.GetRegisteredWellKnownClientTypes();
        Console.WriteLine("The Application Url to activate the Remote Object
 :" 
            + myWellKnownClientTypeEntryCollection[0].get_ApplicationUrl());
        Console.WriteLine("The 'WellKnownClientTypeEntry' object :" 
            + myWellKnownClientTypeEntryCollection.get_Item(0).ToString());
        // Make remote method calls.
        for (int i = 0; i < 5; i++) {
            Console.WriteLine(myHelloServerObject.HelloMethod(" Client One"));
        }
    } //main
} //MyClient

継承階層

System.Object
System.Runtime.Remoting.TypeEntry
System.Runtime.Remoting.WellKnownClientTypeEntry

スレッドセーフ

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
WellKnownClientTypeEntry メンバ
System.Runtime.Remoting 名前空間
RegisterWellKnownClientType
その他の技術情報
サーバーアクティベーション

WellKnownClientTypeEntry コンストラクタ (String, String, String)

指定した型、アセンブリ名、および URL を使用して、WellKnownClientTypeEntry クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    typeName As String, _
    assemblyName As String, _
    objectUrl As String _
)

Visual Basic (使用法)

Dim typeName As String
Dim assemblyName As String
Dim objectUrl As String

Dim instance As New WellKnownClientTypeEntry(typeName,
 assemblyName, objectUrl)

public WellKnownClientTypeEntry (
    string typeName,
    string assemblyName,
    string objectUrl
)

C++

public:
WellKnownClientTypeEntry (
    String^ typeName, 
    String^ assemblyName, 
    String^ objectUrl
)

public WellKnownClientTypeEntry (
    String typeName, 
    String assemblyName, 
    String objectUrl
)

JScript

public function WellKnownClientTypeEntry (
    typeName : String, 
    assemblyName : String, 
    objectUrl : String
)

パラメータ

typeName: サーバー側でアクティブ化される型の型名。

assemblyName: サーバー側でアクティブ化される型のアセンブリ名。

objectUrl: サーバー側でアクティブ化される型の URL。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

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

WellKnownClientTypeEntry コンストラクタ (Type, String)

指定した型と URL を使用して、WellKnownClientTypeEntry クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    type As Type, _
    objectUrl As String _
)

Visual Basic (使用法)

Dim type As Type
Dim objectUrl As String

Dim instance As New WellKnownClientTypeEntry(type,
 objectUrl)

public WellKnownClientTypeEntry (
    Type type,
    string objectUrl
)

C++

public:
WellKnownClientTypeEntry (
    Type^ type, 
    String^ objectUrl
)

public WellKnownClientTypeEntry (
    Type type, 
    String objectUrl
)

JScript

public function WellKnownClientTypeEntry (
    type : Type, 
    objectUrl : String
)

パラメータ

type: サーバー側でアクティブ化される型の Type。

objectUrl: サーバー側でアクティブ化される型の URL。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

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

WellKnownClientTypeEntry コンストラクタ

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

名前	説明
WellKnownClientTypeEntry (Type, String)	指定した型と URL を使用して、WellKnownClientTypeEntry クラスの新しいインスタンスを初期化します。
WellKnownClientTypeEntry (String, String, String)	指定した型、アセンブリ名、および URL を使用して、WellKnownClientTypeEntry クラスの新しいインスタンスを初期化します。

参照

WellKnownClientTypeEntry プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	ApplicationUrl	型をアクティブにするアプリケーションの URL を取得または設定します。
	AssemblyName	リモートアクティブ型になるように構成されたオブジェクト型のアセンブリ名を取得します。 ( TypeEntry から継承されます。)
	ObjectType	サーバー側でアクティブ化されるクライアント型の Type を取得します。
	ObjectUrl	サーバー側でアクティブ化されるクライアントオブジェクトの URL を取得します。
	TypeName	リモートアクティブ型になるように構成されたオブジェクト型の完全な型名を取得します。 ( TypeEntry から継承されます。)

参照

その他の技術情報

サーバーアクティベーション

WellKnownClientTypeEntry メソッド

パブリックメソッドパブリックメソッド

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

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

プロテクトメソッド

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

参照

その他の技術情報

サーバーアクティベーション

WellKnownClientTypeEntry メンバ

サーバー側でアクティブ化される型 (単一の呼び出しまたはシングルトン) としてクライアントに登録されたオブジェクト型の値を保持します。

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

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

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

パブリックプロパティ

	名前	説明
	ApplicationUrl	型をアクティブにするアプリケーションの URL を取得または設定します。
	AssemblyName	リモートアクティブ型になるように構成されたオブジェクト型のアセンブリ名を取得します。(TypeEntry から継承されます。)
	ObjectType	サーバー側でアクティブ化されるクライアント型の Type を取得します。
	ObjectUrl	サーバー側でアクティブ化されるクライアントオブジェクトの URL を取得します。
	TypeName	リモートアクティブ型になるように構成されたオブジェクト型の完全な型名を取得します。(TypeEntry から継承されます。)

パブリックメソッド

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

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

プロテクトメソッド

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