Partager via


Propriétés partagées des contrôles HTML

En tant que partie intégrante du .NET Framework, ASP.NET offre des fonctionnalités d'héritage sur les espaces de noms et sur les classes. Il existe deux sous-ensembles de contrôles HTML qui partagent des propriétés de différentes classes de base. Ces sous-ensembles sont appelés contrôles conteneur et contrôles d'entrées.

Tout attribut déclaré sur un contrôle HTML est ajouté à la collection Attributes du contrôle et peut être manipulé par programme, exactement comme une propriété. Si, par exemple, vous déclarez un attribut bgcolor dans un élément <body>, vous pouvez accéder par programme à l'attribut et écrire des gestionnaires d'événements qui vous permettront de changer sa valeur.

Propriétés partagées par tous les contrôles HTML

Attributes

Obtient toutes les paires nom/valeur des attributs exprimées dans une balise de contrôle serveur au sein d'une page ASP.NET sélectionnée.

RemarqueRemarque
Dans les contrôles serveur HTML, la manipulation de la collection Attributes est identique à celle de la propriété Control.ViewState.

Disabled

Obtient ou définit une valeur indiquant si l'attribut disabled est inclus lors du rendu d'un contrôle HTML dans le navigateur. Si cet attribut est inclus, le contrôle passe en lecture seule.

Style

Obtient toutes les propriétés des feuilles de style en cascade (CSS, Cascading Style Sheet) qui sont appliquées à un contrôle serveur HTML spécifié dans un fichier .aspx.

TagName

Obtient le nom d'élément d'une balise qui contient un attribut runat="server".

Visible

Obtient ou définit une valeur qui indique si le contrôle serveur HTML est affiché sur la page.

Propriétés partagées par tous les contrôles d'entrée HTML

Les contrôles d'entrée HTML sont similaires aux éléments d'entrée HTML standard. Ils incluent un attribut type qui définit le type du contrôle d'entrée rendu sur une page Web.

Les contrôles HtmlInputText, HtmlInputPassword, HtmlInputButton, HtmlInputSubmit, HtmlInputReset, HtmlInputCheckBox, HtmlInputImage, HtmlInputHidden, HtmlInputFile et HtmlInputRadioButton partagent les propriétés suivantes.

Name

Obtient ou définit un nom d'identificateur unique du contrôle HtmlInputControl.

Value

Obtient ou définit la valeur associée à un contrôle d'entrée.

RemarqueRemarque
La valeur associée à un contrôle dépend du contexte de ce contrôle.Par exemple, dans les contrôles permettant d'entrer du texte, tels que le contrôle HtmlInputText, la valeur est le texte entré dans le contrôle.Dans les contrôles qui n'autorisent pas l'entrée de texte, tels que le contrôle HtmlInputButton, la valeur est la légende affichée dans le contrôle.Reportez-vous au contrôle spécifique pour en savoir plus sur le contexte de la propriété Value.

Type

Obtient le type d'un contrôle HtmlInputControl. Par exemple, si cette propriété a la valeur text, le contrôle HtmlInputControl est une zone de texte destinée à l'entrée de données.

Propriétés partagées par tous les contrôles conteneur HTML

Les contrôles conteneur HTML sont mappés à des éléments HTML qui exigent une balise d'ouverture et de fermeture, par exemple les éléments <select>, <a>, <button> et <form>.

Les contrôles HtmlTableCell, HtmlTable, HtmlTableRow, HtmlButton, HtmlForm, HtmlAnchor, HtmlGenericControl, HtmlSelect et HtmlTextArea partagent les propriétés suivantes.

InnerHtml

Obtient ou définit le contenu situé entre les balises d'ouverture et de fermeture du contrôle HTML spécifié. La propriété InnerHtml ne convertit pas automatiquement des caractères spéciaux en entités HTML. Ainsi, le signe inférieur à (<) n'est pas converti en &lt;. Cette propriété est généralement utilisée pour incorporer des éléments HTML dans le contrôle conteneur.

InnerText

Obtient ou définit tout texte situé entre les balises d'ouverture et de fermeture du contrôle HTML spécifié. Contrairement à la propriété InnerHtml, la propriété InnerText convertit automatiquement des caractères spéciaux en entités HTML. Ainsi, le signe inférieur à (<) est converti en &lt;. Cette propriété est généralement utilisée lorsque vous souhaitez afficher du texte comportant des caractères spéciaux, sans spécifier l'entité HTML.

Voir aussi

Référence

HtmlInputControl

HtmlContainerControl

HtmlControl

Autres ressources

Contrôles serveur HTML