Freigeben über


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