Partager via

Exemples de contrôles serveur

  • Article

Le tableau suivant contient des exemples simples qui montrent comment effectuer les tâches de création de contrôle serveur.

Tâche Exemple
Création d'un contrôle serveur simple Développement d'un contrôle serveur ASP.NET simple
Exposition de propriétés à partir d'un contrôle Exemple de propriété personnalisée
Rendu d'un contrôle serveur Rendu d'exemples d'un contrôle serveur
Traitement des données de publication Exemple de traitement des données de publication
Exposition d'un événement Définition d'un événement
Capture d'un événement de publication Exemple d'événement de publication
Propagation d'un événement Exemple de contrôle de propagation d'événements
Génération d'un script côté client pour la publication Exemple de publication à l'aide d'un script côté client
Utilisation d'une variable masquée pour la capture de modifications côté client Persistance des modifications côté client dans un contrôle qui n'est pas un formulaire
Développement d'un contrôle composite Exemple de contrôle serveur composite
Utilisation du rendu à la place de la composition de contrôle Composition et rendu
Développement d'un contrôle basé sur un modèle Exemple de contrôle basé sur un modèle
Commande d'analyse de contrôle à l'aide de ParseChildrenAttribute ParseChildrenAttribute, exemple
Création d'un générateur de contrôles personnalisé Exemple de générateur de contrôles personnalisé

Le tableau suivant contient des exemples plus complexes (similaires à ceux fournis avec le kit de développement SDK).

Contrôle complexe Exemple
Contrôle dépendant basé sur un modèle Exemple de contrôle dépendant basé sur un modèle
Contrôle validateur Exemples de contrôle validateur

Pour obtenir un exemple de concepteur pour le contrôle dépendant basé sur un modèle, consultez Exemple de concepteur de contrôles dépendants basés sur un modèle Web Forms.

Génération des exemples

Les instructions relatives à la génération des exemples de validateurs sont décrites dans Exemples de contrôle validateur. Les instructions de génération d'autres exemples cités dans les tableaux précédents sont indiquées ci-après.

Pour générer les exemples

  1. Créez un répertoire racine virtuel IIS (Internet Information Services) (nommé Samples dans cette description).

  2. Créez un sous-répertoire nommé bin sous le répertoire racine virtuel (par exemple, Samples\bin). Le répertoire bin contient les assemblys (fichiers .dll compilés) locaux de votre application ASP.NET. Vous pouvez créer des sous-répertoires sous votre répertoire racine virtuel (par exemple, Samples\EventControls, Samples\DataBoundControls, etc.). Cependant, vous devez créer un seul répertoire bin, qui doit se situer directement sous le répertoire racine virtuel (Samples\bin).

  3. Copiez les pages ASP.NET (telles que .aspx, .ascx, .asax et .asmx) et les fichiers sources (tels que .cs ou .vb) dans le répertoire racine virtuel. Si vous ne souhaitez pas qu'un utilisateur accède au code source dans un scénario de déploiement, vous pouvez copier les fichiers sources (.cs ou .vb) dans un répertoire distinct qui ne se trouve pas sous la racine virtuelle. Les pages ASP.NET doivent cependant être placées dans le répertoire racine virtuel (Samples) ou dans l'un de ses sous-répertoires (Samples\DataBoundControls).

  4. À partir du répertoire racine virtuel (ou du répertoire contenant les fichiers sources .cs ou .vb), exécutez la commande ci-dessous. Si la commande est exécutée à partir d'un répertoire qui n'est pas le répertoire racine virtuel, vous devez indiquer le chemin d'accès au répertoire \bin.

    csc /t:library /out:./bin/CustomControls.dll /r:System.dll /r:System.web.dll /r:System.Drawing.dll *.cs
[Visual Basic]
vbc /t:library /out:./bin/CustomControls.dll /r:System.dll /r:System.web.dll /r:System.drawing.dll
 /r:System.Data.dll *.vb

    **Remarque   **L'assembly qui est généré par la commande ci-dessus doit être nommé CustomControls.dll, car le nom de l'assembly CustomControls est utilisé dans la directive de page Register sur l'exemple de pages .aspx.

  5. Demandez un exemple de page .aspx en entrant l'une des commandes suivantes dans la barre d'adresses de votre navigateur.

    https://localhost/Samples/SampleFilename.aspx

    ou

    http://YourMachineName/Samples/Filename.aspx

    Remarque   Vous pouvez générer l'exemple de façon incrémentielle en copiant uniquement les fichiers qui vous intéressent et en exécutant la commande de génération décrite à l'étape 4. Lorsque vous voulez ajouter d'autres exemples, copiez les pages ASP.NET et les fichiers sources supplémentaires dans les répertoires appropriés, puis réexécutez la commande de génération de l'étape 4.

Pour plus d'informations sur le déploiement d'applications ASP.NET, consultez le Démarrage rapide ASP.NET --> Déploiement.

Voir aussi

Développement de contrôles serveur ASP.NET