TemplateControl.LoadControl 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.
ControlMemuat .
Overload
LoadControl(String) |
Control Memuat objek dari file berdasarkan jalur virtual tertentu. |
LoadControl(Type, Object[]) |
Control Memuat objek berdasarkan jenis dan parameter konstruktor tertentu. |
Keterangan
Saat Anda memuat kontrol ke dalam kontrol kontainer, kontainer akan menaikkan semua peristiwa kontrol yang ditambahkan hingga mencapai peristiwa saat ini. Namun, kontrol yang ditambahkan tidak mengejar pemrosesan data postback. Agar kontrol tambahan berpartisipasi dalam pemrosesan data postback, termasuk validasi, kontrol harus ditambahkan dalam Init peristiwa, bukan dalam peristiwa tersebut Load .
LoadControl(String)
Control Memuat objek dari file berdasarkan jalur virtual tertentu.
public:
System::Web::UI::Control ^ LoadControl(System::String ^ virtualPath);
public System.Web.UI.Control LoadControl (string virtualPath);
member this.LoadControl : string -> System.Web.UI.Control
Public Function LoadControl (virtualPath As String) As Control
Parameter
- virtualPath
- String
Jalur virtual ke file kontrol.
Mengembalikan
Mengembalikan yang ditentukan Control.
Pengecualian
Jalur virtual adalah null
atau kosong.
Contoh
Contoh kode berikut menunjukkan cara menggunakan LoadControl metode untuk menambahkan kontrol pengguna ke halaman ASP.NET.
OnInit
Dalam metode kejadian, halaman ini menggunakan LoadControl metode untuk membuat kontrol pengguna secara terprogram di halaman. Metode menambahkan kontrol ke Controls properti PlaceHolder kontrol server Web bernama Placeholder1
.
Untuk definisi MyControl
kelas yang digunakan dalam contoh kode ini, lihat TemplateControl.
void Page_Init(object sender, System.EventArgs e)
{
// Instantiate the UserControl object
MyControl myControl1 =
(MyControl)LoadControl("TempControl_Samples1.ascx.cs");
PlaceHolder1.Controls.Add(myControl1);
}
Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
' Obtain a UserControl object MyControl from the
' user control file TempControl_Samples1.ascx.vb
Dim myControl1 As MyControl = CType(LoadControl("TempControl_Samples1.vb.ascx"), MyControl)
Controls.Add(myControl1)
End Sub
Keterangan
Jika kontrol mendukung penembolokan, objek yang dikembalikan dari LoadControl metode sebenarnya bukan Control objek; melainkan, itu adalah PartialCachingControl objek.
virtualPath
Jika parameter relatif, jalur kontrol yang dimuat relatif terhadap jalur TemplateControl.
Saat Anda memuat kontrol ke dalam kontrol kontainer, kontainer akan menaikkan semua peristiwa kontrol yang ditambahkan hingga mencapai peristiwa saat ini. Namun, kontrol yang ditambahkan tidak mengejar pemrosesan data postback. Agar kontrol tambahan berpartisipasi dalam pemrosesan data postback, termasuk validasi, kontrol harus ditambahkan dalam Init peristiwa, bukan dalam peristiwa tersebut Load .
Lihat juga
- UserControl
- LoadControl(Type, Object[])
- OnInit(EventArgs)
- OnLoad(EventArgs)
- Ringkasan Siklus Hidup Halaman ASP.NET
Berlaku untuk
LoadControl(Type, Object[])
Control Memuat objek berdasarkan jenis dan parameter konstruktor tertentu.
public:
System::Web::UI::Control ^ LoadControl(Type ^ t, cli::array <System::Object ^> ^ parameters);
public System.Web.UI.Control LoadControl (Type t, object[] parameters);
member this.LoadControl : Type * obj[] -> System.Web.UI.Control
Public Function LoadControl (t As Type, parameters As Object()) As Control
Parameter
- t
- Type
Jenis kontrol.
- parameters
- Object[]
Array argumen yang cocok dengan angka, urutan, dan ketik parameter konstruktor yang akan dipanggil. Jika parameters
adalah array kosong atau null
, konstruktor yang tidak mengambil parameter (konstruktor tanpa parameter) dipanggil.
Mengembalikan
Mengembalikan yang ditentukan UserControl.
Keterangan
Jika kontrol pengguna mendukung penembolokan, objek yang dikembalikan dari LoadControl metode sebenarnya bukan UserControl objek; melainkan, itu adalah PartialCachingControl objek.
Saat Anda memuat kontrol ke dalam kontrol kontainer, kontainer akan menaikkan semua peristiwa kontrol yang ditambahkan hingga mencapai peristiwa saat ini. Namun, kontrol yang ditambahkan tidak mengejar pemrosesan data postback. Agar kontrol tambahan berpartisipasi dalam pemrosesan data postback, termasuk validasi, kontrol harus ditambahkan dalam Init peristiwa, bukan dalam peristiwa tersebut Load .
Lihat juga
- UserControl
- LoadControl(String)
- OnInit(EventArgs)
- OnLoad(EventArgs)
- Ringkasan Siklus Hidup Halaman ASP.NET