TemplateControl.LoadControl Metoda

  • Odwołanie

Definicja

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

Ładuje element Control.

Przeciążenia

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 dodanej kontrolki, dopóki nie dogonią bieżącego zdarzenia. Jednak dodana kontrolka nie nadrabia zaległości w przetwarzaniu danych zwrotnych. Aby dodać kontrolę w celu udziału w przetwarzaniu danych po powrocie zwrotnym, w tym weryfikacji, kontrolka musi zostać dodana w Init zdarzeniu, a nie w Load przypadku.

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

Poniższy przykład kodu pokazuje, jak za pomocą LoadControl metody dodać kontrolkę użytkownika do strony ASP.NET.

W metodzie OnInit zdarzenia ta strona używa LoadControl metody 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 zwrócony z LoadControl metody nie jest w rzeczywistości obiektem Control , a raczej jest 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 dodanej kontrolki, dopóki nie dogonią bieżącego zdarzenia. Jednak dodana kontrolka nie nadrabia zaległości w przetwarzaniu danych zwrotnych. Aby dodać kontrolę w celu udziału w przetwarzaniu danych po powrocie zwrotnym, w tym weryfikacji, kontrolka musi zostać dodana w Init zdarzeniu, a nie w Load przypadku.

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 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 w rzeczywistości obiektem UserControl , a raczej jest PartialCachingControl to obiekt.

Gdy załadujesz kontrolkę do kontrolki kontenera, kontener zgłasza wszystkie zdarzenia dodanej kontrolki, dopóki nie dogonią bieżącego zdarzenia. Jednak dodana kontrolka nie nadrabia zaległości w przetwarzaniu danych zwrotnych. Aby dodać kontrolę w celu udziału w przetwarzaniu danych po powrocie zwrotnym, w tym weryfikacji, kontrolka musi zostać dodana w Init zdarzeniu, a nie w Load przypadku.

Zobacz też

Dotyczy