Partager via

TemplateControl.LoadControl Méthode

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

Charge un Control.

Surcharges

Nom Description
LoadControl(String)

Charge un Control objet à partir d’un fichier basé sur un chemin d’accès virtuel spécifié.
LoadControl(Type, Object[])

Charge un Control objet basé sur 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 postback. Pour qu’un contrôle ajouté participe au traitement des données de publication, 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 Control objet à partir d’un fichier basé sur 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

Control

Retourne le Control.

Exceptions

ArgumentNullException

Le chemin d’accès virtuel 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 d’événement, cette page utilise la LoadControl méthode pour créer par programme 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 réellement 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 d’accès 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 postback. Pour qu’un contrôle ajouté participe au traitement des données de publication, 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 Control objet basé sur 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 d’arguments correspondant au nombre, à l’ordre et au type des paramètres du constructeur à appeler. S’il parameters s’agit d’un tableau vide ou null, le constructeur qui ne prend aucun paramètre (le constructeur sans paramètre) est appelé.

Retours

Control

Retourne le UserControl.

Remarques

Si le contrôle utilisateur prend en charge la mise en cache, l’objet retourné par la LoadControl méthode n’est pas réellement 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 postback. Pour qu’un contrôle ajouté participe au traitement des données de publication, 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 à