Partager via


Propriétés de base des contrôles serveur Web

Mise à jour : novembre 2007

Les propriétés répertoriées dans le tableau suivant s'appliquent à tous les contrôles serveur Web dérivés de la classe WebControl. Les contrôles serveur Web tels que Literal, PlaceHolder, Repeater et Xml n'héritent pas de la classe WebControl.

Propriétés

AccessKey

Clé du raccourci clavier du contrôle (AccessKey). Cette propriété définit une lettre ou un chiffre sur lequel l'utilisateur doit appuyer tout en appuyant sur la touche ALT. Par exemple, spécifiez "K" si l'utilisateur doit appuyer sur ALT+K pour accéder au contrôle. Les touches de raccourci clavier ne sont prises en charge que dans Microsoft Internet Explorer 4.0 et versions ultérieures.

Attributes

Collection d'attributs supplémentaires sur le contrôle non définis par une propriété Public, mais devant être également rendus. Tout attribut non défini par le contrôle serveur Web est ajouté à cette collection. Vous pouvez ainsi utiliser un attribut HTML non directement pris en charge par le contrôle.

Remarque :

Cette propriété ne peut être utilisée que lors de la programmation ; elle ne peut pas être définie pendant la déclaration du contrôle.

BackColor

Couleur d'arrière-plan du contrôle. La propriété BackColor peut être définie à l'aide des identificateurs de couleur HTML standard, à savoir le nom d'une couleur ("black" ou "red") ou une valeur RVB exprimée au format hexadécimal ("#ffffff").

BorderColor

Couleur de la bordure du contrôle. La propriété BorderColor peut être définie à l'aide des identificateurs de couleur HTML standard, à savoir le nom d'une couleur ("black" ou "red") ou une valeur RVB exprimée au format hexadécimal ("#ffffff").

BorderWidth

Largeur de la bordure éventuelle du contrôle, exprimée en pixels.

Remarque :

Il se peut que cette propriété ne fonctionne pas pour tous les contrôles avec les versions d'Internet Explorer antérieures à la version 4.0.

BorderStyle

Style de la bordure éventuelle du contrôle. Les valeurs possibles sont :

  • NotSet

  • None

  • Dotted

  • Dashed

  • Solid

  • Double

  • Groove

  • Ridge

  • Inset

  • Outset

CssClass

Classe de feuilles de style en cascade (CSS, Cascading Style Sheets) à assigner au contrôle.

Style

Collection d'attributs de texte rendus comme attributs de style CSS dans la balise externe du contrôle.

Remarque :

Des valeurs de style définies à l'aide des propriétés de style (par exemple, BackColor) se substituent automatiquement à une valeur correspondante de cette collection. Les valeurs définies à l'aide de cette propriété ne se réfléchissent pas automatiquement dans les propriétés de style fortement typées.

Certains contrôles prennent en charge les objets de style pour vous permettre d'appliquer les propriétés de style aux éléments individuels du contrôle. Ces propriétés se substituent aux paramètres définis à l'aide de la propriété Style.

Enabled

Rend le contrôle fonctionnel quand cette propriété a la valeur true (valeur par défaut). Désactive le contrôle lorsque cette propriété a la valeur false.

Remarque :

La désactivation d'un contrôle estompe ce dernier et le rend inactif. Elle ne masque pas le contrôle.

EnableTheming

Active la persistance de l'état d'affichage du contrôle lorsque cette propriété a la valeur true (valeur par défaut). Désactive la persistance de l'état d'affichage du contrôle lorsque cette propriété a la valeur false.

EnableViewState

Active des thèmes pour le contrôle lorsque cette propriété a la valeur true (valeur par défaut). Désactive les thèmes pour ce contrôle lorsque cette propriété a la valeur false.

Font

Fournit des informations de police pour le contrôle serveur Web que vous déclarez. Cette propriété inclut des sous-propriétés que vous pouvez déclarer à l'aide de la syntaxe propriété/sous-propriété dans la balise d'ouverture d'un élément du contrôle serveur Web. Par exemple, pour afficher le texte d'un contrôle serveur Web en caractères gras, incluez l'attribut Font-Bold dans sa balise d'ouverture.

ForeColor

Couleur de premier plan du contrôle.

Remarque :

Il se peut que cette propriété ne fonctionne pas pour tous les contrôles avec les versions d'Internet Explorer antérieures à la version 4.0.

Height

Hauteur du contrôle.

Remarque :

Il se peut que cette propriété ne fonctionne pas pour tous les contrôles avec les versions d'Internet Explorer antérieures à la version 4.0.

SkinID

Apparence à appliquer au contrôle.

TabIndex

Position du contrôle dans l'ordre de tabulation. Si cette propriété n'est pas définie, l'index de position du contrôle est 0. Les contrôles avec le même index de tabulation peuvent être tabulés en fonction de leur ordre de déclaration dans la page Web.

Remarque :

Cette propriété ne fonctionne que dans Internet Explorer 4.0 ou version ultérieure.

ToolTip

Texte qui apparaît lorsque l'utilisateur place le pointeur de la souris sur un contrôle.

Remarque :

La propriété ToolTip ne fonctionne pas dans tous les navigateurs. Vérifiez la compatibilité de votre navigateur avec cette propriété.

Width

Largeur fixe du contrôle. Les unités possibles sont :

  • Pixel (px)

  • Point (pt)

  • Pica (pc)

  • Pouce (po)

  • Mm (mm)

  • Cm (cm)

  • Pourcentage (%)

  • Em (em)

  • Ex (ex)

Par exemple, la définition de façon déclarative d'une largeur de 100 exprimée en points serait 100pt. Pour plus d'informations sur la définition par programme de la largeur, consultez Comment : définir les propriétés d'unité d'un contrôle serveur Web.

Remarque :

L'unité par défaut est le pixel. Certains types d'unité ne sont pas pris en charge par tous les navigateurs.

Voir aussi

Référence

System.Web.UI.WebControls

Autres ressources

Syntaxe des contrôles serveur Web