HostingEnvironment.RegisterObject(IRegisteredObject) HostingEnvironment.RegisterObject(IRegisteredObject) HostingEnvironment.RegisterObject(IRegisteredObject) HostingEnvironment.RegisterObject(IRegisteredObject) Method

Definition

Fügt in die Liste von registrierten Objekten für die Anwendung ein Objekt ein.Places an object in the list of registered objects for the application.

public:
 static void RegisterObject(System::Web::Hosting::IRegisteredObject ^ obj);
public static void RegisterObject (System.Web.Hosting.IRegisteredObject obj);
static member RegisterObject : System.Web.Hosting.IRegisteredObject -> unit
Public Shared Sub RegisterObject (obj As IRegisteredObject)

Parameter

obj
IRegisteredObject IRegisteredObject IRegisteredObject IRegisteredObject

Das zu registrierende Objekt.The object to register.

Beispiele

Das folgende Codebeispiel ist eine Implementierung einer Start -Methode für ein registriertes Objekt.The following code example is an implementation of a Start method for a registered object. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im IRegisteredObject Beispiel Abschnitt des Themas Interface Overview.For the full code required to run the example, see the Example section of the IRegisteredObject interface overview topic.

public void Start()
{
  HostingEnvironment.RegisterObject(this);
}
Public Sub Start()
  HostingEnvironment.RegisterObject(Me)
End Sub

Hinweise

Die ApplicationManager -Klasse ermöglicht es Methoden außerhalb der aktuellen Anwendungsdomäne, Objekte innerhalb der aktuellen Anwendungsdomäne zu erstellen, zu verwalten und zu zerstören.The ApplicationManager class enables methods outside the current application domain to create, manage, and destroy objects inside the current application domain. Die RegisterObject -Methode wird verwendet, um zuvor erstellte Objekte in der Hostingumgebung zu registrieren.The RegisterObject method is used to register previously created objects with the hosting environment. Mit der RegisterObject -Methode registrierte-Objekte müssen IRegisteredObject die-Schnittstelle implementieren.Objects registered with the RegisterObject method must implement the IRegisteredObject interface.

Führen Sie die folgenden Schritte aus, um ein registriertes Objekt zu verwenden:To use a registered object, follow these steps:

  1. Erstellen Sie eine neue Instanz des registrierten Objekts, indem Sie ApplicationManager.CreateObject die-Methode aufrufen.Create a new instance of your registered object by calling the ApplicationManager.CreateObject method.

  2. Ruft eine typspezifische Methode auf, um das neue-Objekt zu initialisieren.Call a type-specific method to initialize your new object. In der Initialisierungs Methode wird die RegisterObject -Methode aufgerufen, um das Objekt der Liste der registrierten Objekte hinzuzufügen.In the initialization method, call the RegisterObject method to add the object to the list of registered objects.

  3. Wenden Sie ApplicationManager.GetObject die-Methode an, um bei Bedarf das registrierte Objekt zurückzugeben.Call the ApplicationManager.GetObject method to return the registered object when required.

  4. Wenn Sie das Objekt beenden möchten, müssen Sie die ApplicationManager.StopObject -Methode aufzurufen.When you wish to stop your object, call the ApplicationManager.StopObject method. Die ApplicationManager.StopObject -Methode ruft wiederum die IRegisteredObject.Stop -Methode auf.The ApplicationManager.StopObject method in turn calls the IRegisteredObject.Stop method.

  5. In der IRegisteredObject.Stop -Methode muss das-Objekt die UnregisterObject -Methode aufzurufen.In the IRegisteredObject.Stop method, have your object call the UnregisterObject method.

Gilt für:

Siehe auch