RemotingConfiguration.RegisterActivatedServiceType Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Регистрирует объект Type со стороны службы в качестве объекта, который может активироваться по запросу клиента.
Перегрузки
RegisterActivatedServiceType(ActivatedServiceTypeEntry) |
Регистрирует тип объекта в предоставленном со стороны службы ActivatedServiceTypeEntry в качестве типа, который может активироваться по запросу клиента. |
RegisterActivatedServiceType(Type) |
Регистрирует указанный тип объектов, зарегистрированных со стороны службы, в качестве типа, который может быть активирован по запросу клиента. |
RegisterActivatedServiceType(ActivatedServiceTypeEntry)
Регистрирует тип объекта в предоставленном со стороны службы ActivatedServiceTypeEntry в качестве типа, который может активироваться по запросу клиента.
public:
static void RegisterActivatedServiceType(System::Runtime::Remoting::ActivatedServiceTypeEntry ^ entry);
public static void RegisterActivatedServiceType (System.Runtime.Remoting.ActivatedServiceTypeEntry entry);
static member RegisterActivatedServiceType : System.Runtime.Remoting.ActivatedServiceTypeEntry -> unit
Public Shared Sub RegisterActivatedServiceType (entry As ActivatedServiceTypeEntry)
Параметры
Параметры конфигурации для активированного клиентом типа.
Исключения
По крайней мере у одного из вызывающих операторов, находящихся в верхней части стека вызовов, отсутствует разрешение на настройку типов и каналов удаленного взаимодействия.
Комментарии
Чтобы создать экземпляр объекта, активированного клиентом, на сервере необходимо знать его Type , и он должен быть зарегистрирован на сервере с помощью RegisterActivatedServiceType метода . Чтобы получить прокси-сервер для нового экземпляра объекта, активированного клиентом, клиент должен сначала зарегистрировать канал в ChannelServices , а затем активировать объект путем вызова new
или Activator.CreateInstance.
Чтобы активировать тип объекта, активированный клиентом, с помощью ключевого new
слова необходимо сначала зарегистрировать тип объекта на стороне клиента с помощью RegisterActivatedClientType метода .
RegisterActivatedClientType Вызов метода предоставляет инфраструктуре удаленного взаимодействия расположение удаленного приложения, где new
пытается создать его. С другой стороны, если вы используете CreateInstance метод для создания нового экземпляра объекта, активированного клиентом, необходимо указать URL-адрес удаленного приложения в качестве параметра, поэтому предварительная регистрация на стороне клиента не требуется. Чтобы предоставить CreateInstance методу URL-адрес сервера, на котором требуется создать объект, необходимо инкапсулировать URL-адрес в экземпляре UrlAttribute класса .
Подробное описание активируемых клиентом объектов см. в разделе Активация клиента.
См. также раздел
Применяется к
RegisterActivatedServiceType(Type)
Регистрирует указанный тип объектов, зарегистрированных со стороны службы, в качестве типа, который может быть активирован по запросу клиента.
public:
static void RegisterActivatedServiceType(Type ^ type);
public static void RegisterActivatedServiceType (Type type);
static member RegisterActivatedServiceType : Type -> unit
Public Shared Sub RegisterActivatedServiceType (type As Type)
Параметры
Исключения
По крайней мере у одного из вызывающих операторов, находящихся в верхней части стека вызовов, отсутствует разрешение на настройку типов и каналов удаленного взаимодействия.
Примеры
В следующем примере кода демонстрируется регистрация типа объекта на сервере в качестве типа, который может быть активирован клиентом. Код клиента, соответствующий представленному коду сервера, см. в примере метода RegisterActivatedClientType .
#using <system.dll>
#using <system.runtime.remoting.dll>
#using "service.dll"
using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Tcp;
int main()
{
ChannelServices::RegisterChannel( gcnew TcpChannel( 8082 ) );
RemotingConfiguration::RegisterActivatedServiceType( HelloServiceClass::typeid );
Console::WriteLine( "Press enter to stop this process." );
Console::ReadLine();
return 0;
}
using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Tcp;
public class ServerClass {
public static void Main() {
ChannelServices.RegisterChannel(new TcpChannel(8082));
RemotingConfiguration.RegisterActivatedServiceType(typeof(HelloServiceClass));
Console.WriteLine("Press enter to stop this process.");
Console.ReadLine();
}
}
Imports System.Runtime.Remoting
Imports System.Runtime.Remoting.Channels
Imports System.Runtime.Remoting.Channels.Tcp
Public Class ServerClass
Public Shared Sub Main()
ChannelServices.RegisterChannel(New TcpChannel(8082))
RemotingConfiguration.RegisterActivatedServiceType(GetType(HelloServiceClass))
Console.WriteLine("Press enter to stop this process.")
Console.ReadLine()
End Sub
End Class
В следующем примере кода показан объект службы, зарегистрированный в приведенном выше примере кода.
#using <system.dll>
using namespace System;
public ref class HelloServiceClass: public MarshalByRefObject
{
private:
static int n_instance;
public:
HelloServiceClass()
{
n_instance++;
Console::WriteLine( "{0} has been created. Instance # = {1}", this->GetType()->Name, n_instance );
}
~HelloServiceClass()
{
Console::WriteLine( "Destroyed instance {0} of HelloServiceClass.", n_instance );
n_instance--;
}
String^ HelloMethod( String^ name )
{
// Reports that the method was called.
Console::WriteLine();
Console::WriteLine( "Called HelloMethod on instance {0} with the '{1}' parameter.", n_instance, name );
// Calculates and returns the result to the client.
return String::Format( "Hi there {0}", name );
}
};
using System;
public class HelloServiceClass : MarshalByRefObject {
static int n_instance;
public HelloServiceClass() {
n_instance++;
Console.WriteLine(this.GetType().Name + " has been created. Instance # = {0}", n_instance);
}
~HelloServiceClass() {
Console.WriteLine("Destroyed instance {0} of HelloServiceClass.", n_instance);
n_instance --;
}
public String HelloMethod(String name) {
// Reports that the method was called.
Console.WriteLine();
Console.WriteLine("Called HelloMethod on instance {0} with the '{1}' parameter.",
n_instance, name);
// Calculates and returns the result to the client.
return "Hi there " + name + ".";
}
}
Public Class HelloServiceClass
Inherits MarshalByRefObject
Private Shared n_instance As Integer
Public Sub New()
n_instance += 1
Console.WriteLine(Me.GetType().Name + " has been created. Instance # = {0}", n_instance)
End Sub
Protected Overrides Sub Finalize()
Console.WriteLine("Destroyed instance {0} of HelloServiceClass.", n_instance)
n_instance -= 1
MyBase.Finalize()
End Sub
Public Function HelloMethod(name As [String]) As [String]
' Reports that the method was called.
Console.WriteLine()
Console.WriteLine("Called HelloMethod on instance {0} with the '{1}' parameter.", n_instance, name)
' Calculates and returns the result to the client.
Return "Hi there " + name + "."
End Function 'HelloMethod
End Class
Комментарии
Чтобы создать экземпляр объекта, активированного клиентом, на сервере необходимо знать его Type , и он должен быть зарегистрирован на сервере с помощью RegisterActivatedServiceType метода . Чтобы получить прокси-сервер для нового экземпляра объекта, активированного клиентом, клиент должен сначала зарегистрировать канал в ChannelServices , а затем активировать объект путем вызова new
или Activator.CreateInstance.
Чтобы активировать тип объекта, активированный клиентом, с помощью ключевого new
слова необходимо сначала зарегистрировать тип объекта на стороне клиента с помощью RegisterActivatedClientType метода .
RegisterActivatedClientType Вызов метода предоставляет инфраструктуре удаленного взаимодействия расположение удаленного приложения, где new
пытается создать его. С другой стороны, если вы используете CreateInstance метод для создания нового экземпляра объекта, активированного клиентом, необходимо указать URL-адрес удаленного приложения в качестве параметра, поэтому предварительная регистрация на стороне клиента не требуется. Чтобы предоставить CreateInstance методу URL-адрес сервера, на котором требуется создать объект, необходимо инкапсулировать URL-адрес в экземпляре UrlAttribute класса .
Подробное описание активируемых клиентом объектов см. в разделе Активация клиента.