IVsAsyncShellOpenDocument.OpenDocumentViaProjectAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menemukan proyek yang sesuai untuk membuka dokumen.
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
Parameter
- documentMoniker
- String
Bentuk string dari pengidentifikasi moniker unik dokumen dalam sistem proyek, misalnya, jalur lengkap ke file. Dalam kasus non-file, pengidentifikasi ini sering dalam bentuk URL.
- logicalView
- Guid
Guid Mengidentifikasi tampilan logis. Tampilan default adalah VSConstants.LOGVIEWID_Primary
dan setiap editor harus mendukung tampilan tersebut.
Jika editor mengimplementasikan IVsMultiViewDocumentView pada objek tampilan dokumen, maka nilai yang diteruskan ke ActivateLogicalView(Guid), yang menentukan tampilan mana yang diaktifkan saat jendela editor ditampilkan.
Dengan menentukan tampilan Guidlogis , Anda dapat meminta tampilan tertentu yang cocok dengan alasan Anda meminta tampilan.
Misalnya, tentukan VSConstants.LOGVIEWID_Debugging
untuk mendapatkan tampilan yang sesuai untuk penelusuran kesalahan, atau VSConstants.LOGVIEWID_TextView
untuk mendapatkan tampilan yang sesuai untuk editor teks (yaitu, tampilan yang mengimplementasikan IVsCodeWindow).
- supportExternalItems
- Boolean
true
jika proyek mendukung item eksternal; jika tidak, false
.
Mengembalikan
Tugas yang mewakili operasi terbuka. Hasil tugas adalah IVsAsyncOpenDocumentResult objek.
Keterangan
Tugas yang dikembalikan oleh metode ini tidak menunjukkan bahwa tampilan dokumen dan docdata telah dimuat. Lihat DocumentLoadTask untuk detail selengkapnya.
Ini dapat dipanggil untuk membuka proyek apa pun yang dibuka melalui kotak dialog Proyek Baru atau Buka Proyek. Selain itu, metode ini juga dipanggil untuk membuka dokumen dalam proyek apa pun yang ditambahkan ke solusi melalui AddVirtualProject(IVsHierarchy, UInt32) atau AddVirtualProjectEx(IVsHierarchy, UInt32, Guid). Salah satu contoh penggunaan ini adalah hierarki DataView, yang saat ini berada di Server Explorer. Jika hierarki DataView ditambahkan ke solusi sebagai proyek virtual menggunakan AddVirtualProject(IVsHierarchy, UInt32), maka metode ini dapat membuka item dari hierarki DataView. Fungsionalitas ini penting karena memungkinkan penelusuran kesalahan prosedur tersimpan.