WellKnownServiceTypeEntry 類別

定義

命名空間:

System.Runtime.Remoting

組件:

mscorlib.dll

儲存服務端註冊為伺服器啟用型物件（單一呼叫或單例）的物件類型值。

public ref class WellKnownServiceTypeEntry : System::Runtime::Remoting::TypeEntry

[System.Runtime.InteropServices.ComVisible(true)]
public class WellKnownServiceTypeEntry : System.Runtime.Remoting.TypeEntry

[<System.Runtime.InteropServices.ComVisible(true)>]
type WellKnownServiceTypeEntry = class
    inherit TypeEntry

Public Class WellKnownServiceTypeEntry
Inherits TypeEntry

繼承

Object

TypeEntry

WellKnownServiceTypeEntry

屬性

ComVisibleAttribute

範例

#using <System.Runtime.Remoting.dll>
#using <System.dll>
#using <WellKnownServiceTypeEntry_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 it with the 
   // channel services.
   ChannelServices::RegisterChannel( gcnew HttpChannel( 8086 ) );

   // Record the 'HelloServer' type as 'Singleton' well-known type.
   WellKnownServiceTypeEntry^ myWellKnownServiceTypeEntry = gcnew WellKnownServiceTypeEntry( HelloServer::typeid,"SayHello",WellKnownObjectMode::Singleton );

   // Register the remote object as well-known type.
   RemotingConfiguration::RegisterWellKnownServiceType( myWellKnownServiceTypeEntry );

   // Retrieve object types registered on the service end 
   // as well-known types.
   array<WellKnownServiceTypeEntry^>^myWellKnownServiceTypeEntryCollection = RemotingConfiguration::GetRegisteredWellKnownServiceTypes();
   Console::WriteLine( "The 'WellKnownObjectMode' of the remote object : {0}", myWellKnownServiceTypeEntryCollection[ 0 ]->Mode );
   Console::WriteLine( "The 'WellKnownServiceTypeEntry' object: {0}", myWellKnownServiceTypeEntryCollection[ 0 ] );
   Console::WriteLine( "Started the Server, Hit <enter> to exit..." );
   Console::ReadLine();
}

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

public class MyServer 
{
   public static void Main() 
   {
      // Create a 'HttpChannel' object and register it with the 
      // channel services.
      ChannelServices.RegisterChannel(new HttpChannel(8086));
      // Record the 'HelloServer' type as 'Singleton' well-known type.
      WellKnownServiceTypeEntry myWellKnownServiceTypeEntry= 
          new WellKnownServiceTypeEntry(typeof(HelloServer),
                                        "SayHello",
                                        WellKnownObjectMode.Singleton);
      // Register the remote object as well-known type.
      RemotingConfiguration.RegisterWellKnownServiceType(
                                          myWellKnownServiceTypeEntry);
      // Retrieve object types registered on the service end 
      // as well-known types.
      WellKnownServiceTypeEntry [] myWellKnownServiceTypeEntryCollection = 
            RemotingConfiguration.GetRegisteredWellKnownServiceTypes();
      Console.WriteLine("The 'WellKnownObjectMode' of the remote object : "
                       +myWellKnownServiceTypeEntryCollection[0].Mode);
      Console.WriteLine("The 'WellKnownServiceTypeEntry' object: "+
                  myWellKnownServiceTypeEntryCollection[0].ToString());
      Console.WriteLine("Started the Server, Hit <enter> to exit...");
      Console.ReadLine();
   }
}

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

Public Class MyServer
   
   Public Shared Sub Main()
      ' Create a 'HttpChannel' object and register it with the 
      ' channel services.
      ChannelServices.RegisterChannel(New HttpChannel(8086))
      ' Record the 'HelloServer' type as 'Singleton' well-known type.
      Dim myWellKnownServiceTypeEntry As New WellKnownServiceTypeEntry(GetType(HelloServer), _ 
                                                 "SayHello", WellKnownObjectMode.Singleton)
      ' Register the remote object as well-known type.
      RemotingConfiguration.RegisterWellKnownServiceType(myWellKnownServiceTypeEntry)
      ' Retrieve object types registered on the service end 
      ' as well-known types.
      Dim myWellKnownServiceTypeEntryCollection As WellKnownServiceTypeEntry() = _ 
                                      RemotingConfiguration.GetRegisteredWellKnownServiceTypes()
      Console.WriteLine("The 'WellKnownObjectMode' of the remote object : " + _
                                        myWellKnownServiceTypeEntryCollection(0).Mode.ToString())
      Console.WriteLine("The 'WellKnownServiceTypeEntry' object: " + _ 
                                             myWellKnownServiceTypeEntryCollection(0).ToString())
      Console.WriteLine("Started the Server, Hit <enter> to exit...")
      Console.ReadLine()
   End Sub
End Class

備註

伺服器啟用的物件類型可以是單一呼叫或單呼叫。 如果物件類型是單一呼叫，每當客戶端呼叫進入時，就會建立一個新的物件實例。 所有對單一物件的呼叫都會由該物件的一個實例處理。

任何知道此物件 URI 的用戶端，皆可透過註冊其偏好通道ChannelServices並呼叫 或 Activator.GetObject來啟動物件new，取得該物件的代理。

值得注意的是，遠端物件本身並非由註冊過程所建立。 這只會發生在用戶端嘗試呼叫物件的方法或從用戶端啟動物件時。

建構函式

名稱	Description
WellKnownServiceTypeEntry(String, String, String, WellKnownObjectMode)	初始化一個新的類別實例 WellKnownServiceTypeEntry ，包含給定的型別名稱、組合名稱、物件 URI 及 WellKnownObjectMode。
WellKnownServiceTypeEntry(Type, String, WellKnownObjectMode)	初始化一個新的類別實例 WellKnownServiceTypeEntry ，包含給定 Type的 、 物件 URI 和 WellKnownObjectMode。

屬性

名稱	Description
AssemblyName	取得設定為遠端啟用型態的物件類型組合名稱。 (繼承來源 TypeEntry)
ContextAttributes	取得或設定伺服器啟用服務類型的上下文屬性。
Mode	取得 WellKnownObjectMode 伺服器啟用的服務類型。
ObjectType	取得 Type 伺服器啟用的服務類型。
ObjectUri	取得知名服務類型的 URI。
TypeName	取得物件類型的完整型別名稱，設定為遠端啟用型態。 (繼承來源 TypeEntry)

方法

名稱	Description
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	回傳伺服器啟用型態String的型別名稱、組合名稱、物件 URI 以及 WellKnownObjectMode 。

另請參閱

• RegisterWellKnownServiceType(Type, String, WellKnownObjectMode)