Aracılığıyla paylaş

TemplateControl.LoadControl Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI
Bütünleştirilmiş Kod:
System.Web.dll

bir Controlyükler.

Aşırı Yüklemeler

LoadControl(String)

Control Belirtilen sanal yolu temel alan bir dosyadan nesne yükler.
LoadControl(Type, Object[])

Control Belirtilen türe ve oluşturucu parametrelerine göre bir nesne yükler.

Açıklamalar

Kapsayıcı denetimine bir denetim yüklediğinizde kapsayıcı, geçerli olaya yetişene kadar eklenen denetimin tüm olaylarını oluşturur. Ancak, eklenen denetim geri gönderme veri işlemeyi yakalamaz. Ek bir denetimin doğrulama da dahil olmak üzere geri gönderme veri işlemesine katılması için denetimin olay yerine Load olaya eklenmesi Init gerekir.

LoadControl(String)

Control Belirtilen sanal yolu temel alan bir dosyadan nesne yükler.

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

Parametreler

virtualPath
String

Bir denetim dosyasının sanal yolu.

Döndürülenler

Control

Belirtilen Controldeğerini döndürür.

Özel durumlar

ArgumentNullException

Sanal yol null veya boş.

Örnekler

Aşağıdaki kod örneği, bir ASP.NET sayfasına kullanıcı denetimi eklemek için yönteminin nasıl kullanılacağını LoadControl gösterir.

Olay yönteminde OnInit , bu sayfa program aracılığıyla sayfada bir kullanıcı denetimi oluşturmak için yöntemini kullanır LoadControl . yöntemi, denetimi Controls adlı Placeholder1bir PlaceHolder Web sunucusu denetiminin özelliğine ekler.

Bu kod örneğinde kullanılan sınıfın tanımı MyControl için bkz 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

Açıklamalar

Denetim önbelleğe almayı destekliyorsa, yönteminden LoadControl döndürülen nesne aslında bir Control nesne değildir; bunun yerine bir PartialCachingControl nesnedir. virtualPath Parametre göreliyse, yüklenen denetimin yolu yoluna TemplateControlgöredir.

Kapsayıcı denetimine bir denetim yüklediğinizde kapsayıcı, geçerli olaya yetişene kadar eklenen denetimin tüm olaylarını oluşturur. Ancak, eklenen denetim geri gönderme veri işlemeyi yakalamaz. Ek bir denetimin doğrulama da dahil olmak üzere geri gönderme veri işlemesine katılması için denetimin olay yerine Load olaya eklenmesi Init gerekir.

Ayrıca bkz.

Şunlara uygulanır

LoadControl(Type, Object[])

Control Belirtilen türe ve oluşturucu parametrelerine göre bir nesne yükler.

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

Parametreler

t
Type

Denetimin türü.

parameters
Object[]

Çağrılacak oluşturucunun parametrelerini sayı, sıra ve tür olarak eşleşen bir bağımsız değişken dizisi. boş bir dizi veya nulliseparameters, parametre alan oluşturucu (parametresiz oluşturucu) çağrılır.

Döndürülenler

Control

Belirtilen UserControldeğerini döndürür.

Açıklamalar

Kullanıcı denetimi önbelleğe almayı destekliyorsa, yönteminden LoadControl döndürülen nesne aslında bir UserControl nesne değildir; bunun yerine bir PartialCachingControl nesnedir.

Kapsayıcı denetimine bir denetim yüklediğinizde kapsayıcı, geçerli olaya yetişene kadar eklenen denetimin tüm olaylarını oluşturur. Ancak, eklenen denetim geri gönderme veri işlemeyi yakalamaz. Ek bir denetimin doğrulama da dahil olmak üzere geri gönderme veri işlemesine katılması için denetimin olay yerine Load olaya eklenmesi Init gerekir.

Ayrıca bkz.

Şunlara uygulanır