Procédure pas à pas : utilisation de code partagé au sein de sites Web dans Visual Web Developer
Mise à jour : novembre 2007
Lorsque vous créez des sites Web, Visual Web Developer vous permet de créer facilement du code partagé dans des fichiers de classe qui peuvent être utilisés par la suite par des pages de votre application sans avoir été compilés.
Remarque : |
---|
Si vous avez des assemblys existants (fichiers .dll), vous pouvez les ajouter au répertoire Bin du site Web ; les assemblys sont ensuite automatiquement référencés par le site Web. |
Dans cette procédure pas à pas, vous créerez une classe simple, puis l'utiliserez dans une page Web ASP.NET.
Cette procédure pas à pas illustre les tâches suivantes :
ajout d'une classe à un site Web ;
référencement automatique du composant par Visual Web Developer.
Composants requis
Pour effectuer cette procédure pas à pas, vous aurez besoin des éléments suivants :
Visual Web Developer (Visual Studio).
.NET Framework
Cette procédure pas à pas suppose que vous possédez des connaissances générales concernant l'utilisation de Visual Web Developer. Pour une introduction, consultez Procédure pas à pas : création d'une page Web de base dans Visual Web Developer.
Création du site et de la page Web
Si vous avez déjà créé un site Web dans Visual Web Developer (par exemple, en effectuant les étapes décrites dans Procédure pas à pas : création d'une page Web de base dans Visual Web Developer ou dans Procédure pas à pas : création d'un site Web IIS local dans Visual Web Developer), vous pouvez utiliser ce site Web et passer à la section suivante. Sinon, créez un site et une page Web en suivant ces étapes.
Pour créer un site Web de système de fichiers
Ouvrez Visual Web Developer.
Dans le menu Fichier, cliquez sur Nouveau site Web. Dans le menu Fichier de Visual Web Developer Express, cliquez sur Nouveau, puis sur Site Web.
La boîte de dialogue Nouveau site Web s'affiche.
Sous Modèles Visual Studio installés, cliquez sur Site Web ASP.NET.
Dans la zone Emplacement, entrez le nom du dossier dans lequel vous souhaitez conserver les pages du site Web.
Par exemple :
Si vous créez un site Web de système de fichiers, tapez C:\SampleSite.
Si IIS est installé et si vous créez un site Web HTTP, tapez https://localhost/SampleSite.
Dans la liste Langage, sélectionnez le langage de programmation que vous préférez utiliser.
Cliquez sur OK.
Visual Web Developer crée le site Web et ouvre une page nommée Default.aspx.
Création d'une classe partagée
Vous pouvez créer des classes réutilisables en les conservant dans un dossier nommé App_Code. Visual Web Developer surveille le dossier App_Code et lorsque des nouveaux fichiers de classe sont ajoutés, rend les composants disponibles au reste du code de votre application. Par défaut, les classes dans le dossier App_Code sont compilées dans un seul assembly au moment de l'exécution.
Remarque : |
---|
Vous devez placer uniquement les classes (et d'autres types partagés pris en charge) dans le dossier App_Code. Ne placez pas des pages, des contrôles utilisateur Web ou d'autres fichiers qui contiennent des éléments autres que du code dans le dossier App_Code. |
Pour créer un dossier App_Code
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du site Web, puis cliquez sur Ajouter un dossier, puis sur App_Code.
Vous pouvez à présent ajouter le composant à votre site.
Pour créer une classe partagée dans le dossier App_Code
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur App_Code, puis cliquez sur Ajouter un nouvel élément.
Remarque : Assurez-vous de créer l'élément dans le dossier App_Code, pas dans le dossier racine du site Web.
Sous Modèles Visual Studio installés, cliquez sur Classe.
Dans la zone Nom, tapez SampleClass1.
Dans la liste Langage, sélectionnez le langage utilisé par la page Web qui utilisera la classe partagée.
Cliquez sur Ajouter.
Visual Web Developer ouvre le nouveau fichier de classe dans l'éditeur.
Créez une classe qui possède une seule propriété nommée testString en copiant le code suivant dans le fichier de classe :
Public Class SampleClass1 private testStringValue As String Public Property testString as String Get return testStringValue End Get Set (Value as String) testStringValue = value End Set End Property End Class
using System; public class SampleClass1 { public SampleClass1() { } private string testStringValue; public string testString { get { return testStringValue; } set { testStringValue = value; } } }
Enregistrez le fichier et fermez-le.
Notez que le fichier n'est pas stocké en tant que fichier compilé.
Remarque : Lorsque vous utilisez des classes partagées dans le dossier App_Code, vous ne devez pas enregistrer les composants afin que Visual Web Developer puisse conserver une référence aux composants. Si la page Web et le composant sont dans le même langage de programmation, Visual Web Developer conserve une référence au composant en mémoire. Dans ce cas, vous fermez le fichier parce que vous avez terminé avec celui-ci.
Utilisation de la classe partagée
L'étape suivante consiste à utiliser la classe partagée dans une page Web ASP.NET. Vous pouvez utiliser la page Default.aspx qui a été créée lorsque vous avez créé le site Web.
Pour utiliser la classe partagée
Basculez vers la page Default.aspx ou ouvrez-la, puis basculez en mode Design.
Remarque : Si vous n'avez pas de page Default.aspx, vous pouvez utiliser une autre page. Vous pouvez également ajouter une nouvelle page au site Web. Pour cela, dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du site Web, puis cliquez sur Ajouter un nouvel élément, puis sur Formulaire Web. Dans la liste Langage, entrez le même langage de programmation que vous avez utilisé pour le composant, puis cliquez sur OK.
À partir du dossier Standard de la Boîte à outils, faites glisser un contrôle TextBox, un contrôle Label et un contrôle Button sur la page.
Remarque : Pour cette procédure pas à pas, la disposition de la page n'a pas d'importance.
Double-cliquez sur le contrôle Button afin de créer un gestionnaire Click pour celui-ci.
Le code du gestionnaire click doit se présenter comme suit :
Protected Sub Button1_Click(ByVal sender As Object, _ ByVal e As System.EventArgs) Handles Button1.Click End Sub
protected void Button1_Click(object sender, EventArgs e) { }
Dans le gestionnaire, tapez :
Dim sc As New
SampleClass1 sc = new
Lorsque vous appuyez sur ESPACE après avoir tapé New ou new, Visual Web Developer affiche une liste des classes disponibles. La classe que vous avez créée dans la section précédente, SampleClass1, est incluse dans la liste.
Terminez l'instruction en tapant SampleClass1 ou en double-cliquant sur celle-ci dans la liste, afin que l'instruction se présente comme suit :
Dim sc As New SampleClass1
SampleClass1 sc = new SampleClass1();
Appuyez sur ENTRÉE, puis tapez ce qui suit :
sc.
Aussitôt après avoir tapé la période, Visual Web Developer affiche encore une liste de membres pour vous aider à sélectionner un membre dans l'exemple de classe.
Terminez l'instruction et le gestionnaire dans la manière suivante :
sc.testString = TextBox1.Text Label1.Text = sc.testString
sc.testString = TextBox1.Text; Label1.Text = sc.testString;
Enregistrez vos fichiers.
Test de la page et de la classe
Vous pouvez exécuter le site Web pour vérifier que la classe partagée fonctionne.
Pour tester la page et le composant
Ouvrez la page Default.aspx.
Appuyez sur CTRL+F5 pour exécuter la page.
Lorsque la page apparaît dans le navigateur, tapez du texte dans la zone de texte, puis cliquez sur le bouton.
Cela vous permet de définir une propriété dans votre classe simple qui est ensuite affichée dans le contrôle Label.
Si vous utilisez Microsoft Windows Explorer pour examiner le répertoire dans lequel le site Web se trouve, vous verrez votre page et le dossier App_Code. Notez qu'il n'y a aucun fichier .dll ou autre code exécutable dans le dossier App_Code ni ailleurs sous la racine du site Web. À la place, Visual Web Developer a compilé dynamiquement la page et la classe partagée.
Étapes suivantes
Cette procédure pas à pas illustre l'ajout de classes partagées à un site Web sans compiler les composants. Vous souhaiterez peut-être utiliser les classes partagées de différentes façons. Vous pouvez, par exemple, souhaiter effectuer les opérations suivantes :
Utiliser un composant compilé.
Si vous avez un assembly que vous pouvez utiliser dans le site Web, créez un dossier Bin, puis copiez le fichier .dll vers le dossier Bin. Vous pouvez ensuite référencer l'assembly dans votre page de la même façon que vous avez référencé le composant que vous aviez créé dans cette procédure pas à pas.
Créer un composant pour l'accès aux données.
Pour plus d'informations, consultez Procédure pas à pas : liaison de données à un objet métier personnalisé.
Créer un service Web.
Pour plus d'informations, consultez Procédure pas à pas : création et utilisation d'un service Web ASP.NET dans Visual Web Developer.