IVsProjectAsyncOpen.OpenItemAsync(UInt32, Guid, Boolean, Object) Methode

Referenz

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Interop.dll

Paket:: Microsoft.VisualStudio.Interop v17.12.40391

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Öffnet asynchron ein Element im Projekt.

public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenItemAsync (uint itemId, Guid logicalView, bool shouldGetDocDataFromRdt, object? docData);

abstract member OpenItemAsync : uint32 * Guid * bool * obj -> Microsoft.VisualStudio.Shell.Interop.IVsTask

Public Function OpenItemAsync (itemId As UInteger, logicalView As Guid, shouldGetDocDataFromRdt As Boolean, docData As Object) As IVsTask

Parameter

itemId: UInt32

Bezeichner des zu öffnenden Elements. Sollte VSITEMID_ROOT oder ein anderer gültiger Elementbezeichner sein. Weitere Informationen finden Sie unter der VSITEMID-Enumeration.

logicalView: Guid

Eindeutiger Bezeichner der logischen Ansicht. Wenn nicht GUID_NULL, gibt einen bestimmten Typ der zu erstellenden Ansicht an. Weitere Informationen finden Sie unter LOGVIEWID.

shouldGetDocDataFromRdt: Boolean

Wenn true, verwendet die Umgebung das aus der Tabelle "Laufendes Dokument" abgerufene Doc-Datenobjekt. Andernfalls öffnet der Dienst das Dokument mithilfe der an docDataübergebenen Dokumentdaten.

docData: Object

Ein Verweis auf das Dokumentdatenobjekt des zu öffnenden Elements oder null. Dieser an diesen Parameter übergebene Wert wird ignoriert, wenn shouldGetDocDataFromRdt ist true.

Gibt zurück

IVsTask

Eine Aufgabe, die den geöffneten Vorgang darstellt. Das Ergebnis der Aufgabe ist ein IVsAsyncOpenDocumentResult für das geöffnete Element.

Hinweise

Durch die Implementierung einer IVsProjectSpecificEditorMap2 Schnittstelle für Ihr Projektobjekt können Sie eine projektspezifische Verarbeitung von Dateien durchführen. Das heißt, Sie können das Öffnen der Datei in einem projektspezifischen Editor oder das Öffnen des Elements durch den globalen Editor unterstützen. Zum Öffnen eines Elements muss ein Editor mit OpenStandardEditorAsync(...) oder OpenSpecificEditorAsync(...)gestartet werden, je nachdem, welche Behandlung Sie implementieren möchten. Weitere Informationen finden Sie unter GetSpecificEditorProperty.

HINWEIS: Rufen Show() Sie in Ihrer Implementierung von OpenItemAsync(UInt32, Guid, Boolean, Object)nicht für den zurückgegebenen Fensterrahmen auf.

Vergleich mit ReopenItemAsync(UInt32, Guid, String, Guid, Boolean, Object)

Die von dieser Methode zurückgegebene Aufgabe gibt nicht an, dass die Ansicht und die Dokumentdaten des Dokuments geladen wurden. Weitere Informationen finden Sie unter DocumentLoadTask.

Gilt für:

Freigeben über