IVsAsyncShellOpenDocument.OpenSpecificEditorAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
使用指定的編輯器以異步方式開啟檔。
public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenSpecificEditorAsync (uint openSpecificEditorFlags, string documentMoniker, Guid editorType, string? physicalView, Guid logicalView, string? ownerCaption, Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy? hierarchy, uint itemId, bool shouldGetDocDataFromRdt, object? docData, Microsoft.VisualStudio.OLE.Interop.IServiceProvider serviceProvider);abstract member OpenSpecificEditorAsync : uint32 * string * Guid * string * Guid * string * Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy * uint32 * bool * obj * Microsoft.VisualStudio.OLE.Interop.IServiceProvider -> Microsoft.VisualStudio.Shell.Interop.IVsTaskPublic Function OpenSpecificEditorAsync (openSpecificEditorFlags As UInteger, documentMoniker As String, editorType As Guid, physicalView As String, logicalView As Guid, ownerCaption As String, hierarchy As IVsUIHierarchy, itemId As UInteger, shouldGetDocDataFromRdt As Boolean, docData As Object, serviceProvider As IServiceProvider) As IVsTask參數
- openSpecificEditorFlags
- UInt32
其值取自 列舉的 __VSOSPEFLAGS 旗標。
- documentMoniker
- String
項目系統中檔唯一 Moniker 識別符的字串形式，例如檔案的完整路徑。 在非檔案案例中，此標識碼通常是URL的形式。
- physicalView
- String
實體檢視或 null的名稱。
如果 null為 ，則環境會在編輯器處理站上呼叫 MapLogicalView(Guid, String) ，以判斷對應至邏輯檢視的實體檢視。
在此情況下， null 不會指定主要檢視，而是表示您不知道哪個檢視對應至邏輯檢視。
- logicalView
- Guid
， Guid 識別邏輯檢視。 默認檢視是 VSConstants.LOGVIEWID_Primary ，而且每個編輯器都必須支援該檢視。
如果編輯器在文件檢視對象上實 IVsMultiViewDocumentView 作，則傳遞給 ActivateLogicalView(Guid)的值會決定在顯示編輯器視窗時啟動的檢視。
藉由指定邏輯檢視，您可以要求符合您要求檢視 Guid原因的特定檢視。
例如，指定 VSConstants.LOGVIEWID_Debugging 以取得適合偵錯的檢視，或 VSConstants.LOGVIEWID_TextView 取得適用於文本編輯器 (的檢視，也就是實 IVsCodeWindow 作) 的檢視。
- ownerCaption
- String
文件擁有者 (所定義的初始 標題，也就是文檔視窗的專案) 。 這通常是“ProjectName – ItemName”。
- hierarchy
- IVsUIHierarchy
擁有文件的 參考 IVsUIHierarchy 。
- itemId
- UInt32
標準編輯器的 UI 階層專案識別碼。 如需相關資訊，請參閱VSConstants.VSITEMID。
- shouldGetDocDataFromRdt
- Boolean
如果 true為 ，則環境會使用從執行中檔數據表取得的檔數據對象，否則服務會使用傳入的檔 docData數據來開啟檔。
- docData
- Object
要開啟或 null之專案之文件數據對象的參考。 如果 shouldGetDocDataFromRdt 為 true，則會忽略傳遞至此參數的這個值。
- serviceProvider
- IServiceProvider
IServiceProvider 的參考。
傳回
表示已啟動開啟作業的工作。
如果檔案已在環境中開啟，則工作的結果是 的參考 IVsAsyncOpenDocumentResult，否則 null為 。
備註
這個方法所傳回的工作不會指出文件檢視和 docdata 已載入。 如需更多詳細資料，請參閱 DocumentLoadTask \(英文\)。