Dans ce chapitre, nous aborderons les contrôles de base disponibles dans ASP.NET.
ASP.NET propose trois types différents de contrôles de bouton :
Bouton : affiche le texte dans une zone rectangulaire.
Bouton Lien : affiche le texte comme un lien hypertexte.
Bouton Image : Affiche une image.
Lorsque l'utilisateur clique sur un bouton, deux événements sont déclenchés : clic et commande.
Syntaxe de base du contrôle des boutons :
<asp:Button ID="Button1" runat="server" onclick="Button1_Click" Text="Click" / >Propriétés communes des contrôles bouton :
| propriété | décrire |
|---|---|
| Texte | Le texte s'affiche sur le bouton. Commandes pour les boutons et les boutons de lien uniquement. |
| URL de l'image | Uniquement pour les contrôles de bouton d'image. Cette image sert à montrer le bouton. |
| Texte alternatif | Uniquement pour les contrôles de bouton d'image. Si le navigateur ne peut pas afficher l'image, le texte de remplacement sera affiché. |
| CausesValidation | Détermine si la validation de la page est effectuée lorsque l'utilisateur clique sur le bouton. La valeur par défaut est vrai. |
| NomCommande | Valeur de chaîne transmise à l'événement de commande lorsque l'utilisateur clique sur le bouton. |
| CommandArgument | Valeur de chaîne transmise à l'événement de commande lorsque l'utilisateur clique sur le bouton. |
| PostBackUrl | L'adresse de la page requise apparaît lorsque l'utilisateur clique sur le bouton. |
Le contrôle de zone de texte est spécialement conçu pour accepter les entrées de l'utilisateur. Un contrôle de zone de texte peut accepter une ou plusieurs entrées de texte en fonction de la propriété de mode texte.
Les contrôles d’étiquette offrent un moyen simple d’afficher du texte d’une page à l’autre. Si vous souhaitez afficher un texte constant, vous pouvez utiliser du texte littéral.
Syntaxe de base pour le contrôle de texte :
<asp:TextBox ID="txtstate" runat="server" ></asp:TextBox>Propriétés communes aux zones de texte et aux étiquettes :
| propriété | décrire |
|---|---|
| Mode Texte | Spécifiez le type de zone de texte. Le mode monoligne crée un texte standard, le mode multiligne crée la possibilité d'accepter plusieurs textes et les mots de passe entraînent la saisie des caractères à marquer. La valeur par défaut est le texte standard. |
| Texte | Le contenu textuel de la zone de texte. |
| Longueur maximale | Entrez la valeur maximale des caractères de texte dans la zone de texte. |
| Envelopper | Il détermine si le texte d'une zone de texte multiligne est automatiquement renvoyé à la ligne ; la valeur par défaut est True. |
| Lecture seule | Détermine si l'utilisateur peut modifier le texte dans la zone ; la valeur par défaut est false, ce qui signifie que l'utilisateur peut modifier le texte. |
| Colonnes | La largeur de la zone de texte en caractères. La largeur réelle est déterminée en fonction de la police utilisée pour la saisie du texte. |
| Lignes | La hauteur de la zone de texte multiligne. La valeur par défaut est 0, qui représente une zone de texte sur une seule ligne. |
La propriété la plus couramment utilisée d'un contrôle d'étiquette est « Texte », qui représente le texte affiché sur l'étiquette.
Une case à cocher affichera une option que l'utilisateur peut cocher ou désélectionner. Les boutons radio présentent un groupe d'options parmi lesquelles l'utilisateur ne peut sélectionner qu'une seule option.
Si vous créez un groupe de boutons radio, vous pouvez spécifier le même nom pour la propriété GroupName dans chaque groupe de boutons radio. Si plusieurs groupes doivent apparaître dans un seul formulaire, spécifiez un nom de groupe différent pour chaque groupe.
Si vous souhaitez qu'une case à cocher ou un bouton radio soit coché tel qu'il apparaît initialement, définissez sa propriété vérifiée sur true. Si plusieurs boutons radio d’un groupe ont leur propriété définie sur true, seul le dernier est considéré comme vrai.
Syntaxe de base pour les cases à cocher :
<asp:CheckBox ID= "chkoption" runat= "Server"> </asp:CheckBox>Syntaxe de base pour les boutons radio :
<asp:RadioButton ID= "rdboption" runat= "Server"> </asp: RadioButton>Propriétés communes aux cases à cocher et aux boutons radio :
| propriété | décrire |
|---|---|
| Texte | Le texte qui apparaît à côté d’une case à cocher ou d’un bouton radio. |
| À carreaux | Spécifiez s'il est sélectionné. La valeur par défaut est désélectionnée. |
| Nom du groupe | Nom du groupe auquel appartient le contrôle. |
ASP.NET fournit les contrôles suivants :
liste déroulante,
zone de liste,
liste de boutons radio,
liste de cases à cocher,
Liste à puces.
Ces contrôles permettent aux utilisateurs de sélectionner dans une liste d'un ou plusieurs éléments. Les zones de liste et les listes déroulantes contiennent un ou plusieurs éléments de liste. Ces listes peuvent être chargées via du code ou par l'éditeur ListItemCollection.
Syntaxe de base du contrôle list box :
<asp:ListBox ID="ListBox1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="ListBox1_SelectedIndexChanged"></asp:ListBox>Syntaxe de base du contrôle de liste déroulante :
<asp:DropDownList ID="DropDownList1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged"></asp:DropDownList>Propriétés communes aux zones de liste et aux listes déroulantes :
| propriété | décrire |
|---|---|
| Articles | Collection d'objets ListItem qui représentent les éléments dans le contrôle. Cette propriété renvoie un objet de type ListItemCollection. |
| Lignes | Spécifie le nombre d'éléments à afficher dans la boîte. Si la liste réelle contient plus de lignes que la liste affichée, des barres de défilement sont ajoutées. |
| IndexSélectionné | L'index de l'élément actuellement sélectionné. Si plusieurs éléments sont sélectionnés, le premier index sélectionne l'élément. Si aucun élément n'est sélectionné, la valeur de cette propriété est -1. |
| Valeur sélectionnée | La valeur de l'élément actuellement sélectionné. Si plusieurs éléments sont sélectionnés, la valeur du premier élément est sélectionnée. Si aucun élément n'est sélectionné, la valeur de cette propriété est une chaîne vide (""). |
| Mode de sélection | Indique si une zone de liste autorise une sélection unique ou plusieurs sélections. |
Propriétés communes pour chaque objet d'élément de liste :
| propriété | décrire |
|---|---|
| Texte | Le texte affiché pour l'élément. |
| Choisi | Indique si l'élément est sélectionné. |
| Valeur | Une chaîne de caractères associée au projet. |
Les éléments sur lesquels se concentrer sont :
Si vous souhaitez travailler avec des éléments dans une liste déroulante ou une zone de liste, vous devez utiliser la propriété Item du contrôle. Cette propriété renvoie un objet ListItemCollection qui contient tous les éléments de la liste.
L'événement SelectedIndexChanged est déclenché lorsque l'utilisateur sélectionne un élément différent dans une liste déroulante ou une zone de liste.
Un objet ListItemCollection est une collection d’objets ListItem. Chaque objet ListItem représente un élément de la liste. Les numéros d’élément dans un ListItemCollection commencent à 0.
Lorsque la chaîne utilisée dans le processus de chargement des éléments dans une zone de liste est, par exemple : lstcolor.Items.Add ("Bleu"), alors les paramètres de propriété du texte et de la valeur de l'élément de liste sont les valeurs de chaîne que vous spécifiez. Afin de le configurer différemment, vous devez créer un objet de l'élément de liste, puis ajouter l'élément à la collection.
L'éditeur ListItemCollection est utilisé pour ajouter des éléments à une liste déroulante ou à une zone de liste. Il est utilisé pour créer une liste statique d’éléments. Pour afficher l'éditeur de collection, sélectionnez Modifier l'élément dans le menu Balise active ou sélectionnez le contrôle et cliquez sur le bouton points de suspension dans les propriétés de l'élément de la fenêtre Propriétés.
Propriétés communes de ListItemCollection :
| propriété | décrire |
|---|---|
| Article (entier) | Objet ListItem représentant l'élément à l'index spécifié. |
| Compter | Le nombre d'éléments dans la collection. |
Méthodes de base de ListItemCollection :
| méthode | décrire |
|---|---|
| Ajouter (chaîne) | Ajoute un nouvel élément à la fin de la collection et attribue un paramètre de chaîne à la propriété de texte de l'élément. |
| Ajouter (ListeItem) | Ajoute un nouvel élément à la fin de la collection. |
| Insérer (entier, chaîne) | Insère un élément dans la collection à la position d'index spécifiée et attribue un argument de chaîne à la propriété de texte de l'élément. |
| Insérer (entier, ListItem) | Insère un élément dans la collection à l'index spécifié. |
| Supprimer (chaîne) | Supprime les éléments avec la même chaîne que la valeur du texte. |
| Supprimer (ListeItem) | Supprimez l'élément spécifié. |
| RemoveAt (entier) | Supprime l'élément à l'index spécifié sous forme d'entier. |
| Clair | Supprime tous les éléments de la collection. |
| FindByValue (chaîne) | Renvoie le même élément que la valeur de chaîne. |
| RechercherParValeur(Texte) | Renvoie le même élément que la chaîne littérale. |
Une liste de boutons radio présente une liste d’options mutuellement exclusives. Une colonne de liste de cases à cocher présente une liste d’options indépendantes. Ces contrôles contiennent une collection d'objets ListItem, qui peuvent être référencés via la propriété Item du contrôle.
Syntaxe de base pour la liste de boutons radio :
<asp:RadioButtonList ID="RadioButtonList1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="RadioButtonList1_SelectedIndexChanged"></asp:RadioButtonList>Syntaxe de base pour la liste de cases à cocher :
<asp:CheckBoxList ID="CheckBoxList1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="CheckBoxList1_SelectedIndexChanged"></asp:CheckBoxList>Propriétés communes aux listes de cases à cocher et de boutons radio :
| propriété | décrire |
|---|---|
| Répéter la mise en page | Cette propriété spécifie si des balises ou un flux HTML brut sont utilisés pour restituer la liste formatée. La valeur par défaut est le tableau. |
| RépéterDirection | Il précise le sens dans lequel le contrôle peut être répété. Les valeurs disponibles sont horizontales et verticales. La valeur par défaut est verticale. |
| Répéter les colonnes | Lorsque le contrôle est répété, il précise le numéro de la colonne par défaut ; |
Le contrôle Liste à puces crée une liste à puces ou numérotée. Ces contrôles contiennent une collection d'objets ListItem, qui peuvent être référencés via la propriété Item du contrôle.
Syntaxe de base pour les listes à puces :
<asp:BulletedList ID="BulletedList1" runat="server"></asp:BulletedList>Propriétés communes des listes à puces :
| propriété | décrire |
|---|---|
| Style de puce | Cette propriété spécifie le style et l'apparence des numéros d'élément ou des numéros. |
| RépéterDirection | Il précise le sens dans lequel le contrôle peut être répété. Les valeurs disponibles sont horizontales et verticales. La valeur par défaut est verticale. |
| Répéter les colonnes | Lorsque le contrôle est répété, il précise le numéro de la colonne par défaut ; |
Les contrôles de lien hypertexte sont comme des éléments HTML <a> .
Syntaxe de base du contrôle des liens hypertexte :
<asp:HyperLink ID="HyperLink1" runat="server"> HyperLink</asp:HyperLink>Il possède les propriétés suivantes :
| propriété | décrire |
|---|---|
| URL de l'image | Le chemin d’accès à l’image affichée par le contrôle. |
| NaviguerUrl | Adresse du lien cible. |
| Texte | Le texte affiché sous forme de lien. |
| Cible | La fenêtre ou le cadre qui charge la page liée. |
Si l'image ne peut pas être affichée, le contrôle d'image affiche l'image sur la page Web ou un texte alternatif.
Syntaxe de base des contrôles image :
<asp:Image ID="Image1" runat="server">Il possède les propriétés importantes suivantes :
| propriété | décrire |
|---|---|
| Texte alternatif | Afficher un texte alternatif lorsque l'image n'existe pas. |
| Aligner l'image | Contrôle des options d’alignement. |
| URL de l'image | Le chemin d’accès à l’image affichée par le contrôle. |