BreakpointTargetEnumerator Kelas
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.
BreakpointTargetEnumerator Membuat untuk BreakpointTargets koleksi. Kelas ini tidak dapat diwariskan.
public ref class BreakpointTargetEnumerator sealed : Microsoft::SqlServer::Dts::Runtime::DtsEnumerator
public sealed class BreakpointTargetEnumerator : Microsoft.SqlServer.Dts.Runtime.DtsEnumerator
type BreakpointTargetEnumerator = class
inherit DtsEnumerator
Public NotInheritable Class BreakpointTargetEnumerator
Inherits DtsEnumerator
- Warisan
Keterangan
Enumerator hanya memungkinkan membaca data dalam koleksi. Enumerator tidak dapat digunakan untuk mengubah koleksi yang mendasar.
Awalnya, enumerator diposisikan sebelum elemen pertama dalam koleksi. Metode ini Reset
juga membawa enumerator kembali ke posisi ini. Pada posisi ini, memanggil Current properti akan memberikan pengecualian. Oleh karena itu, Anda harus memanggil MoveNext
metode untuk memajukan enumerator ke elemen pertama koleksi sebelum membaca nilai Current.
Current mengembalikan objek yang sama hingga atau MoveNext
Reset
dipanggil. MoveNext
Current diatur ke elemen berikutnya.
Setelah akhir koleksi dilewatkan, enumerator diposisikan setelah elemen terakhir dalam koleksi, dan panggilan MoveNext
mengembalikan false
. Jika panggilan terakhir untuk MoveNext
dikembalikan false
, panggilan Current akan melemparkan pengecualian. Untuk mengatur Current ke elemen pertama koleksi lagi, Anda dapat memanggil Reset
diikuti dengan MoveNext
.
Enumerator tetap valid selama koleksi tetap tidak berubah. Jika perubahan dilakukan pada koleksi, seperti menambahkan, memodifikasi, atau menghapus elemen, enumerator tidak valid dan menjadi tidak dapat dipulihkan; dengan demikian panggilan berikutnya ke MoveNext
atau Reset
melempar InvalidOperationException
. Namun, jika koleksi dimodifikasi antara MoveNext
dan Current, Current akan mengembalikan elemen yang diatur ke, bahkan jika enumerator telah dibatalkan.
Enumerator tidak memiliki akses eksklusif ke koleksi; oleh karena itu, menghitung melalui koleksi bukanlah prosedur yang aman untuk utas. Bahkan ketika koleksi disinkronkan, utas lain masih dapat memodifikasi koleksi, yang menyebabkan enumerator melemparkan pengecualian. Untuk menjamin keamanan utas selama enumerasi, Anda dapat mengunci koleksi selama seluruh enumerasi atau menangkap pengecualian yang dihasilkan dari perubahan yang dibuat oleh utas lain.
Properti
Current |
Mendapatkan objek saat ini BreakpointTarget dalam koleksi. |
Metode
MoveNext() |
Memajukan enumerator ke elemen koleksi berikutnya. (Diperoleh dari DtsEnumerator) |
Reset() |
Mengatur enumerator ke posisi awalnya, yaitu sebelum elemen pertama dalam koleksi. (Diperoleh dari DtsEnumerator) |