Freigeben über

Hostingschnittstellen für .NET Framework 2.0

  • Artikel

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.0 und 1.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-Schnittstelle
    Stellt eine Methode bereit, die einen Rückruf für ein registriertes Ereignis ausführt.

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

  • IAppDomainBinding-Schnittstelle
    Stellt Methoden zum Festlegen der Laufzeitkonfiguration bereit.

  • ICatalogServices-Schnittstelle
    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-Schnittstelle
    Stellt Methoden bereit, die die Kommunikation über Assemblys zwischen dem Host und der CLR unterstützen.

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

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

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

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

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

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

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

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

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

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

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

  • ICLRProbingAssemblyEnum-Schnittstelle
    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-Schnittstelle
    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-Schnittstelle
    Stellt mit ICorRuntimeHost vergleichbare Funktionen mit einer zusätzlichen Methode zum Festlegen der Schnittstelle des Hoststeuerelements bereit.

  • ICLRSyncManager-Schnittstelle
    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-Schnittstelle
    Stellt Methoden zur Validierung von übertragbaren ausführbaren Abbildern (Portable Executable, PE) und zum Melden von Validierungsfehlern bereit.

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

  • ICorThreadpool-Schnittstelle
    Stellt Methoden zum Zugreifen auf den Threadpool bereit.

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

  • IDebuggerThreadControl-Schnittstelle
    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-Schnittstelle
    Stellt Methoden zum Abrufen von Informationen über das Garbage Collection-System und zum Steuern einiger Aspekte der Garbage Collection bereit.

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

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

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

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

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

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

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

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

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

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

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

  • IHostMemoryManager-Schnittstelle
    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-Schnittstelle
    Stellt Methoden bereit, die den Host über die Aktionen benachrichtigen, die die CLR bei Abbrüchen, Timeouts oder Fehlern durchführt.

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

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

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

  • 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, 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-Schnittstelle
    Stellt Methoden bereit, mit denen die CLR den Threadpool konfigurieren und Arbeitsaufgaben in die Warteschlange einreihen kann.

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

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

  • ITypeName-Schnittstelle
    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-Schnittstelle
    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-Schnittstelle
    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-Schnittstelle
    Stellt Methoden zur Validierung von übertragbaren ausführbaren Abbildern (Portable Executable, PE) und zum Melden von Validierungsfehlern bereit.

Verwandte Abschnitte