IVsAsyncShellOpenDocument.OpenDocumentViaProjectAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.