ActivatedClientTypeEntry

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

ActivatedClientTypeEntry クラス

サーバーでアクティブにできる型としてクライアント エンドで登録されたオブジェクト型の値を保持します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As ActivatedClientTypeEntry

C#

[ComVisibleAttribute(true)] 
public class ActivatedClientTypeEntry : TypeEntry

C++

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

J#

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

JScript

ComVisibleAttribute(true) 
public class ActivatedClientTypeEntry extends
 TypeEntry

解説

クライアント側でアクティブ化されるオブジェクトのインスタンスをクライアントで作成するには、Type を確認し、RegisterActivatedClientType メソッドを使用して、クライアント側で登録する必要があります。クライアント側でアクティブ化されるオブジェクトの新しいインスタンスのプロキシを取得するには、クライアントは最初にそのチャネルを ChannelServices で登録してから new を呼び出して、そのオブジェクトをアクティブにする必要があります。

クライアント側でアクティブ化されるオブジェクトの型を new キーワードを使用してアクティブにするには、初めに RegisterActivatedClientType メソッドを使用して、そのオブジェクトの型をクライアント側で登録しておく必要があります。RegisterActivatedClientType を呼び出すと、new が作成しようとするリモート アプリケーションの場所がリモート処理インフラストラクチャに通知されます。一方、Activator.CreateInstance メソッドを使用して、クライアント側でアクティブ化されるオブジェクトの新しいインスタンスを作成する場合は、リモート アプリケーションの URL をパラメータで指定する必要があります。このため、クライアント エンドでの事前の登録は必要ありません。Activator.CreateInstance メソッドに、オブジェクトを作成するサーバーの URL を指定するには、UrlAttribute クラスのインスタンスにその URL をカプセル化する必要があります。

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

使用例

ActivatedClientTypeEntry を使用して、クライアント側でアクティブ化されるリモート オブジェクトを登録する方法を次のコード例に示します。この例には、クライアント、サーバー、およびクライアントとサーバーから使用されるリモート オブジェクトの 3 つの部分が含まれます。

クライアントのコード例を次に示します。

Visual Basic

Imports System
Imports System.Runtime.Remoting
Imports System.Runtime.Remoting.Channels
Imports System.Runtime.Remoting.Channels.Tcp

Public Class MyClient
    
    Public Shared Sub Main()
        ' Register TCP Channel.
        ChannelServices.RegisterChannel(New TcpChannel())

        ' Create activated client type entry.
        Dim myActivatedClientTypeEntry As _
            New ActivatedClientTypeEntry(GetType(HelloServer),
 _
            "tcp://localhost:8082")

        ' Register type on client to activate it on the server.
        RemotingConfiguration.RegisterActivatedClientType( _
            myActivatedClientTypeEntry)

        ' Activate a client activated object type.
        Dim myHelloServer As New
 HelloServer("ParameterString")

        ' Print the object type.
        Console.WriteLine("Object type of client activated object:
 " + _
            myActivatedClientTypeEntry.ObjectType.ToString())

        ' Print the application URL.
        Console.WriteLine("Application url where the type is activated:
 " + _
            myActivatedClientTypeEntry.ApplicationUrl)

        ' Print the string representation of the type entry.
        Console.WriteLine( _
            "Type name, assembly name and application URL "
 + _
            "of the remote object: " + _
            myActivatedClientTypeEntry.ToString())

        ' Print a blank line.
        Console.WriteLine()

        ' Check that server was located.
        If myHelloServer Is Nothing
 Then
            Console.WriteLine("Could not locate server")
        Else
            Console.WriteLine("Calling remote object")
            Console.WriteLine(myHelloServer.HelloMethod("Bill"))
        End If
    End Sub 'Main
End Class 'MyClient

C#

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Tcp;

public class MyClient
{
    public static void Main()
    {
        // Register TCP Channel.
        ChannelServices.RegisterChannel(new TcpChannel());

        // Create activated client type entry.
        ActivatedClientTypeEntry myActivatedClientTypeEntry =
            new ActivatedClientTypeEntry(typeof(HelloServer),
            "tcp://localhost:8082");

        // Register type on client to activate it on the server.
        RemotingConfiguration.RegisterActivatedClientType(
            myActivatedClientTypeEntry);

        // Activate a client activated object type.
        HelloServer myHelloServer = new HelloServer("ParameterString");

        // Print the object type.
        Console.WriteLine(
            "Object type of client activated object: " +
            myActivatedClientTypeEntry.ObjectType.ToString());

        // Print the application URL.
        Console.WriteLine(
            "Application url where the type is activated: " +
            myActivatedClientTypeEntry.ApplicationUrl);

        // Print the string representation of the type entry.
        Console.WriteLine(
            "Type name, assembly name and application URL " +
            "of the remote object: " + 
            myActivatedClientTypeEntry.ToString());

        // Print a blank line.
        Console.WriteLine();

        // Check that server was located.
        if (myHelloServer == null)
        {
            Console.WriteLine("Could not locate server");
        }
        else
        {
            Console.WriteLine("Calling remote object");
            Console.WriteLine(myHelloServer.HelloMethod("Bill"));
        }
    }
}

C++

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

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Tcp;
static void main()
{
   // Register TCP Channel.
   ChannelServices::RegisterChannel( gcnew TcpChannel );
   
   // Create activated client type entry.
   ActivatedClientTypeEntry^ activatedClientTypeEntry = gcnew ActivatedClientTypeEntry(
 HelloServer::typeid, "tcp://localhost:8082" );
   
   // Register type on client to activate it on the server.
   RemotingConfiguration::RegisterActivatedClientType( activatedClientTypeEntry );
   
   // Activate a client activated object type.
   HelloServer^ helloServer = gcnew HelloServer( "ParameterString" );
   
   // Print the object type.
   Console::WriteLine( "Object type of client activated object: {0}", activatedClientTypeEntry->ObjectType->ToString()
 );
   
   // Print the application URL.
   Console::WriteLine( "Application url where the type is activated: {0}",
 activatedClientTypeEntry->ApplicationUrl->ToString() );
   
   // Print the string representation of the type entry.
   Console::WriteLine( "Type and assembly name and application URL of the remote
 object: {0}", activatedClientTypeEntry->ToString() );
   
   // Print a blank line.
   Console::WriteLine();
   
   // Check that server was located.
   if (  !helloServer )
   {
      Console::WriteLine( "Could not locate server" );
   }
   else
   {
      Console::WriteLine( "Calling remote object" );
      Console::WriteLine( helloServer->HelloMethod( "Bill" ) );
   }
}

J#

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

public class MyClient
{
    public static void main(String[]
 args)
    {
        // Register TCP Channel.
        ChannelServices.RegisterChannel(new TcpChannel());
        // Create activated client type entry.
        ActivatedClientTypeEntry myActivatedClientTypeEntry = 
            new ActivatedClientTypeEntry(HelloServer.class.ToType(),
 
            "tcp://localhost:8082");
        // Register type on client to activate it on the server.
        RemotingConfiguration.RegisterActivatedClientType(
            myActivatedClientTypeEntry);
        // Activate a client activated object type.
        HelloServer myHelloServer = new HelloServer("ParameterString");
        // Print the object type.
        Console.WriteLine(("Object type of client activated object: " 
            + myActivatedClientTypeEntry.get_ObjectType().ToString()));
        // Print the application URL.
        Console.WriteLine("Application url where the type is activated: "
 
            + myActivatedClientTypeEntry.get_ApplicationUrl());
        // Print the string representation of the type entry.
        Console.WriteLine("Type name, assembly name and application URL "
 
            + "of the remote object: " + myActivatedClientTypeEntry.ToString());
        // Print a blank line.
        Console.WriteLine();
        // Check that server was located.
        if (myHelloServer == null) {
            Console.WriteLine("Could not locate server");
        }
        else {
            Console.WriteLine("Calling remote object");
            Console.WriteLine(myHelloServer.HelloMethod("Bill"));
        }
    } //main
} //MyClient

このクライアントのサーバーのコード例を次に示します。

Visual Basic

Imports System
Imports System.Runtime.Remoting
Imports System.Runtime.Remoting.Channels
Imports System.Runtime.Remoting.Channels.Tcp

Public Class MyServer
    
    Public Shared Sub Main()
        ChannelServices.RegisterChannel(New TcpChannel(8082))
        RemotingConfiguration.RegisterActivatedServiceType(GetType(HelloServer))
        Console.WriteLine("Press enter to stop this process")
        Console.ReadLine()
    End Sub 'Main

End Class 'MyServer

C#

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Tcp;

public class MyServer
{
    public static void Main()
    {
        ChannelServices.RegisterChannel(new TcpChannel(8082));
        RemotingConfiguration.RegisterActivatedServiceType(typeof(HelloServer));
        Console.WriteLine("Press enter to stop this process");
        Console.ReadLine();
   }
}

C++

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

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Tcp;
void main()
{
   ChannelServices::RegisterChannel( gcnew TcpChannel( 8082 ) );
   RemotingConfiguration::RegisterActivatedServiceType( HelloServer::typeid );
   Console::WriteLine( "Press enter to stop this process"
 );
   Console::ReadLine();
}

J#

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

public class MyServer
{
    public static void main(String[]
 args)
    {
        ChannelServices.RegisterChannel(new TcpChannel(8082));
        RemotingConfiguration.RegisterActivatedServiceType(HelloServer.
            class.ToType());
        Console.WriteLine("Press enter to stop this process");
        Console.ReadLine();
    } //main
} //MyServer

クライアントとサーバーから使用されるリモート オブジェクトを提供するコード例を次に示します。

Visual Basic

Imports System

Public Class HelloServer
    Inherits MarshalByRefObject
    
    Public Sub New(myString
 As String)
        Console.WriteLine("HelloServer activated")
        Console.WriteLine("Parameter passed to the constructor
 is " + myString)
    End Sub 'New
    
    Public Function HelloMethod(myName As
 String) As String
        Console.WriteLine("HelloMethod : {0}", myName)
        Return "Hi there " + myName
    End Function 'HelloMethod
End Class 'HelloServer

C#

using System;
public class HelloServer : MarshalByRefObject
{
    public HelloServer(String myString)
    {
        Console.WriteLine("HelloServer activated");
        Console.WriteLine("Parameter passed to the constructor is "+myString);
    }
    public String HelloMethod(String myName)
    {
        Console.WriteLine("HelloMethod : {0}",myName);
        return "Hi there " + myName;
    }
}

C++

using namespace System;
public ref class HelloServer: public
 MarshalByRefObject
{
public:
   HelloServer( String^ myString )
   {
      Console::WriteLine( "HelloServer activated" );
      Console::WriteLine( "Paramater passed to the constructor is {0}",
 myString );
   }

   String^ HelloMethod( String^ myName )
   {
      Console::WriteLine( "HelloMethod : {0}", myName );
      return String::Format( "Hi there {0}", myName
 );
   }

};

J#

import System.*;  

public class HelloServer extends MarshalByRefObject
{
    public HelloServer(String myString)
    {
        Console.WriteLine("HelloServer activated");
        Console.WriteLine("Parameter passed to the constructor is " 
            + myString);
    } //HelloServer

    public String HelloMethod(String myName)
    {
        Console.WriteLine("HelloMethod : {0}", myName);
        return "Hi there " + myName;
    } //HelloMethod
} //HelloServer

継承階層

System.Object
   System.Runtime.Remoting.TypeEntry
    System.Runtime.Remoting.ActivatedClientTypeEntry

スレッド セーフ

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

プラットフォーム

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

参照

関連項目
ActivatedClientTypeEntry メンバ
System.Runtime.Remoting 名前空間
RegisterActivatedClientType
その他の技術情報
クライアント アクティベーション

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim typeName As String
Dim assemblyName As String
Dim appUrl As String

Dim instance As New ActivatedClientTypeEntry(typeName,
 assemblyName, appUrl)

C#

public ActivatedClientTypeEntry (
    string typeName,
    string assemblyName,
    string appUrl
)

C++

public:
ActivatedClientTypeEntry (
    String^ typeName, 
    String^ assemblyName, 
    String^ appUrl
)

J#

public ActivatedClientTypeEntry (
    String typeName, 
    String assemblyName, 
    String appUrl
)

JScript

public function ActivatedClientTypeEntry (
    typeName : String, 
    assemblyName : String, 
    appUrl : String
)

パラメータ

typeName

クライアント側でアクティブ化される型の型名。

assemblyName

クライアント側でアクティブ化される型のアセンブリ名。

appUrl

型をアクティブにするアプリケーションの URL。

プラットフォーム

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

参照

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

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

指定した Type とアプリケーションの URL を使用して、ActivatedClientTypeEntry クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim type As Type
Dim appUrl As String

Dim instance As New ActivatedClientTypeEntry(type,
 appUrl)

C#

public ActivatedClientTypeEntry (
    Type type,
    string appUrl
)

C++

public:
ActivatedClientTypeEntry (
    Type^ type, 
    String^ appUrl
)

J#

public ActivatedClientTypeEntry (
    Type type, 
    String appUrl
)

JScript

public function ActivatedClientTypeEntry (
    type : Type, 
    appUrl : String
)

パラメータ

type

クライアント側でアクティブ化される型の Type。

appUrl

型をアクティブにするアプリケーションの URL。

解説

型のアセンブリ名は、type パラメータから取得します。

使用例

ActivatedClientTypeEntry の作成方法を次のコード例に示します。

Visual Basic

' Create activated client type entry.
Dim myActivatedClientTypeEntry As _
    New ActivatedClientTypeEntry(GetType(HelloServer),
 _
    "tcp://localhost:8082")

C#

// Create activated client type entry.
ActivatedClientTypeEntry myActivatedClientTypeEntry =
    new ActivatedClientTypeEntry(typeof(HelloServer),
    "tcp://localhost:8082");

C++

// Create activated client type entry.
ActivatedClientTypeEntry^ activatedClientTypeEntry = gcnew ActivatedClientTypeEntry(
 HelloServer::typeid, "tcp://localhost:8082" );

J#

// Create activated client type entry.
ActivatedClientTypeEntry myActivatedClientTypeEntry = 
    new ActivatedClientTypeEntry(HelloServer.class.ToType(),
 
    "tcp://localhost:8082");

プラットフォーム

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

参照

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

ActivatedClientTypeEntry コンストラクタ

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

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

参照

関連項目

ActivatedClientTypeEntry クラス
ActivatedClientTypeEntry メンバ
System.Runtime.Remoting 名前空間

ActivatedClientTypeEntry プロパティ

パブリック プロパティ

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

参照

関連項目

ActivatedClientTypeEntry クラス
System.Runtime.Remoting 名前空間
RegisterActivatedClientType

その他の技術情報

クライアント アクティベーション

ActivatedClientTypeEntry メソッド

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

ActivatedClientTypeEntry クラス
System.Runtime.Remoting 名前空間
RegisterActivatedClientType

その他の技術情報

クライアント アクティベーション

ActivatedClientTypeEntry メンバ

サーバーでアクティブにできる型としてクライアント エンドで登録されたオブジェクト型の値を保持します。

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

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

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

パブリック プロパティ

	名前	説明
	ApplicationUrl	型をアクティブにするアプリケーションの URL を取得します。
	AssemblyName	リモート アクティブ型になるように構成されたオブジェクト型のアセンブリ名を取得します。(TypeEntry から継承されます。)
	ContextAttributes	クライアント側でアクティブ化される型のコンテキスト属性を取得または設定します。
	ObjectType	クライアント側でアクティブ化される型の Type を取得します。
	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 から継承されます。)

参照

関連項目

ActivatedClientTypeEntry クラス
System.Runtime.Remoting 名前空間
RegisterActivatedClientType

その他の技術情報

クライアント アクティベーション