Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source
1 sur 1 ont trouvé cela utile - Évaluez ce sujet

Label, classe

Représente un contrôle web Label, qui affiche du texte sur une page Web.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
[ControlValuePropertyAttribute("Text")]
public class Label : WebControl, ITextControl
<asp:Label />

Le type Label expose les membres suivants.

  NomDescription
Méthode publiqueLabelInitialise une nouvelle instance de la classe Label.
Début
  NomDescription
Propriété publiqueAccessKeyObtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web. (Hérité de WebControl.)
Propriété protégéeAdapterObtient l'adaptateur spécifiques au navigateur pour le contrôle. (Hérité de Control.)
Propriété publiqueAppRelativeTemplateSourceDirectoryObtient ou définit le répertoire virtuel relatif à l'application de l'objet d' Page ou d' UserControl qui contient ce contrôle. (Hérité de Control.)
Propriété publiqueAssociatedControlIDObtient ou définit l'identificateur d'un contrôle serveur auquel le contrôle Label est associé.
Propriété publiqueAttributesObtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle. (Hérité de WebControl.)
Propriété publiqueBackColorObtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueBindingContainerInfrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété publiqueBorderColorObtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl.)
Propriété publiqueBorderStyleObtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueBorderWidthObtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl.)
Propriété protégéeChildControlsCreatedObtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
Propriété publiqueClientIDObtient l'ID du contrôle pour la balise HTML qui est générée par ASP.NET. (Hérité de Control.)
Propriété publiqueClientIDModeObtient ou définit l'algorithme utilisé pour générer la valeur de la propriété d' ClientID . (Hérité de Control.)
Propriété protégéeClientIDSeparatorObtient une valeur de caractères représentant le caractère de séparation utilisé dans la propriété d' ClientID . (Hérité de Control.)
Propriété protégéeContextObtient l'objet d' HttpContext associé au contrôle serveur pour la requête Web active. (Hérité de Control.)
Propriété publiqueControlsObtient un objet d' ControlCollection qui représente les contrôles enfants pour un contrôle serveur spécifié dans la hiérarchie d'interface utilisateur. (Hérité de Control.)
Propriété publiqueControlStyleObtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publiqueControlStyleCreatedObtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publiqueCssClassObtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl.)
Propriété publiqueDataItemContainerObtient une référence au conteneur d'attribution de noms si le conteneur d'attribution de noms implémente IDataItemContainer. (Hérité de Control.)
Propriété publiqueDataKeysContainerObtient une référence au conteneur d'attribution de noms si le conteneur d'attribution de noms implémente IDataKeysControl. (Hérité de Control.)
Propriété protégéeDesignModeObtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.)
Propriété publiqueEnabledObtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl.)
Propriété publiqueEnableThemingObtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl.)
Propriété publiqueEnableViewStateObtient ou définit une valeur indiquant si le contrôle serveur conserve son état d'affichage, et l'état d'affichage de tous les contrôles enfants qu'il contient, un client demandeur. (Hérité de Control.)
Propriété protégéeEventsObtient une liste des délégués de gestionnaire d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control.)
Propriété publiqueFontObtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueForeColorObtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueHasAttributesObtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl.)
Propriété protégéeHasChildViewStateObtient une valeur indiquant si les contrôles enfants actuels du contrôle serveur ont des paramètres enregistrés d'état d'affichage. (Hérité de Control.)
Propriété publiqueHeightObtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueIDObtient ou définit l'identificateur programmatique assigné au contrôle serveur. (Hérité de Control.)
Propriété protégéeIdSeparatorInfrastructure. Obtient le caractère utilisé pour séparer les ID de contrôle. (Hérité de Control.)
Propriété protégéeIsChildControlStateClearedObtient une valeur indiquant si les contrôles contenus dans le contrôle ont l'état du contrôle. (Hérité de Control.)
Propriété protégéeIsEnabledObtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl.)
Propriété protégéeIsTrackingViewStateObtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control.)
Propriété protégéeIsViewStateEnabledObtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
Propriété protégéeLoadViewStateByIDObtient une valeur indiquant si le contrôle participe au chargement son état d'affichage par ID au lieu de l'index. (Hérité de Control.)
Propriété publiqueNamingContainerObtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un seul espace de noms pour différencier des contrôles serveur avec la même valeur de propriété d' Control.ID . (Hérité de Control.)
Propriété publiquePageObtient une référence à l'instance d' Page qui contient le contrôle serveur. (Hérité de Control.)
Propriété publiqueParentObtient une référence au contrôle du parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control.)
Propriété publiqueRenderingCompatibilityObtient une valeur qui spécifie la version d'ASP.NET que le code HTML restitué sera compatible avec. (Hérité de Control.)
Propriété publiqueSiteObtient des informations sur le conteneur qui héberge le contrôle actuel lorsqu'il est affiché sur une aire de conception. (Hérité de Control.)
Propriété publiqueSkinIDObtient ou définit l'apparence à appliquer au contrôle. (Hérité de WebControl.)
Propriété publiqueStyleObtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueSupportsDisabledAttributeObtient une valeur qui indique si le contrôle doit affecter à l'attribut disabled de l'élément HTML rendu la valeur "disabled" lorsque la propriété IsEnabled du contrôle a la valeur false. (Substitue WebControl.SupportsDisabledAttribute.)
Propriété publiqueTabIndexObtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl.)
Propriété protégéeTagKeyObtient la balise HTML utilisée pour afficher le contrôle Label. (Substitue WebControl.TagKey.)
Propriété protégéeTagNameObtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Propriété publiqueTemplateControlObtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.)
Propriété publiqueTemplateSourceDirectoryObtient le répertoire virtuel d' Page ou d' UserControl qui contient le contrôle serveur actuel. (Hérité de Control.)
Propriété publiqueTextObtient ou définit le contenu du texte du contrôle Label.
Propriété publiqueToolTipObtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web. (Hérité de WebControl.)
Propriété publiqueUniqueIDObtient l'unique, de manière hiérarchique qualifié identificateur du contrôle serveur. (Hérité de Control.)
Propriété publiqueValidateRequestModeObtient ou définit une valeur qui indique si le contrôle vérifie l'entrée de client du navigateur pour les valeurs non sécurisées. (Hérité de Control.)
Propriété protégéeViewStateObtient un dictionnaire des informations d'état qui vous permettent d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur sur plusieurs demandes pour la même page. (Hérité de Control.)
Propriété protégéeViewStateIgnoresCaseObtient une valeur qui indique si l'objet d' StateBag ne respecte pas la casse. (Hérité de Control.)
Propriété publiqueViewStateModeObtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.)
Propriété publiqueVisibleObtient ou définit une valeur indiquant si un contrôle serveur est affichée comme interface utilisateur sur la page. (Hérité de Control.)
Propriété publiqueWidthObtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl.)
Début
  NomDescription
Méthode protégéeAddAttributesToRenderAjoute les attributs et les styles HTML d'un contrôle Label à rendre au flux de sortie spécifié. (Substitue WebControl.AddAttributesToRender(HtmlTextWriter).)
Méthode protégéeAddedControlAppelé après un contrôle enfant est ajouté à la collection d' Controls de l'objet d' Control . (Hérité de Control.)
Méthode protégéeAddParsedSubObjectAvertit le contrôle qu'un élément a été analysé et ajoute l'élément au contrôle Label. (Substitue Control.AddParsedSubObject(Object).)
Méthode publiqueApplyStyleCopie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode publiqueApplyStyleSheetSkinApplique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control.)
Méthode protégéeBeginRenderTracingDémarre le suivi au moment de le design des données de rendu. (Hérité de Control.)
Méthode protégéeBuildProfileTreeInfrastructure. Rassemble des informations à propos de le contrôle serveur et les fournit à la propriété d' Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control.)
Méthode protégéeClearCachedClientIDInfrastructure. Définit la valeur mise en cache d' ClientID à null. (Hérité de Control.)
Méthode protégéeClearChildControlStateSupprime les informations sur l'état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildStateSupprime l'état d'affichage et les informations sur l'état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildViewStateSupprime les informations d'état d'affichage pour des contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearEffectiveClientIDModeInfrastructure. Définit la propriété d' ClientIDMode de l'instance de contrôle actuelle et de tous les contrôles enfants à Inherit. (Hérité de Control.)
Méthode publiqueCopyBaseAttributesCopie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégéeCreateChildControlsAppelé par l'infrastructure de page ASP.NET. pour informer les contrôles serveur qu'implémentation composition-basée par utilisation de pour créer tous contrôles enfants qu'ils contiennent pendant la vice versa ou du rendu de publication. (Hérité de Control.)
Méthode protégéeCreateControlCollectionCrée un nouvel objet d' ControlCollection pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur. (Hérité de Control.)
Méthode protégéeCreateControlStyleCrée l'objet de style qui est utilisé de manière interne par la classe WebControl pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode publiqueDataBind()Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control.)
Méthode protégéeDataBind(Boolean)Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants avec une option de déclencher l'événement d' DataBinding . (Hérité de Control.)
Méthode protégéeDataBindChildrenLie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode publiqueDisposePermet à un contrôle serveur pour effectuer la dernière nettoyer avant d'être libérée de la mémoire. (Hérité de Control.)
Méthode protégéeEndRenderTracingTermine le traçage au moment de le design des données de rendu. (Hérité de Control.)
Méthode protégéeEnsureChildControlsDétermine si le contrôle serveur contient des contrôles enfants. Dans le cas contraire, il crée des contrôles enfants. (Hérité de Control.)
Méthode protégéeEnsureIDCrée un identificateur pour les contrôles qui n'ont pas un identificateur assigné. (Hérité de Control.)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueFindControl(String)Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec le paramètre spécifié d' id . (Hérité de Control.)
Méthode protégéeFindControl(String, Int32)Infrastructure. Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec id spécifié et un entier, spécifié dans le paramètre d' pathOffset , ce qui simplifie la recherche. Vous ne devez pas substituer cette version de la méthode d' FindControl . (Hérité de Control.)
Méthode publiqueFocusDéfinit le focus d'entrée à un contrôle. (Hérité de Control.)
Méthode protégéeGetDesignModeStateInfrastructure. Obtient des données au moment de le design pour un contrôle. (Hérité de Control.)
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetRouteUrl(Object)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(RouteValueDictionary)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(String, Object)Obtient l'URL qui correspond à un jeu de paramètres de routage et d'un nom d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(String, RouteValueDictionary)Obtient l'URL qui correspond à un jeu de paramètres de routage et d'un nom d'itinéraire. (Hérité de Control.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetUniqueIDRelativeToRetourne la partie préfixée de la propriété d' UniqueID du contrôle spécifié. (Hérité de Control.)
Méthode publiqueHasControlsDétermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.)
Méthode protégéeHasEventsRetourne une valeur indiquant si les événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.)
Méthode protégéeIsLiteralContentInfrastructure. Détermine si le contrôle serveur contient uniquement le contenu littéral. (Hérité de Control.)
Méthode protégéeLoadControlStateRestaure les informations sur l'état du contrôle d'une demande de page précédente qui a été signalée par la méthode d' SaveControlState . (Hérité de Control.)
Méthode protégéeLoadViewStateCharge l'état précédemment enregistré du contrôle. (Substitue WebControl.LoadViewState(Object).)
Méthode protégéeMapPathSecureRécupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, tables. (Hérité de Control.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiqueMergeStyleCopie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégéeOnBubbleEventDétermine si l'événement du contrôle serveur est passé en haut de la hiérarchie de contrôle de l'interface utilisateur de la page. (Hérité de Control.)
Méthode protégéeOnDataBindingDéclenche l'événement d' DataBinding . (Hérité de Control.)
Méthode protégéeOnInitDéclenche l'événement d' Init . (Hérité de Control.)
Méthode protégéeOnLoadDéclenche l'événement d' Load . (Hérité de Control.)
Méthode protégéeOnPreRenderDéclenche l'événement d' PreRender . (Hérité de Control.)
Méthode protégéeOnUnloadDéclenche l'événement d' Unload . (Hérité de Control.)
Méthode protégéeOpenFileObtient Stream utilisé pour lire un fichier. (Hérité de Control.)
Méthode protégéeRaiseBubbleEventAssigne toutes les sources d'événement et ses informations au parent du contrôle. (Hérité de Control.)
Méthode protégéeRemovedControlAppelé après un contrôle enfant est supprimé de la collection d' Controls de l'objet d' Control . (Hérité de Control.)
Méthode protégéeRenderGénère le rendu du contrôle via le writer HTML spécifié. (Hérité de WebControl.)
Méthode publiqueRenderBeginTagGénère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégéeRenderChildrenRenvoie le contenu des enfants d'un contrôle serveur à un objet fourni d' HtmlTextWriter , qui écrit le contenu à afficher sur le client. (Hérité de Control.)
Méthode protégéeRenderContentsInfrastructure. Génère le rendu du contenu de Label via le writer spécifié. (Substitue WebControl.RenderContents(HtmlTextWriter).)
Méthode publiqueRenderControl(HtmlTextWriter)Renvoie le contenu de contrôle serveur à un objet fourni d' HtmlTextWriter et stocke les informations de traçage sur le contrôle s'il est activé. (Hérité de Control.)
Méthode protégéeRenderControl(HtmlTextWriter, ControlAdapter)Renvoie le contenu de contrôle serveur à un objet fourni d' HtmlTextWriter à l'aide d'un objet fourni d' ControlAdapter . (Hérité de Control.)
Méthode publiqueRenderEndTagGénère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.)
Méthode protégéeResolveAdapterObtient l'adaptateur de contrôle responsable de l'affichage du contrôle spécifié. (Hérité de Control.)
Méthode publiqueResolveClientUrlObtient une URL qui peut être utilisé par le navigateur. (Hérité de Control.)
Méthode publiqueResolveUrlConvertit une URL dans un utilisable sur le client demandeur. (Hérité de Control.)
Méthode protégéeSaveControlStateEnregistre toutes les modifications d'état de contrôle serveur qui se sont produites étant donné que le temps que la page a été publiée sur le serveur. (Hérité de Control.)
Méthode protégéeSaveViewStateEnregistre les états modifiés après l'appel de la méthode TrackViewState. (Hérité de WebControl.)
Méthode protégéeSetDesignModeStateDéfinit les données au moment de le design pour un contrôle. (Hérité de Control.)
Méthode publiqueSetRenderMethodDelegateInfrastructure. Affecte un délégué de gestionnaire d'événements pour afficher le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control.)
Méthode publiqueSetTraceData(Object, Object)Définit les données de traçage pour le suivi au moment de le design des données de rendu, à l'aide de la clé de données de trace et la valeur des données de trace. (Hérité de Control.)
Méthode publiqueSetTraceData(Object, Object, Object)Définit les données de traçage pour le suivi au moment de le design des données de rendu, à l'aide de l'objet d'un suivi, la clé de données de traçage, et la valeur des données de trace. (Hérité de Control.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode protégéeTrackViewStateAmène le contrôle à suivre les modifications apportées à son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState de l'objet. (Hérité de WebControl.)
Début
  NomDescription
Événement publicDataBindingSe produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
Événement publicDisposedSe produit lorsqu'un contrôle serveur est récupéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle serveur où une page ASP.NET. est demandée. (Hérité de Control.)
Événement publicInitSe produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control.)
Événement publicLoadSe produit lorsque le contrôle serveur est chargé dans l'objet d' Page . (Hérité de Control.)
Événement publicPreRenderSe produit une fois que l'objet d' Control soit chargé mais avant le rendu. (Hérité de Control.)
Événement publicUnloadSe produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.)
Début
  NomDescription
Méthode d'extension publiqueFindDataSourceControlRetourne la source de données associée au contrôle de données pour le contrôle spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueFindFieldTemplateRetourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueFindMetaTableRetourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)
Début
  NomDescription
Implémentation d'interface expliciteMéthode privéeIAttributeAccessor.GetAttributeInfrastructure. Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl.)
Implémentation d'interface expliciteMéthode privéeIAttributeAccessor.SetAttributeAffecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl.)
Implémentation d'interface explicitePropriété privéeIControlBuilderAccessor.ControlBuilderPour obtenir une description de ce membre, consultez l' IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.GetDesignModeStatePour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetDesignModeStatePour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetOwnerControlInfrastructure. Pour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIControlDesignerAccessor.UserDataPour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.UserData. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.DataBindingsPour obtenir une description de ce membre, consultez l' IDataBindingsAccessor.DataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.HasDataBindingsPour obtenir une description de ce membre, consultez l' IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.ExpressionsPour obtenir une description de ce membre, consultez l' IExpressionsAccessor.Expressions. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.HasExpressionsPour obtenir une description de ce membre, consultez l' IExpressionsAccessor.HasExpressions. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIParserAccessor.AddParsedSubObjectPour obtenir une description de ce membre, consultez l' IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Début

Dans cette rubrique :

Introduction

Utilisez le contrôle Label pour afficher du texte dans un emplacement défini sur la page. Contrairement à du texte statique, vous pouvez personnaliser le texte affiché via la propriété Text.

Vous pouvez aussi utiliser les contrôles Literal et PlaceHolder pour afficher du texte sur la page Web Forms. Cependant, contrairement au contrôle Label, ces contrôles ne rendent pas de balises supplémentaires.

Note de sécuritéNote de sécurité

Ce contrôle permet d'afficher une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Script Exploits Overview.

Accessibilité

Pour plus d'informations sur la configuration de ce contrôle afin qu'il génère des balises conforment aux standards d'accessibilité, consultez Accessibility in Visual Studio 2010 and ASP.NET 4 et ASP.NET Controls and Accessibility.

Syntaxe déclarative

<asp:Label
    AccessKey="string"
    AssociatedControlID="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    ToolTip="string"
    Visible="True|False"
    Width="size"
/>
TopicLocation
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
Comment : créer dynamiquement des modèles dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET
Procédure pas à pas : création d'un Concepteur de contrôles de base pour un contrôle serveur Web ASP.NETCréation de contrôles ASP.NET
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET
Comment : personnaliser des journées dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET
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 : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web Label à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une application Web accessibleGénération d'applications Web ASP.NET dans Visual Studio
Comment : utiliser des contrôles serveur Web Label en tant que légendesGénération d'applications Web ASP.NET
Comment : ajouter des contrôles serveur Web Label à une page Web FormsGénération d'applications Web ASP.NET
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 d'une page Web de base avec la séparation de code dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : personnalisation d'un site Web à l'aide de thèmes dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un Concepteur de contrôles de base pour un contrôle serveur WebGé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
Comment : créer dynamiquement des modèles dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGé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 à l'aide de Visual Web Developer
Comment : personnaliser des journées dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET dans Visual Studio
Comment : utiliser des contrôles serveur Web Label en tant que légendesGé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
Procédure pas à pas : création d'une page Web de base avec la séparation de code dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : personnalisation d'un site Web à l'aide de thèmes dans Visual StudioGénération d'applications à l'aide de Visual Web Developer
Comment : ajouter des contrôles serveur Web Label à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une application Web accessibleGénération d'applications à l'aide de Visual Web Developer

L'exemple suivant illustre la création d'un contrôle Label sur une page Web.

RemarqueRemarque

L'exemple de code suivant utilise un modèle de code de fichier unique ; il est possible qu'il ne fonctionne pas correctement s'il est directement copié dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide doté d'une extension .aspx. Pour plus d'informations sur le modèle de code de page Web ASP.NET, consultez ASP.NET Web Page Code Model.

Note de sécuritéNote de sécurité

Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Script Exploits Overview.


<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Label Example</title>
<script language="C#" runat="server">

      void Button_Click(Object Sender, EventArgs e) 
      {
         Label1.Text = Server.HtmlEncode(Text1.Text);
      }

   </script>

</head>

<body>

   <form id="Form1" runat="server">

      <h3>Label Example</h3>

      <asp:Label id="Label1" 
                 Text="Label Control" 
                 runat="server"/>

      <p>

      <asp:TextBox id="Text1" 
           Text="Copy this text to the label"
           Width="200px"  
           runat="server" />

      <asp:Button id="Button1" 
           Text="Copy" 
           OnClick="Button_Click" 
           runat="server"/>
      </p>

   </form>

</body>
</html>



.NET Framework

Pris en charge dans : 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)

Ajouts de la communauté

AJOUTER
© 2013 Microsoft. Tous droits réservés.