Exporter (0) Imprimer
Développer tout

TextBox, classe

Affiche un contrôle zone de texte pour des entrées d'utilisateur.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

[ValidationPropertyAttribute("Text")] 
[ControlValuePropertyAttribute("Text")] 
public class TextBox : WebControl, IPostBackDataHandler, IEditableTextControl, ITextControl
/** @attribute ValidationPropertyAttribute("Text") */ 
/** @attribute ControlValuePropertyAttribute("Text") */ 
public class TextBox extends WebControl implements IPostBackDataHandler, IEditableTextControl, 
	ITextControl
ValidationPropertyAttribute("Text") 
ControlValuePropertyAttribute("Text") 
public class TextBox extends WebControl implements IPostBackDataHandler, IEditableTextControl, 
	ITextControl

Le contrôle serveur TextBox désigne un contrôle d'entrée qui permet à l'utilisateur d'entrer du texte. Par défaut, la propriété TextMode du contrôle a la valeur TextBoxMode.SingleLine, qui s'affiche dans une zone de texte d'une seule ligne. Cependant, vous pouvez également utiliser le contrôle TextBox pour afficher une zone de texte multiligne ou une zone de texte qui masque l'entrée d'utilisateur en remplaçant la valeur de la propriété TextMode par TextBoxMode.MultiLine ou TextBoxMode.Password, respectivement. Le texte affiché dans le contrôle TextBox est spécifié ou déterminé par l'utilisation de la propriété Text.

Le contrôle TextBox contient plusieurs propriétés qui vous permettent de contrôler l'apparence du contrôle. La largeur d'affichage de la zone de texte, en caractères, est déterminée par sa propriété Columns. Si le contrôle TextBox est une zone de texte multiligne, le nombre de lignes qu'il affiche est déterminé par la propriété Rows. Pour afficher du texte qui s'encapsule dans le contrôle TextBox, attribuez la valeur true à la propriété Wrap.

Vous pouvez également spécifier la manière dont les données sont entrées dans le contrôle TextBox en définissant quelques propriétés. Pour empêcher la modification du texte affiché dans le contrôle, attribuez la valeur true à la propriété ReadOnly. Si vous voulez limiter l'entrée d'utilisateur à un nombre spécifié de caractères, définissez la propriété MaxLength.

Pour obtenir la liste des valeurs de propriétés initiales d'une instance de TextBox, consultez le constructeur TextBox.

AttentionAttention

Ce contrôle peut être utilisé pour accepter des entrées d'utilisateur susceptibles d'inclure un script client malveillant. Vérifiez toutes les informations envoyées par un client pour un script exécutable, des instructions SQL ou un autre code avant de les afficher dans votre application. Vous pouvez utiliser des contrôles de validation pour vérifier les entrées d'utilisateur avant d'afficher le texte d'entrée dans un contrôle. ASP.NET fournit une fonctionnalité de validation de la demande d'entrée pour bloquer les scripts et le code HTML dans les entrées d'utilisateur. Pour plus d'informations, consultez Sécurisation de contrôles standard, Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTML et Validation des entrées d'utilisateur dans des pages Web ASP.NET.

Accessibilité

Le balisage rendu par défaut pour ce contrôle peut ne pas se conformer aux normes d'accessibilité telles que les instructions de priorité 1 d'accessibilité du contenu Web (WCAG, Web Content Accessibility Guidelines). Pour plus d'informations sur la prise en charge d'accessibilité pour ce contrôle, consultez Contrôles et accessibilité ASP.NET.

RubriqueEmplacement
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : utilisation de styles de feuille de style en cascade dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : validation des entrées d'utilisateur dans une page Web FormsGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web de base dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : validation des entrées d'utilisateur dans une page Web FormsGénération d'applications à l'aide de Visual Web Developer
Comment : obtenir et définir des valeurs dans les contrôles serveur Web TextBoxGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des modifications dans un contrôle serveur Web TextBoxGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir des propriétés de contrôle serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : obtenir et définir des valeurs dans les contrôles serveur Web TextBoxGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des modifications dans un contrôle serveur Web TextBoxGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir des propriétés de contrôle serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir un contrôle serveur Web TextBox pour l'entrée de mots de passeGénération d'applications Web ASP.NET dans Visual Studio
Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTMLGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web de base dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : spécifier une entrée multiligne pour un contrôle serveur Web TextBoxGénération d'applications Web ASP.NET dans Visual Studio
Comment : obtenir et définir des valeurs dans les contrôles serveur Web TextBoxGénération d'applications Web ASP.NET
Comment : répondre à des modifications dans un contrôle serveur Web TextBoxGénération d'applications Web ASP.NET
Comment : définir des propriétés de contrôle serveur Web ASP.NETGénération d'applications Web ASP.NET
Comment : spécifier une entrée multiligne pour un contrôle serveur Web TextBoxGénération d'applications Web ASP.NET
Comment : définir un contrôle serveur Web TextBox pour l'entrée de mots de passeGénération d'applications Web ASP.NET
Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTMLGénération d'applications Web ASP.NET
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET
Comment : définir un contrôle serveur Web TextBox pour l'entrée de mots de passeGénération d'applications Web ASP.NET dans Visual Studio
Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTMLGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web de base dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : spécifier une entrée multiligne pour un contrôle serveur Web TextBoxGénération d'applications Web ASP.NET dans Visual Studio

L'exemple de code suivant illustre comment utiliser le contrôle TextBox pour obtenir l'entrée d'utilisateur. Lorsque l'utilisateur clique sur le bouton Ajouter, la somme des valeurs entrées dans les zones de texte est affichée.

<%@ Page Language="C#" AutoEventWireup="True" %>

<html> 

<head>

   <script runat="server">

      protected void AddButton_Click(Object sender, EventArgs e)
      {
         int Answer;

         Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text);

         AnswerMessage.Text = Answer.ToString();

      }

   </script>

</head>

<body>

   <form runat="server">

      <h3> TextBox Example </h3>

      <table>

         <tr>

            <td colspan="5">

               Enter integer values into the text boxes. <br>
               Click the Add button to add the two values. <br>
               Click the Reset button to reset the text boxes.

            </td>

         </tr>

         <tr>

            <td colspan="5">

               &nbsp;

            </td>

         </tr>

         <tr align="center">

            <td>

               <asp:TextBox ID="Value1"
                    Columns="2"
                    MaxLength="3"
                    Text="1"
                    runat="server"/>

            </td>

            <td>

               + 

            </td>

            <td>

               <asp:TextBox ID="Value2"
                    Columns="2"
                    MaxLength="3"
                    Text="1"
                    runat="server"/>

            </td>

            <td>

               =

            </td>

            <td>
               
               <asp:Label ID="AnswerMessage"
                    runat="server"/>

            </td>

         </tr>

         <tr>

            <td colspan="2">

               <asp:RequiredFieldValidator
                    ID="Value1RequiredValidator"
                    ControlToValidate="Value1"
                    ErrorMessage="Please enter a value.<br>"
                    Display="Dynamic"
                    runat="server"/>

               <asp:RangeValidator
                    ID="Value1RangeValidator"
                    ControlToValidate="Value1"
                    Type="Integer"
                    MinimumValue="1"
                    MaximumValue="100"
                    ErrorMessage="Please enter an integer <br> between than 1 and 100.<br>"
                    Display="Dynamic"
                    runat="server"/>

            </td>

            <td colspan="2">

               <asp:RequiredFieldValidator
                    ID="Value2RequiredValidator"
                    ControlToValidate="Value2"
                    ErrorMessage="Please enter a value.<br>"
                    Display="Dynamic"
                    runat="server"/>

               <asp:RangeValidator
                    ID="Value2RangeValidator"
                    ControlToValidate="Value2"
                    Type="Integer"
                    MinimumValue="1"
                    MaximumValue="100"
                    ErrorMessage="Please enter an integer <br> between than 1 and 100.<br>"
                    Display="Dynamic"
                    runat="server"/>

            </td>

            <td>

               &nbsp
 
            </td

         </tr>

         <tr align="center">

            <td colspan="4">

               <asp:Button ID="AddButton"
                    Text="Add"
                    OnClick="AddButton_Click"
                    runat="server"/>

            </td>

            <td>

               &nbsp;

            </td>

         </tr>

      </table>

   </form>

</body>
</html>

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.TextBox

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft