Udostępnij za pośrednictwem


IVsAsyncShellOpenDocument.OpenDocumentViaProjectAsync Metoda

Definicja

Znajduje odpowiedni projekt, aby otworzyć dokument.

public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenDocumentViaProjectAsync (string documentMoniker, Guid logicalView, bool supportExternalItems);
abstract member OpenDocumentViaProjectAsync : string * Guid * bool -> Microsoft.VisualStudio.Shell.Interop.IVsTask
Public Function OpenDocumentViaProjectAsync (documentMoniker As String, logicalView As Guid, supportExternalItems As Boolean) As IVsTask

Parametry

documentMoniker
String

Forma ciągu unikatowego identyfikatora moniker dokumentu w systemie projektu, na przykład pełna ścieżka do pliku. W przypadkach innych niż pliki ten identyfikator jest często w postaci adresu URL.

logicalView
Guid

Identyfikowanie Guid widoku logicznego. Widok domyślny to VSConstants.LOGVIEWID_Primary i każdy edytor musi obsługiwać ten widok.

Jeśli edytor implementuje IVsMultiViewDocumentView obiekt widoku dokumentu, wartość przekazana do ActivateLogicalView(Guid)elementu określa, który widok jest aktywowany po wyświetleniu okna edytora.

Określając widok Guidlogiczny, możesz zażądać określonego widoku zgodnego z przyczyną, dla której żądasz widoku. Na przykład określ VSConstants.LOGVIEWID_Debugging , aby uzyskać widok odpowiedni do debugowania lub VSConstants.LOGVIEWID_TextView uzyskać widok odpowiedni dla edytora tekstów (czyli widok implementujący IVsCodeWindow).

supportExternalItems
Boolean

true jeśli projekt obsługuje elementy zewnętrzne; w przeciwnym razie , false.

Zwraca

Zadanie reprezentujące operację otwierania. Wynikiem zadania jest IVsAsyncOpenDocumentResult obiekt.

Uwagi

Zadanie zwrócone przez tę metodę nie wskazuje, że widok dokumentu i dane docdata zostały załadowane. Aby uzyskać więcej informacji, zobacz DocumentLoadTask .

Można to wywołać, aby otworzyć dowolny projekt otwarty za pomocą okna dialogowego Nowy projekt lub Otwórz projekt. Ponadto ta metoda jest również wywoływana w celu otwarcia dokumentu w każdym projekcie dodanym do rozwiązania za pomocą metody AddVirtualProject(IVsHierarchy, UInt32) lub AddVirtualProjectEx(IVsHierarchy, UInt32, Guid). Jednym z przykładów jest hierarchia widoku danych, która znajduje się obecnie w Eksploratorze serwera. Jeśli hierarchia elementu DataView zostanie dodana do rozwiązania jako projekt wirtualny przy użyciu metody AddVirtualProject(IVsHierarchy, UInt32), ta metoda może otwierać elementy z hierarchii DataView. Ta funkcja jest ważna, ponieważ umożliwia debugowanie procedur składowanych.

Dotyczy