Udostępnij za pośrednictwem

TemplateControl.LoadControl Metoda

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Ładuje element Control.

Przeciążenia

Nazwa Opis
LoadControl(String)

Control Ładuje obiekt z pliku na podstawie określonej ścieżki wirtualnej.
LoadControl(Type, Object[])

Control Ładuje obiekt na podstawie określonego typu i parametrów konstruktora.

Uwagi

Gdy załadujesz kontrolkę do kontrolki kontenera, kontener zgłasza wszystkie zdarzenia dodanego formantu, dopóki nie zostanie przechwycony do bieżącego zdarzenia. Jednak dodana kontrolka nie nadrabia zaległości w przetwarzaniu danych zwrotnych. Aby dodatkowa kontrolka brała udział w przetwarzaniu danych po awarii, w tym walidacji, kontrolka musi zostać dodana w Init zdarzeniu, a nie w Load zdarzeniu.

LoadControl(String)

Control Ładuje obiekt z pliku na podstawie określonej ścieżki wirtualnej.

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

Parametry

virtualPath
String

Ścieżka wirtualna do pliku sterującego.

Zwraca

Control

Zwraca określony Controlelement .

Wyjątki

ArgumentNullException

Ścieżka wirtualna jest null pusta lub jest pusta.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą LoadControl metody dodać kontrolkę użytkownika do strony ASP.NET.

W metodzie OnInit zdarzenia ta strona używa LoadControl metody programowej do programowego tworzenia kontrolki użytkownika na stronie. Metoda dodaje kontrolkę do Controls właściwości kontrolki PlaceHolder serwera sieci Web o nazwie Placeholder1.

Aby uzyskać definicję klasy używanej MyControl w tym przykładzie kodu, zobacz 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

Uwagi

Jeśli kontrolka obsługuje buforowanie, obiekt zwracany z LoadControl metody nie jest obiektem Control , a raczej obiektem PartialCachingControl . virtualPath Jeśli parametr jest względny, ścieżka załadowanej kontrolki jest względna względem ścieżki TemplateControl.

Gdy załadujesz kontrolkę do kontrolki kontenera, kontener zgłasza wszystkie zdarzenia dodanego formantu, dopóki nie zostanie przechwycony do bieżącego zdarzenia. Jednak dodana kontrolka nie nadrabia zaległości w przetwarzaniu danych zwrotnych. Aby dodatkowa kontrolka brała udział w przetwarzaniu danych po awarii, w tym walidacji, kontrolka musi zostać dodana w Init zdarzeniu, a nie w Load zdarzeniu.

Zobacz też

Dotyczy

LoadControl(Type, Object[])

Control Ładuje obiekt na podstawie określonego typu i parametrów konstruktora.

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

Parametry

t
Type

Typ kontrolki.

parameters
Object[]

Tablica argumentów, które pasują do liczby, kolejności i wpisz parametry konstruktora do wywołania. Jeśli parameters jest pustą tablicą lub null, konstruktor, który nie przyjmuje żadnych parametrów (konstruktor bez parametrów) jest wywoływany.

Zwraca

Control

Zwraca określony UserControlelement .

Uwagi

Jeśli kontrolka użytkownika obsługuje buforowanie, obiekt zwrócony z LoadControl metody nie jest obiektem UserControl , a raczej jest obiektem PartialCachingControl .

Gdy załadujesz kontrolkę do kontrolki kontenera, kontener zgłasza wszystkie zdarzenia dodanego formantu, dopóki nie zostanie przechwycony do bieżącego zdarzenia. Jednak dodana kontrolka nie nadrabia zaległości w przetwarzaniu danych zwrotnych. Aby dodatkowa kontrolka brała udział w przetwarzaniu danych po awarii, w tym walidacji, kontrolka musi zostać dodana w Init zdarzeniu, a nie w Load zdarzeniu.

Zobacz też

Dotyczy