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
項目系統中檔唯一 Moniker 識別符的字串形式,例如檔案的完整路徑。 在非檔案案例中,此標識碼通常是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 階層開啟專案。 這項功能很重要,因為它能夠偵錯預存程式。