IVsAsyncShellOpenDocument.OpenDocumentViaProjectWithSpecificAsync Methode

Referenz

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Interop.dll

Paket:: Microsoft.VisualStudio.Interop v17.9.37000

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.

Sucht ein bestimmtes Projekt, um dieses Dokument zu öffnen.

public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenDocumentViaProjectWithSpecificAsync (string documentMoniker, uint specificEditorFlags, Guid editorType, string? physicalView, Guid logicalView);

abstract member OpenDocumentViaProjectWithSpecificAsync : string * uint32 * Guid * string * Guid -> Microsoft.VisualStudio.Shell.Interop.IVsTask

Public Function OpenDocumentViaProjectWithSpecificAsync (documentMoniker As String, specificEditorFlags As UInteger, editorType As Guid, physicalView As String, logicalView As Guid) As IVsTask

Parameter

documentMoniker: String

Zeichenfolgenform des eindeutigen Monikerbezeichners des Dokuments im Projektsystem, z. B. der vollständige Pfad zur Datei. Handelt es sich nicht um Dateien, ist dieser Bezeichner oft in Form einer URL angegeben.

specificEditorFlags: UInt32

Flags, deren Werte der __VSSPECIFICEDITORFLAGS Enumeration entnommen werden.

editorType: Guid

Eindeutiger Bezeichner des Editortyps.

physicalView: String

Eindeutiger Bezeichner der physischen Ansicht.

logicalView: Guid

Eine Guid , die die logische Ansicht identifiziert. Die Standardansicht ist VSConstants.LOGVIEWID_Primary , und jeder Editor muss diese Ansicht unterstützen.

Wenn der Editor für das Dokumentansichtsobjekt IVsMultiViewDocumentView implementiert, dann der an übergebene Wert, der bestimmt ActivateLogicalView(Guid), welche Ansicht aktiviert wird, wenn das Editorfenster angezeigt wird.

Durch Angeben der logischen Ansicht Guidkönnen Sie die spezifische Ansicht anfordern, die dem Grund entspricht, aus dem Sie die Ansicht anfordern. Geben Sie beispielsweise VSConstants.LOGVIEWID_Debugging an, um die entsprechende Ansicht für das Debuggen zu erhalten, oder geben Sie VSConstants.LOGVIEWID_TextView, um die entsprechende Ansicht für den Text-Editor zu erhalten (das heißt, eine Ansicht, die IVsCodeWindow implementiert).

Gibt zurück

IVsTask

Eine Aufgabe, die den geöffneten Vorgang darstellt. Das Ergebnis der Aufgabe ist ein IVsAsyncOpenDocumentResult -Objekt.

Hinweise

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

Diese Methode wird von VSPackages verwendet, bei denen es sich nicht um Projekte handelt, die ein Dokument in einem bestimmten Editor öffnen müssen. Es ist jedoch egal, welches Projekt die Datei öffnet. Um diese Methode aus Ihrem VSPackage aufzurufen, müssen Sie genau wissen, welche Editor-Factory Sie möchten und welches Fenster die Editorfactory erstellen soll (d. a. die physische Ansicht). Mit der logicalView im Parameter angegebenen logischen Ansicht können Sie außerdem angeben, welche Registerkarte vom Editor angezeigt werden soll, wenn der Editor implementiert IVsMultiViewDocumentView.

Diese Methode ruft OpenItem(UInt32, Guid, IntPtr, IVsWindowFrame) auf. Wenn kein Projekt die Datei verwalten kann und das Projekt Miscellaneous Files noch nicht vorhanden ist, erstellt die Umgebung das Projekt Verschiedene Dateien und versucht es erneut.

Gilt für:

Freigeben über