UserControl.Load Kejadian
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.
Terjadi sebelum kontrol terlihat untuk pertama kalinya.
public:
event EventHandler ^ Load;
public event EventHandler Load;
public event EventHandler? Load;
member this.Load : EventHandler
Public Custom Event Load As EventHandler
Jenis Acara
Contoh
Contoh kode berikut menunjukkan penggunaan anggota ini. Dalam contoh, penanganan aktivitas melaporkan terjadinya Load peristiwa. Laporan ini membantu Anda mempelajari kapan peristiwa terjadi dan dapat membantu Anda dalam penelusuran kesalahan. Untuk melaporkan beberapa peristiwa atau pada peristiwa yang sering terjadi, pertimbangkan untuk mengganti MessageBox.Show dengan Console.WriteLine atau menambahkan pesan ke multibaris TextBox.
Untuk menjalankan kode contoh, tempelkan ke dalam proyek yang berisi instans jenis UserControl bernama UserControl1
. Kemudian pastikan bahwa penanganan aktivitas dikaitkan dengan Load peristiwa.
private void UserControl1_Load(Object sender, EventArgs e) {
MessageBox.Show("You are in the UserControl.Load event.");
}
Private Sub UserControl1_Load(sender as Object, e as EventArgs) _
Handles UserControl1.Load
MessageBox.Show("You are in the UserControl.Load event.")
End Sub
Keterangan
Anda dapat menggunakan kejadian ini untuk melakukan tugas seperti mengalokasikan sumber daya yang digunakan oleh kontrol.
Catatan
UserControl Jika merupakan bagian dari bentuk anak MDI, Load peristiwa akan terjadi setiap kali formulir anak ditampilkan. Dalam hal ini, Anda harus menempatkan kode inisialisasi satu kali di UserControl alih-alih Load penanganan aktivitas.
Perhatian
Peristiwa Load terjadi ketika handel untuk UserControl dibuat. Dalam beberapa keadaan, ini dapat menyebabkan Load peristiwa terjadi lebih dari satu kali. Misalnya, Load peristiwa terjadi ketika UserControl dimuat, dan sekali lagi jika handel dibuat ulang. (Salah satu cara handel dibuat ulang adalah dengan memanggil RecreateHandle metode .) Untuk mempertangungjawabkan peristiwa yang Load terjadi lebih dari satu kali, Anda harus meletakkan kode inisialisasi satu kali di UserControl konstruktor alih-alih Load penanganan aktivitas. Selain itu, Anda tidak boleh menambahkan pengikatan data ke UserControl dalam Load penanganan aktivitas.
Untuk informasi selengkapnya tentang menangani peristiwa, lihat Menangani dan Menaikkan Peristiwa.