IVsAsyncShellOpenDocument.OpenDocumentViaProjectAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
查找相应的项目以打开文档。
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 层次结构打开项。 此功能非常重要,因为它使存储过程的调试成为可能。