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 и активировав объект путем вызова new или Activator.GetObject.

Важно отметить, что сам удаленный объект не создается в процессе регистрации. Это происходит только в том случае, если клиент пытается вызвать метод для объекта или активирует объект на стороне клиента.

Более подробное описание активируемых сервером объектов и активации удаленных объектов см. в разделе Активация удаленных объектов.

Конструкторы

WellKnownServiceTypeEntry(String, String, String, WellKnownObjectMode)	Инициализирует новый экземпляр класса WellKnownServiceTypeEntry с заданным именем типа, именем сборки, объекта URI и WellKnownObjectMode.
WellKnownServiceTypeEntry(Type, String, WellKnownObjectMode)	Инициализирует новый экземпляр класса WellKnownServiceTypeEntryс заданным Type, объектом URI, и WellKnownObjectMode.

Свойства

AssemblyName	Получает имя сборки типа объекта, сконфигурированного для работы в качестве типа удаленной активации. (Унаследовано от TypeEntry)
ContextAttributes	Возвращает или устанавливает атрибуты контекста для типа службы, активированной сервером.
Mode	Возвращает WellKnownObjectMode тип службы, активированной сервером.
ObjectType	Возвращает Type тип службы, активированной сервером.
ObjectUri	Возвращает URI хорошо известного типа службы.
TypeName	Получает полное имя сборки типа объекта, сконфигурированного для работы в качестве типа удаленной активации. (Унаследовано от TypeEntry)

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает имя типа, имя сборки, объект URI и WellKnownObjectMode типа, активированного сервером String.

См. также раздел

• RegisterWellKnownServiceType(Type, String, WellKnownObjectMode)
• Активация сервером