IVsAsyncShellOpenDocument.OpenDocumentViaProjectAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Находит подходящий проект для открытия документа.
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
Параметры
- documentMoniker
- String
Строковая форма уникального моникера документа в системе проектов, например полный путь к файлу. В случаях, когда документ не является файлом, этот идентификатор часто имеет вид URL-адреса.
- logicalView
- Guid
Объект , Guid определяющий логическое представление. По умолчанию используется представление , VSConstants.LOGVIEWID_Primary
и каждый редактор должен поддерживать это представление.
Если редактор реализует IVsMultiViewDocumentView в объекте представления документа, то значение, передаваемое в ActivateLogicalView(Guid), которое определяет, какое представление активируется при отображении окна редактора.
Указав логическое представление Guid, можно запросить конкретное представление, соответствующее причине запроса представления.
Например, укажите VSConstants.LOGVIEWID_Debugging
для получения представления, подходящего для отладки, или VSConstants.LOGVIEWID_TextView
для получения представления, подходящего для текстового редактора (т. е. представления, которое реализует IVsCodeWindow).
- supportExternalItems
- Boolean
true
, если проект поддерживает внешние элементы; в противном случае — false
.
Возвращаемое значение
Задача, представляющая операцию открытия. Результатом задачи является IVsAsyncOpenDocumentResult объект .
Комментарии
Задача, возвращаемая этим методом, не указывает, что представление и docdata документа загружены. Дополнительные сведения см. в статье DocumentLoadTask.
Это можно вызвать, чтобы открыть любой проект, открытый с помощью диалогового окна Новый проект или Открыть проект. Кроме того, этот метод также вызывается для открытия документа в любом проекте, который добавляется в решение с помощью AddVirtualProject(IVsHierarchy, UInt32) или AddVirtualProjectEx(IVsHierarchy, UInt32, Guid). Одним из примеров этого является иерархия DataView, которая в настоящее время находится в серверном Обозреватель. Если иерархия DataView добавляется в решение как виртуальный проект с помощью AddVirtualProject(IVsHierarchy, UInt32), то этот метод может открывать элементы из иерархий DataView. Эта функциональность важна, так как позволяет отладить хранимые процедуры.