TemplateControl.LoadControl Metoda

Definicja

Ładuje Control .Loads a Control.

Przeciążenia

LoadControl(String)

Ładuje Control obiekt z pliku na podstawie określonej ścieżki wirtualnej.Loads a Control object from a file based on a specified virtual path.

LoadControl(Type, Object[])

Ładuje Control obiekt na podstawie określonego typu i parametrów konstruktora.Loads a Control object based on a specified type and constructor parameters.

Uwagi

Podczas ładowania kontrolki do kontrolki kontenera, kontener wywołuje wszystkie dodane zdarzenia kontrolki, dopóki nie przechwycono do bieżącego zdarzenia.When you load a control into a container control, the container raises all of the added control's events until it has caught up to the current event. Jednak dodany formant nie jest zgodny z przetwarzaniem danych ogłaszania zwrotnego.However, the added control does not catch up with postback data processing. Aby dodana kontrolka mogła uczestniczyć w przetwarzaniu danych ogłaszania zwrotnego, w tym walidacji, należy dodać formant w Init zdarzeniu, a nie w Load zdarzeniu.For an added control to participate in postback data processing, including validation, the control must be added in the Init event rather than in the Load event.

LoadControl(String)

Ładuje Control obiekt z pliku na podstawie określonej ścieżki wirtualnej.Loads a Control object from a file based on a specified virtual path.

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 kontrolnego.The virtual path to a control file.

Zwraca

Control

Zwraca określony Control .Returns the specified Control.

Wyjątki

Ścieżka wirtualna jest null pusta.The virtual path is null or empty.

Przykłady

Poniższy przykład kodu demonstruje, jak za pomocą LoadControl metody dodać kontrolkę użytkownika do strony ASP.NET.The following code example demonstrates how to use the LoadControl method to add a user control to an ASP.NET page.

W OnInit metodzie zdarzenia ta strona używa LoadControl metody do programistycznego tworzenia kontrolki użytkownika na stronie.In the OnInit event method, this page uses the LoadControl method to programmatically create a user control on the page. Metoda dodaje formant do Controls właściwości PlaceHolder kontrolki serwera sieci Web o nazwie Placeholder1 .The method adds the control to the Controls property of a PlaceHolder Web server control named Placeholder1.

Definicja MyControl klasy, która jest używana w tym przykładzie kodu, znajduje się w temacie TemplateControl .For the definition of the MyControl class that is used in this code example, see 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 Control obiektem, a jest obiektem PartialCachingControl .If the control supports caching, the object returned from the LoadControl method is not actually a Control object; rather, it is a PartialCachingControl object. Jeśli virtualPath parametr jest względny, ścieżka załadowanej kontrolki jest określana względem ścieżki TemplateControl .If the virtualPath parameter is relative, the path of the loaded control is relative to the path of the TemplateControl.

Podczas ładowania kontrolki do kontrolki kontenera, kontener wywołuje wszystkie dodane zdarzenia kontrolki, dopóki nie przechwycono do bieżącego zdarzenia.When you load a control into a container control, the container raises all of the added control's events until it has caught up to the current event. Jednak dodany formant nie jest zgodny z przetwarzaniem danych ogłaszania zwrotnego.However, the added control does not catch up with postback data processing. Aby dodana kontrolka mogła uczestniczyć w przetwarzaniu danych ogłaszania zwrotnego, w tym walidacji, należy dodać formant w Init zdarzeniu, a nie w Load zdarzeniu.For an added control to participate in postback data processing, including validation, the control must be added in the Init event rather than in the Load event.

Zobacz też

Dotyczy

LoadControl(Type, Object[])

Ładuje Control obiekt na podstawie określonego typu i parametrów konstruktora.Loads a Control object based on a specified type and constructor parameters.

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 formantu.The type of the control.

parameters
Object[]

Tablica argumentów, które pasują do wartości Number, Order i Type parametrów konstruktora do wywołania.An array of arguments that match in number, order, and type the parameters of the constructor to invoke. Jeśli parameters jest tablicą pustą lub null , Konstruktor, który nie pobiera parametrów (Konstruktor bez parametrów) jest wywoływany.If parameters is an empty array or null, the constructor that takes no parameters (the parameterless constructor) is invoked.

Zwraca

Control

Zwraca określony UserControl .Returns the specified UserControl.

Uwagi

Jeśli kontrolka użytkownika obsługuje buforowanie, obiekt zwrócony z LoadControl metody nie jest w rzeczywistości UserControl obiektem, a jest obiektem PartialCachingControl .If the user control supports caching, the object returned from the LoadControl method is not actually a UserControl object; rather, it is a PartialCachingControl object.

Podczas ładowania kontrolki do kontrolki kontenera, kontener wywołuje wszystkie dodane zdarzenia kontrolki, dopóki nie przechwycono do bieżącego zdarzenia.When you load a control into a container control, the container raises all of the added control's events until it has caught up to the current event. Jednak dodany formant nie jest zgodny z przetwarzaniem danych ogłaszania zwrotnego.However, the added control does not catch up with postback data processing. Aby dodana kontrolka mogła uczestniczyć w przetwarzaniu danych ogłaszania zwrotnego, w tym walidacji, należy dodać formant w Init zdarzeniu, a nie w Load zdarzeniu.For an added control to participate in postback data processing, including validation, the control must be added in the Init event rather than in the Load event.

Zobacz też

Dotyczy