IDebugProperty2

Antarmuka ini mewakili properti bingkai tumpukan, properti dokumen program, atau beberapa properti lainnya. Properti biasanya merupakan hasil evaluasi ekspresi.

Catatan

Penggunaan "properti" ini tidak boleh dikacaukan dengan yang berarti variabel anggota kelas, meskipun IDebugProperty2 dapat mewakili entitas tersebut.

Sintaks

IDebugProperty2 : IUnknown

Catatan untuk Pelaksana

DE mengimplementasikan antarmuka ini untuk mewakili jenis nilai tertentu. Misalnya, nilai bisa menjadi nilai numerik sebagai hasil dari evaluasi ekspresi, konteks memori yang digunakan untuk menampilkan memori, atau daftar register dan nilainya.

Catatan untuk Penelepon

Panggil EvaluateSync atau EvaluateAsync untuk mendapatkan antarmuka ini, yang mewakili hasil evaluasi. IDebugExpression2::EvaluateAsync mengembalikan antarmuka ini dengan mengirim antarmuka IDebugExpressionEvaluationCompleteEvent2 ke SDM, yang pada gilirannya memanggil GetResult untuk mengambil properti.

GetDebugProperty mengembalikan antarmuka ini untuk menyediakan dokumen skrip terkait.
GetReturnValue mengembalikan antarmuka ini untuk mewakili nilai pengembalian fungsi.
GetDebugProperty mengembalikan antarmuka ini untuk mewakili berbagai properti program seperti nama atau konteks memori.
GetDebugProperty mengembalikan antarmuka ini untuk mewakili berbagai properti bingkai tumpukan seperti variabel lokal.

Metode dalam Urutan Vtable

Tabel berikut memperlihatkan metode IDebugProperty2.

Metode	Deskripsi
GetPropertyInfo	Mengisi struktur DEBUG_PROPERTY_INFO yang menjelaskan properti.
SetValueAsString	Mengatur nilai properti dari string.
SetValueAsReference	Mengatur nilai properti dari nilai referensi tertentu.
EnumChildren	Menghitung anak-anak properti.
GetParent	Mengembalikan induk properti.
GetDerivedMostProperty	Mengembalikan properti yang menjelaskan properti properti yang paling turunan.
GetMemoryBytes	Mengembalikan byte memori yang menyusun nilai properti.
GetMemoryContext	Mengembalikan konteks memori untuk nilai properti.
GetSize	Mengembalikan ukuran, dalam byte, dari nilai properti.
GetReference	Mengembalikan referensi ke nilai properti ini.
GetExtendedInfo	Mengembalikan informasi properti yang diperluas.

Keterangan

Properti, seperti yang IDebugProperty2 diwakili oleh antarmuka, dapat dianggap sebagai nilai dengan nama, jenis, dan alamat. Dalam istilah yang IDebugProperty2 lebih umum, dapat mewakili apa pun yang memiliki struktur hierarkis, dengan node orang tua dan anak.

Properti biasanya bersifat transitori, hanya bertahan selama bingkai tumpukan saat ini, misalnya. Di sisi lain, referensi, seperti yang diwakili oleh antarmuka IDebugReference2 , berlangsung selama nilai tetap dalam memori.

IDE dapat menggunakan IDebugProperty2 antarmuka untuk memungkinkan pengguna menelusuri dan memodifikasi properti pada waktu proses.

Persyaratan

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Rakitan: Microsoft.VisualStudio.Debugger.Interop.dll

Bagikan melalui