Bagikan melalui

TemplateControl.LoadControl Metode

  • Referensi

Definisi

Ruang nama:
System.Web.UI
Rakitan:
System.Web.dll

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

Control

Mengembalikan yang ditentukan Control.

Pengecualian

ArgumentNullException

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

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

Control

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

Berlaku untuk