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 层次结构打开项。 此功能非常重要,因为它使存储过程的调试成为可能。

适用于