TemplateControl.LoadControl Méthode

Définition

Charge un Control.

Surcharges

LoadControl(String)

Charge un objet Control à partir d'un fichier en fonction d'un chemin d'accès virtuel spécifié.

LoadControl(Type, Object[])

Charge un objet Control selon un type et des paramètres de constructeur spécifiés.

Remarques

Lorsque vous chargez un contrôle dans un contrôle conteneur, le conteneur déclenche tous les événements du contrôle ajouté jusqu’à ce qu’il ait rattrapé l’événement actuel. Toutefois, le contrôle ajouté ne rattrape pas le traitement des données de publication. Pour qu’un contrôle ajouté participe au traitement des données postback, y compris la validation, le contrôle doit être ajouté dans l’événement Init plutôt que dans l’événement Load .

LoadControl(String)

Charge un objet Control à partir d'un fichier en fonction d'un chemin d'accès virtuel spécifié.

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

Paramètres

virtualPath
String

Chemin d'accès virtuel à un fichier de contrôle.

Retours

Retourne le Control spécifié.

Exceptions

Le chemin d'accès est null ou vide.

Exemples

L’exemple de code suivant montre comment utiliser la LoadControl méthode pour ajouter un contrôle utilisateur à une page ASP.NET.

Dans la OnInit méthode event, cette page utilise la LoadControl méthode pour créer par programmation un contrôle utilisateur sur la page. La méthode ajoute le contrôle à la Controls propriété d’un PlaceHolder contrôle serveur Web nommé Placeholder1.

Pour obtenir la définition de la MyControl classe utilisée dans cet exemple de code, consultez 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

Remarques

Si le contrôle prend en charge la mise en cache, l’objet retourné par la LoadControl méthode n’est pas en réalité un Control objet ; il s’agit plutôt d’un PartialCachingControl objet . Si le virtualPath paramètre est relatif, le chemin du contrôle chargé est relatif au chemin du TemplateControl.

Lorsque vous chargez un contrôle dans un contrôle conteneur, le conteneur déclenche tous les événements du contrôle ajouté jusqu’à ce qu’il ait rattrapé l’événement actuel. Toutefois, le contrôle ajouté ne rattrape pas le traitement des données de publication. Pour qu’un contrôle ajouté participe au traitement des données postback, y compris la validation, le contrôle doit être ajouté dans l’événement Init plutôt que dans l’événement Load .

Voir aussi

S’applique à

LoadControl(Type, Object[])

Charge un objet Control selon un type et des paramètres de constructeur spécifiés.

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

Paramètres

t
Type

Type du contrôle.

parameters
Object[]

Tableau des arguments qui correspondent en nombre, en ordre et en type aux paramètres du constructeur à appeler. Si parameters est un tableau vide ou null, le constructeur qui ne prend aucun paramètre (constructeur sans paramètre) est appelé.

Retours

Retourne le UserControl spécifié.

Remarques

Si le contrôle utilisateur prend en charge la mise en cache, l’objet retourné par la LoadControl méthode n’est pas en fait un UserControl objet ; il s’agit plutôt d’un PartialCachingControl objet.

Lorsque vous chargez un contrôle dans un contrôle conteneur, le conteneur déclenche tous les événements du contrôle ajouté jusqu’à ce qu’il ait rattrapé l’événement actuel. Toutefois, le contrôle ajouté ne rattrape pas le traitement des données de publication. Pour qu’un contrôle ajouté participe au traitement des données postback, y compris la validation, le contrôle doit être ajouté dans l’événement Init plutôt que dans l’événement Load .

Voir aussi

S’applique à