CLR-Hostingschnittstellen

  • Artikel

In diesem Abschnitt werden die Schnittstellen beschrieben, die nicht verwaltete Hosts verwenden können, um die Common Language Runtime (CLR) in ihre Anwendungen zu integrieren. Die Informationen beziehen sich auf .NET Framework 2.0 und höhere Versionen. Mithilfe dieser Schnittstellen kann der Host viel mehr Aspekte der Runtime steuern als in den Versionen 1.0 und 1.1. Außerdem bieten die Schnittstellen eine wesentlich engere Integration zwischen der CLR und dem Ausführungsmodell des Hosts.

In den Versionen 1.0 und 1.1 von .NET Framework konnte ein nicht verwalteter Host im Rahmen des Hostingmodells die CLR in einen Prozess laden, bestimmte Einstellungen konfigurieren und Ereignisbenachrichtigungen empfangen. Im Allgemeinen wurden Host und CLR in diesem Prozess allerdings unabhängig ausgeführt. Ab der Version 2.0 von .NET Framework kann der Host dank neuer Abstraktionsebenen viele der Ressourcen bereitstellen, die derzeit von den Typen in der Win32-Assembly bereitgestellt werden, sowie den Umfang der Funktionen erweitern, die der Host konfigurieren kann.

In diesem Abschnitt

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

IApartmentCallback-Schnittstelle
Stellt Methoden zum Ausführen von Rückrufen innerhalb eines Apartments bereit.

IAppDomainBinding-Schnittstelle
Stellt Methoden zum Festlegen der Laufzeitkonfiguration bereit.

ICatalogServices-Schnittstelle
Stellt Methoden für die Katalogisierung von Diensten bereit. (Diese Schnittstelle unterstützt die .NET Framework-Infrastruktur und ist nicht für eine direkte Verwendung über Ihren Code vorgesehen.)

ICLRAssemblyIdentityManager-Schnittstelle
Stellt Methoden bereit, die die Kommunikation zwischen dem Host und der CLR im Zusammenhang mit Assemblys unterstützen.

ICLRAssemblyReferenceList-Schnittstelle
Verwaltet eine Liste von Assemblys, die von der CLR geladen werden (und nicht vom Host).

ICLRControl-Schnittstelle
Stellt Methoden bereit, mit denen der Host Zugriff auf die CLR erlangen und verschiedene Aspekte der CLR konfigurieren kann.

ICLRDebugManager-Schnittstelle
Stellt Methoden bereit, die es einem Host ermöglichen, eine Reihe von Aufgaben einem Bezeichner und einem Anzeigenamen zuzuordnen.

ICLRErrorReportingManager-Schnittstelle
Stellt Methoden bereit, mit denen der Host benutzerdefinierte Heap-Speicherabbilder für die Fehlerberichterstattung konfigurieren kann.

ICLRGCManager-Schnittstelle
Stellt Methoden bereit, die es einem Host ermöglichen, mit dem Garbage Collection-System der CLR zu interagieren.

ICLRHostBindingPolicyManager-Schnittstelle
Stellt Methoden bereit, mit denen der Host Änderungen an Richtlinieninformationen für Assemblys auswerten und kommunizieren kann.

ICLRHostProtectionManager-Schnittstelle
Ermöglicht es dem Host, die Ausführung bestimmter verwalteter Klassen, Methoden, Eigenschaften und Felder in teilweise vertrauenswürdigem Code zu blockieren.

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

ICLRMemoryNotificationCallback-Schnittstelle
Ermöglicht dem Host das Melden der Speicherauslastung mit einem Ansatz, der dem der Win32-Funktion CreateMemoryResourceNotification gleicht.

ICLROnEventManager-Schnittstelle
Stellt Methoden bereit, die es dem Host ermöglichen, Rückrufe für CLR-Ereignisse zu registrieren und die Registrierung für sie aufzuheben.

ICLRPolicyManager-Schnittstelle
Stellt Methoden bereit, mit denen der Host Richtlinienaktionen angeben kann, die bei Fehlern und Timeouts ausgeführt werden sollen.

ICLRProbingAssemblyEnum-Schnittstelle
Die Schnittstelle stellt Methoden bereit, mit denen der Host die Überprüfungsidentitäten einer Assembly mithilfe der CLR-internen Identitätsinformationen der Assembly abrufen kann, ohne dass diese Identität erstellt oder verstanden werden muss.

ICLRReferenceAssemblyEnum-Schnittstelle
Stellt Methoden bereit, mit denen der Host die Gruppe von Assemblys bearbeiten kann, auf die durch eine Datei oder durch einen Stream verwiesen wird, und zwar unter Verwendung CLR-interner Assemblyidentitätsdaten, ohne dass diese Identitäten erstellt oder verstanden werden müssen.

ICLRRuntimeHost-Schnittstelle
Stellt Funktionen bereit, die ICorRuntimeHost ähneln – mit einer zusätzlichen Methode zum Festlegen der Hoststeuerungsschnittstelle.

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

ICLRTask-Schnittstelle
Stellt Methoden bereit, die es dem Host ermöglichen, Anforderungen an die CLR zu senden oder Benachrichtigungen im Zusammenhang mit der zugeordneten Aufgabe für die CLR bereitzustellen.

ICLRTaskManager-Schnittstelle
Stellt Methoden bereit, mit denen der Host explizit anfordern kann, dass die CLR eine neue Aufgabe erstellen, die aktuell ausgeführte Aufgabe abrufen und die geografische Sprache und Kultur für die Aufgabe festlegen soll.

ICLRValidator-Schnittstelle
Stellt Methoden zum Überprüfen von PE-Images (portable executable, portierbare ausführbare Datei) sowie zum Melden von Validierungsfehlern bereit.

ICorConfiguration-Schnittstelle
Stellt Methoden zum Konfigurieren der CLR bereit.

ICorThreadpool-Schnittstelle
Stellt Methoden für den Zugriff auf den Threadpool bereit.

IDebuggerInfo-Schnittstelle
Stellt Methoden für den Abruf von Informationen zum Zustand der Debugdienste bereit.

IDebuggerThreadControl-Schnittstelle
Stellt Methoden bereit, um den Host über die Blockierung sowie über die Aufhebung der Blockierung von Threads durch die Debugdienste zu informieren.

IGCHost-Schnittstelle
Stellt Methoden für den Abruf von Informationen zum Garbage Collection-System und für die Steuerung einiger Aspekte der Garbage Collection bereit.

IGCHost2-Schnittstelle
Stellt die Methode SetGCStartupLimitsEx bereit, mit der ein Host die Größe des Garbage Collection-Segments sowie die maximale Größe der Generation null des Garbage Collection-Systems auf Werte festlegen kann, die größer als DWORD sind.

IGCHostControl-Schnittstelle
Stellt eine Methode bereit, mit der der Garbage Collector den Host auffordern kann, die Grenzwerte des virtuellen Arbeitsspeichers zu ändern.

IGCThreadControl-Schnittstelle
Stellt Methoden für die Teilnahme an der Planung von Threads bereit, die andernfalls für die Garbage Collection blockiert würden.

IHostAssemblyManager-Schnittstelle
Stellt Methoden bereit, mit denen ein Host Gruppen von Assemblys angeben kann, die von der CLR oder vom Host geladen werden sollen.

IHostAssemblyStore-Schnittstelle
Stellt Methoden bereit, die es einem Host ermöglichen, Assemblys und Module unabhängig von der CLR zu laden.

IHostAutoEvent-Schnittstelle
Stellt eine Darstellung eines vom Host implementierten Ereignisses für die automatische Zurücksetzung bereit.

IHostControl-Schnittstelle
Stellt Methoden zum Konfigurieren des Ladens von Assemblys sowie zum Bestimmen der vom Host unterstützten Hostschnittstellen bereit.

IHostCrst-Schnittstelle
Fungiert als hostseitige Darstellung eines kritischen Abschnitts für Threading.

IHostGCManager-Schnittstelle
Stellt Methoden bereit, die den Host über Ereignisse im von der CLR implementierten Garbage Collection-Mechanismus informieren.

IHostIoCompletionManager-Schnittstelle
Stellt Methoden bereit, die es der CLR ermöglichen, mit vom Host bereitgestellten E/A-Abschlussports zu interagieren.

IHostMalloc-Schnittstelle
Stellt Methoden für die CLR bereit, um differenzierte Zuordnungen vom Heap über den Host anzufordern.

IHostManualEvent-Schnittstelle
Stellt die hostseitige Implementierung eines manuellen Zurücksetzungsereignisses bereit.

IHostMemoryManager-Schnittstelle
Stellt Methoden bereit, mit denen die CLR virtuelle Speicheranforderungen über den Host durchführen kann, anstatt die standardmäßigen virtuellen Win32-Speicherfunktionen zu verwenden.

IHostPolicyManager-Schnittstelle
Stellt Methoden bereit, die den Host über die Aktionen informieren, die die CLR bei Abbrüchen, Timeouts oder Fehlern ausführt.

IHostSecurityContext-Schnittstelle
Ermöglicht der CLR die Verwaltung von Sicherheitskontextinformationen, die vom Host implementiert werden.

IHostSecurityManager-Schnittstelle
Stellt Methoden bereit, die den Zugriff auf den Sicherheitskontext des aktuell ausgeführten Threads sowie die Steuerung des Sicherheitskontexts ermöglichen.

IHostSemaphore-Schnittstelle
Stellt eine Darstellung eines vom Host implementierten Semaphors bereit.

IHostSyncManager-Schnittstelle
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, mit denen die CLR mit dem Host kommunizieren kann, um Aufgaben zu verwalten.

IHostTaskManager-Schnittstelle
Stellt Methoden bereit, mit denen die CLR Aufgaben über den Host verwenden kann, anstatt die standardmäßigen Threading- oder Fiber-Funktionen des Betriebssystems zu verwenden.

IHostThreadPoolManager-Schnittstelle
Stellt Methoden bereit, mit denen die CLR den Threadpool konfigurieren und Arbeitselemente im Threadpool in die Warteschlange stellen kann.

IManagedObject-Schnittstelle
Stellt Methoden zum Steuern eines verwalteten Objekts bereit.

IObjectHandle
Stellt eine Methode bereit, mit der als Wert gemarshallte Objekte aus der Dereferenzierung entpackt werden können.

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

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

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

IValidator
Stellt Methoden zum Überprüfen von PE-Images (portable executable, portierbare ausführbare Datei) sowie zum Melden von Validierungsfehlern bereit.

Veraltete CLR-Hostingschnittstellen und Co-Klassen
Enthält Themen mit Beschreibungen der Hostingschnittstellen, die in den .NET Framework-Versionen 1.0 und 1.1 bereitgestellt werden.

In .NET Framework 4 und 4.5 hinzugefügte CLR-Hostingschnittstellen
Enthält Themen mit Beschreibungen der Hostingschnittstellen, die in .NET Framework 4 bereitgestellt werden.