Hostschnittstellen für .NET Framework, Version 2.0, und höhere Versionen

Aktualisiert: November 2007

In diesem Abschnitt werden die Schnittstellen beschrieben, die von nicht verwalteten Hosts verwendet werden, um die Common Language Runtime (CLR) in ihre Anwendungen zu integrieren. Die Informationen betreffen .NET Framework, Version 2.0, und höhere Versionen. Diese Schnittstellen ermöglichen dem Host die Steuerung von mehr Aspekten der Laufzeit, als dies in den Versionen 1.0 und 1.1 möglich war, und liefern eine engere Integration zwischen der CLR und dem Ausführungsmodell des Hosts.

In .NET Framework, Version 1, ermöglichte das Hostmodell einem nicht verwalteten Host, die CLR in einen Prozess zu laden, bestimmte Einstellungen zu konfigurieren und Ereignisbenachrichtigungen zu empfangen. Im Allgemeinen wurden der Host und die CLR jedoch im betreffenden Prozess unabhängig voneinander ausgeführt. .NET Framework, Version 2.0, und höhere Versionen stellen neue Abstraktionsebenen zur Verfügung, mit denen der Host viele Ressourcen bereitstellen kann, die derzeit von den Typen in der Win32-Assembly bereitgestellt werden, und erweitern die Funktionalität, die der Host konfigurieren kann.

In diesem Abschnitt

• IActionOnCLREvent
  Stellt eine Methode bereit, die einen Rückruf für ein registriertes Ereignis ausführt.

• IApartmentCallback
  Stellt Methoden für Rückrufe innerhalb eines Apartments bereit.

• IAppDomainBinding
  Stellt Methoden zum Festlegen der Laufzeitkonfiguration bereit.

• ICatalogServices
  Stellt Methoden zum Katalogisieren von Diensten bereit. (Diese Schnittstelle unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen.)

• ICLRAssemblyIdentityManager
  Stellt Methoden bereit, die die Kommunikation über Assemblys zwischen dem Host und der CLR unterstützen.

• ICLRAssemblyReferenceList
  Verwaltet eine Liste von Assemblys, die nicht vom Host, sondern von der CLR geladen werden.

• ICLRControl
  Stellt Methoden bereit, mit denen der Host auf verschiedene Aspekte der CLR zugreifen und diese konfigurieren kann.

• ICLRDebugManager
  Stellt Methoden bereit, mit denen ein Host einer Gruppe von Aufgaben einen Bezeichner und einen angezeigten Namen zuordnen kann.

• ICLRErrorReportingManager
  Stellt Methoden bereit, die dem Host das Konfigurieren benutzerdefinierter Heapdumps für die Fehlerberichterstattung ermöglichen.

• ICLRGCManager
  Stellt Methoden bereit, mit deren Hilfe der Host mit dem Garbage Collection-System der CLR interagieren kann.

• ICLRHostBindingPolicyManager
  Stellt Methoden bereit, mit denen der Host Änderungen in Richtlinieninformationen für Assemblys auswerten und übermitteln kann.

• ICLRHostProtectionManager
  Ermöglicht dem Host, bestimmte verwaltete Klassen, Methoden, Eigenschaften und Felder für das Ausführen in teilweise vertrauenswürdigem Code zu sperren.

• ICLRIoCompletionManager
  Implementiert eine Rückrufmethode, die es dem Host ermöglicht, die CLR über den Status der angegebenen E/A-Anforderungen zu benachrichtigen.

• ICLRMemoryNotificationCallback
  Ermöglicht dem Host, mit einem ähnlichen Verfahren wie dem der Win32-CreateMemoryResourceNotification-Funktion Speicherdruckbedingungen zu melden.

• ICLROnEventManager
  Stellt Methoden bereit, mit denen der Host Rückrufe für CLR-Ereignisse registrieren bzw. deren Registrierung aufheben kann.

• ICLRPolicyManager
  Stellt Methoden bereit, mit denen der Host Richtlinienaktionen angeben kann, die bei Fehlern oder Timeouts durchgeführt werden sollen.

• ICLRProbingAssemblyEnum
  Stellt Methoden bereit, die dem Host das Abrufen der gesuchten Identitäten einer Assembly mithilfe interner Identitätsinformationen der CLR für diese Assembly ermöglichen, ohne dass die betreffende Identität dabei erstellt und verstanden werden muss.

• ICLRReferenceAssemblyEnum
  Stellt Methoden bereit, mit denen der Host Assemblys, auf die von einer Datei oder einem Stream verwiesen wird, mithilfe von CLR-internen Assemblyidentitätsdaten bearbeiten kann, ohne diese Identitäten erstellen oder verstehen zu müssen.

• ICLRRuntimeHost
  Stellt mit ICorRuntimeHost vergleichbare Funktionen mit einer zusätzlichen Methode zum Festlegen der Schnittstelle des Hoststeuerelements bereit.

• ICLRSyncManager
  Stellt Methoden bereit, mit denen der Host in seiner Synchronisierungsimplementierung Informationen zu angeforderten Aufgaben abrufen sowie Deadlocks erkennen kann.

• ICLRTask-Schnittstelle
  Stellt Methoden bereit, die es dem Host ermöglichen, die CLR anzufordern oder der CLR eine Benachrichtigung über die zugewiesene Aufgabe bereitzustellen.

• ICLRTaskManager-Schnittstelle
  Stellt Methoden bereit, mit denen es dem Host möglich ist, die momentan ausgeführte Aufgabe abzurufen, die geographische Sprache und Kultur für die Aufgabe festzulegen und die CLR ausdrücklich anzuweisen, eine neue Aufgabe zu erstellen.

• ICLRValidator
  Stellt Methoden zur Validierung von übertragbaren ausführbaren Abbildern (Portable Executable, PE) und zum Melden von Validierungsfehlern bereit.

• ICorConfiguration
  Stellt Methoden für das Konfigurieren der CLR bereit.

• ICorThreadpool
  Stellt Methoden zum Zugreifen auf den Threadpool bereit.

• IDebuggerInfo
  Stellt Methoden zum Abrufen von Informationen über den Zustand der Debugdienste bereit.

• IDebuggerThreadControl
  Stellt Methoden für das Benachrichtigen des Hosts über die Blockierung und das Aufheben der Blockierung von Threads durch die Debugdienste zur Verfügung.

• IGCHost
  Stellt Methoden zum Abrufen von Informationen über das Garbage Collection-System und zum Steuern einiger Aspekte der Garbage Collection bereit.

• IGCHostControl
  Stellt eine Methode bereit, die es dem Garbage Collector ermöglicht, den Host zum Ändern der Grenzen des virtuellen Arbeitsspeichers aufzufordern.

• IGCThreadControl
  Stellt Methoden für die Teilnahme an der Planung von Threads bereit, die andernfalls für eine Garbage Collection blockiert werden.

• IHostAssemblyManager
  Stellt Methoden bereit, die es einem Host ermöglichen, Assemblys anzugeben, die von der CLR oder vom Host geladen werden sollen.

• IHostAssemblyStore
  Stellt Methoden bereit, mit denen ein Host unabhängig von der CLR Assemblys und Module laden kann.

• IHostAutoEvent
  Stellt eine Darstellung eines Ereignisses für automatisches Zurücksetzen bereit, das vom Host implementiert wurde.

• IHostControl
  Stellt Methoden zum Konfigurieren des Ladevorgangs von Assemblys und zum Ermitteln der vom Host unterstützten Hostschnittstellen bereit.

• IHostCrst
  Dient als Darstellung des Hosts eines für das Threading kritischen Abschnitts.

• IHostGCManager
  Stellt Methoden bereit, die den Host über Ereignisse im Garbage Collection-Mechanismus benachrichtigen, der von der CLR implementiert wird.

• IHostIoCompletionManager
  Stellt Methoden bereit, die es der CLR ermöglichen, mit den E/A-Abschlussanschlüssen des Hosts zu interagieren.

• IHostMAlloc
  Stellt Methoden bereit, die es der Common Language Runtime ermöglichen, genaue Zuordnungen vom Heap durch den Host anzufordern.

• IHostManualEvent
  Stellt die Hostimplementierung einer Darstellung eines Ereignisses für manuelles Zurücksetzen bereit.

• IHostMemoryManager
  Stellt Methoden bereit, mit denen die CLR virtuellen Arbeitsspeicher über den Host anfordern kann, anstatt die normalen Win32-Funktionen für virtuellen Arbeitsspeicher zu verwenden.

• IHostPolicyManager
  Stellt Methoden bereit, die den Host über die Aktionen benachrichtigen, die die CLR bei Abbrüchen, Timeouts oder Fehlern durchführt.

• IHostSecurityContext
  Ermöglicht der CLR, die Informationen des vom Host implementierten Sicherheitskontexts beizubehalten.

• IHostSecurityManager
  Stellt Methoden bereit, die den Zugriff auf den Sicherheitskontext aktuell ausgeführter Threads und die Steuerung dieses Sicherheitskontexts ermöglichen.

• IHostSemaphore
  Stellt eine Darstellung eines Semaphors bereit, das vom Host implementiert wurde.

• IHostSyncManager
  Stellt Methoden bereit, mit denen die CLR Synchronisierungsprimitive durch Aufrufen des Hosts erstellen kann, anstatt die Win32-Synchronisierungsfunktionen zu verwenden.

• IHostTask-Schnittstelle
  Stellt Methoden bereit, die es der CLR ermöglichen, mit dem Host zu kommunizieren, um Aufgaben zu verwalten.

• IHostTaskManager-Schnittstelle
  Stellt Methoden bereit, die der CLR die Arbeit mit Aufgaben über den Host ermöglichen, statt die Betriebssystemthreading- oder Fiberstandardfunktionen zu verwenden.

• IHostThreadPoolManager
  Stellt Methoden bereit, mit denen die CLR den Threadpool konfigurieren und Arbeitsaufgaben in die Warteschlange einreihen kann.

• IManagedObject
  Stellt Methoden zum Steuern eines verwalteten Objekts bereit.

• IObjectHandle
  Stellt eine Methode für das Entpacken von Objekten aus der Dereferenzierung bereit, die anhand eines Werts gemarshallt wurden.

• ITypeName
  Stellt Methoden zum Abrufen von Typnameninformationen bereit. (Diese Schnittstelle unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen.)

• ITypeNameBuilder
  Stellt Methoden zum Erstellen eines Typnamens bereit. (Diese Schnittstelle unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen.)

• ITypeNameFactory
  Stellt Methoden zum Zerlegen eines Typnamens bereit. (Diese Schnittstelle unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen.)

• IValidator
  Stellt Methoden zur Validierung von übertragbaren ausführbaren Abbildern (Portable Executable, PE) und zum Melden von Validierungsfehlern bereit.

Verwandte Abschnitte

• Hostschnittstellen für .NET Framework, Versionen 1.0 und 1.1
  Enthält Themen, die die Hostschnittstellen beschreiben, die in früheren Versionen von .NET Framework bereitgestellt wurden.