BulletedList Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée un contrôle qui génère une liste d’éléments dans un format à puces.
public ref class BulletedList : System::Web::UI::WebControls::ListControl, System::Web::UI::IPostBackEventHandlerpublic class BulletedList : System.Web.UI.WebControls.ListControl, System.Web.UI.IPostBackEventHandlertype BulletedList = class
inherit ListControl
interface IPostBackEventHandlerPublic Class BulletedList
Inherits ListControl
Implements IPostBackEventHandler- Héritage
- Implémente
Exemples
Cette section contient deux exemples de code. Le premier exemple de code montre comment créer un contrôle BulletedList avec des éléments de liste mis en forme en tant que boutons de lien. Le deuxième exemple de code montre comment créer un contrôle BulletedList à l’aide de la liaison de données pour spécifier les éléments de liste.
L’exemple de code suivant montre comment créer un contrôle BulletedList avec des éléments de liste mis en forme en tant que boutons de lien. Le texte s’affiche dans un contrôle Label lorsqu’un élément de liste est cliqué.
<%@ Page Language="C#" %>
<!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 runat="server">
<title>BulletedList Click Example</title>
<script runat="server">
void ItemsBulletedList_Click(object sender, System.Web.UI.WebControls.BulletedListEventArgs e)
{
// Change the message displayed in the label based on the index
// of the list item that was clicked.
switch (e.Index)
{
case 0:
Message.Text = "You clicked list item 1.";
break;
case 1:
Message.Text = "You clicked list item 2.";
break;
case 2:
Message.Text = "You clicked list item 3.";
break;
default:
throw new Exception("You did not click a valid list item.");
break;
}
}
</script>
</head>
<body>
<h3>BulletedList Click Example</h3>
<form id="form1" runat="server">
<p>Click on an item in the list to raise the Click event.</p>
<asp:BulletedList id="ItemsBulletedList"
BulletStyle="Disc"
DisplayMode="LinkButton"
OnClick="ItemsBulletedList_Click"
runat="server">
<asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
<asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
</asp:BulletedList>
<asp:Label id="Message"
Font-Size="12"
Width="168px"
Font-Bold="True"
runat="server"
AssociatedControlID="ItemsBulletedList"/>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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 runat="server">
<title>BulletedList Click Example</title>
<script runat="server">
Sub ItemsBulletedList_Click(ByVal sender As Object, _
ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
' Change the message displayed in the label based on the index
' of the list item that was clicked.
Select Case (e.Index)
Case 0
Message.Text = "You clicked list item 1."
Case 1
Message.Text = "You clicked list item 2."
Case 2
Message.Text = "You clicked list item 3."
Case Else
Throw New Exception("You did not click a valid list item.")
End Select
End Sub
</script>
</head>
<body>
<h3>BulletedList Click Example</h3>
<form id="form1" runat="server">
<p>Click on an item in the list to raise the Click event.</p>
<asp:BulletedList id="ItemsBulletedList"
BulletStyle="Disc"
DisplayMode="LinkButton"
OnClick="ItemsBulletedList_Click"
runat="server">
<asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
<asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
</asp:BulletedList>
<asp:Label id="Message"
Font-Size="12"
Width="168px"
Font-Bold="True"
runat="server"
AssociatedControlID="ItemsBulletedList"/>
</form>
</body>
</html>
L’exemple de code suivant montre comment créer un contrôle BulletedList à l’aide de la liaison de données pour spécifier les éléments de liste. Les éléments de liste sont mis en forme en tant que boutons de lien. Le texte s’affiche dans un contrôle Label lorsqu’un élément de liste est cliqué.
<%@ Page Language="C#" %>
<!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 runat="server">
<title>BulletedList Class Data Binding Example</title>
<script runat="server">
void ProductsBulletedList_Click(object sender,
System.Web.UI.WebControls.BulletedListEventArgs e)
{
// Change the message displayed in the label based on the index
// of the list item that was clicked.
switch (e.Index)
{
case 0:
Message.Text = "Product 1 was clicked";
break;
case 1:
Message.Text = "Product 2 was clicked";
break;
case 2:
Message.Text = "Product 3 was clicked";
break;
case 3:
Message.Text = "Product 4 was clicked";
break;
default:
throw new Exception("You must click a valid list item.");
break;
}
}
</script>
</head>
<body>
<h3>BulletedList Class Data Binding Example</h3>
<form id="form1" runat="server">
<p>Click on an item in the list.</p>
<asp:BulletedList id="ProductsBulletedList"
BulletStyle="Disc"
DisplayMode="LinkButton"
DataTextField="ProductName"
DataSourceID="SqlDataSource1"
OnClick="ProductsBulletedList_Click"
runat="server">
</asp:BulletedList>
<asp:SqlDataSource id="SqlDataSource1"
ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
runat="server"
SelectCommand="SELECT * FROM [Products] Where ProductID < 5">
</asp:SqlDataSource>
<asp:Label id="Message"
Font-Size="12"
Width="168px"
Font-Bold="True"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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 runat="server">
<title>BulletedList Class Data Binding Example</title>
<script runat="server">
Sub ProductsBulletedList_Click(ByVal sender As Object, _
ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
' Change the message displayed in the label based on the index
' of the list item that was clicked.
Select Case (e.Index)
Case 0
Message.Text = "Product 1 was clicked"
Case 1
Message.Text = "Product 2 was clicked"
Case 2
Message.Text = "Product 3 was clicked"
Case 3
Message.Text = "Product 4 was clicked"
Case Else
Throw New Exception("You must click a valid list item.")
End Select
End Sub
</script>
</head>
<body>
<h3>BulletedList Class Data Binding Example</h3>
<form id="form1" runat="server">
<p>Click on an item in the list.</p>
<asp:BulletedList id="ProductsBulletedList"
BulletStyle="Disc"
DisplayMode="LinkButton"
DataTextField="ProductName"
DataSourceID="SqlDataSource1"
OnClick="ProductsBulletedList_Click"
runat="server">
</asp:BulletedList>
<asp:SqlDataSource id="SqlDataSource1"
ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
runat="server"
SelectCommand="SELECT * FROM [Products] Where ProductID < 5">
</asp:SqlDataSource>
<asp:Label id="Message"
Font-Size="12"
Width="168px"
Font-Bold="True"
runat="server"/>
</form>
</body>
</html>
Remarques
Dans cette rubrique :
Introduction
Utilisez le contrôle BulletedList pour créer une liste d’éléments mis en forme avec des puces. Pour spécifier les éléments de liste individuels que vous souhaitez afficher dans un contrôle BulletedList, placez un objet ListItem pour chaque entrée entre les balises d’ouverture et de fermeture du contrôle BulletedList.
Pour spécifier le type de puce à utiliser pour afficher les éléments de liste dans un contrôle BulletedList, définissez la propriété BulletStyle sur l’un des types de puces définis par l’énumération BulletStyle. Le tableau suivant répertorie les styles de puces disponibles.
| Style de puce | Description |
|---|---|
| NotSet | Pas défini. |
| Numbered | Nombre. |
| LowerAlpha | Lettre minuscule. |
| UpperAlpha | Lettre majuscule. |
| LowerRoman | Chiffres romains minuscules. |
| UpperRoman | Chiffres romains majuscules. |
| Disc | Un cercle rempli. |
| Circle | Cercle vide. |
| Square | Un carré rempli. |
| CustomImage | Image personnalisée. |
Utilisez la propriété FirstBulletNumber pour spécifier la valeur qui démarre la numérotation des éléments de liste dans un contrôle BulletedList ordonné. La valeur affectée à la propriété FirstBulletNumber est ignorée si la propriété BulletStyle est définie sur le champ Disc, Square, Circleou CustomImage. Si vous définissez la propriété BulletStyle sur la valeur de CustomImage pour spécifier une image personnalisée pour la puce, vous devez également définir la propriété BulletImageUrl pour spécifier l’emplacement du fichier image.
Pour spécifier le comportement d’affichage des éléments de liste dans un BulletedList, définissez la propriété DisplayMode sur l’une des valeurs définies par l’énumération BulletedListDisplayMode. Les comportements d’affichage définis sont Text, HyperLinket LinkButton.
Lorsqu’un lien hypertexte est cliqué, il accède à une URL. Utilisez la propriété Value pour spécifier l’URL vers laquelle un lien hypertexte accède. Utilisez la propriété Target pour spécifier le cadre ou la fenêtre qui affiche la page Web qui est redirigée lorsqu’un lien hypertexte est cliqué.
Lorsque la propriété DisplayMode est définie sur LinkButton, le contrôle BulletedList affiche les éléments de liste sous forme de liens qui sont renvoyés au serveur lorsque vous cliquez dessus. Pour contrôler par programmation les actions effectuées lorsqu’un bouton de lien est cliqué, fournissez un gestionnaire d’événements pour l’événement Click. Notez que les propriétés SelectedIndex et SelectedItem sont héritées de la classe ListControl et ne sont pas applicables au contrôle BulletedList. Utilisez les données d’événement de la classe BulletedListEventArgs pour déterminer l’index du bouton de lien dans un BulletedList qui a été cliqué.
Le contrôle BulletedList prend également en charge la liaison de données. Pour lier la BulletedList à une source de données, vous pouvez utiliser l’un des mécanismes de liaison de données fournis. Pour plus d’informations, consultez liaison à des bases de données.
Accessibilité
Le balisage rendu par défaut pour ce contrôle peut ne pas être conforme aux normes d’accessibilité telles que les instructions de priorité 1.0 (WCAG) de la priorité 1 du contenu web. Pour plus d’informations sur la prise en charge de l’accessibilité pour ce contrôle, consultez ASP.NET Contrôles etd’accessibilité.
Syntaxe déclarative
<asp:BulletedList
AccessKey="string"
AppendDataBoundItems="True|False"
AutoPostBack="True|False"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
BulletImageUrl="uri"
BulletStyle="NotSet|Numbered|LowerAlpha|UpperAlpha|LowerRoman|
UpperRoman|Disc|Circle|Square|CustomImage"
CausesValidation="True|False"
CssClass="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
DataTextField="string"
DataTextFormatString="string"
DataValueField="string"
DisplayMode="Text|HyperLink|LinkButton"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
FirstBulletNumber="integer"
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"
OnClick="Click event handler"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnTextChanged="TextChanged event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Target="string|_blank|_parent|_search|_self|_top"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
>
<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="string"
Value="string"
/>
</asp:BulletedList>
Constructeurs
| BulletedList() |
Initialise une nouvelle instance de la classe BulletedList. |
Propriétés
| AccessKey |
Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au contrôle serveur Web. (Hérité de WebControl) |
| Adapter |
Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
| AppendDataBoundItems |
Obtient ou définit une valeur qui indique si les éléments de liste sont effacés avant la liaison de données. (Hérité de ListControl) |
| AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l’application de l’objet Page ou UserControl qui contient ce contrôle. (Hérité de Control) |
| Attributes |
Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux propriétés du contrôle. (Hérité de WebControl) |
| AutoPostBack |
Obtient ou définit la valeur de la propriété AutoPostBack pour la classe de base. |
| BackColor |
Obtient ou définit la couleur d’arrière-plan du contrôle serveur Web. (Hérité de WebControl) |
| BindingContainer |
Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control) |
| BorderColor |
Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl) |
| BorderStyle |
Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl) |
| BorderWidth |
Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl) |
| BulletImageUrl |
Obtient ou définit le chemin d’accès à une image à afficher pour chaque puce d’un contrôle BulletedList. |
| BulletStyle |
Obtient ou définit le style de puce du contrôle BulletedList. |
| CausesValidation |
Obtient ou définit une valeur indiquant si la validation est effectuée lorsqu’un contrôle dérivé de la classe ListControl est cliqué. (Hérité de ListControl) |
| ChildControlsCreated |
Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
| ClientID |
Obtient l’ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control) |
| ClientIDMode |
Obtient ou définit l’algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control) |
| ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la propriété ClientID. (Hérité de Control) |
| Context |
Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control) |
| Controls |
Obtient une collection ControlCollection pour le contrôle. |
| ControlStyle |
Obtient le style du contrôle serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ControlStyleCreated |
Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| CssClass |
Obtient ou définit la classe Feuille de style en cascade (CSS) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl) |
| DataItemContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de noms implémente IDataItemContainer. (Hérité de Control) |
| DataKeysContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de noms implémente IDataKeysControl. (Hérité de Control) |
| DataMember |
Obtient ou définit la table spécifique dans le DataSource à lier au contrôle. (Hérité de ListControl) |
| DataSource |
Obtient ou définit la source de données qui remplit les éléments du contrôle de liste. (Hérité de ListControl) |
| DataSourceID |
Obtient ou définit l’ID du contrôle à partir duquel le contrôle lié aux données récupère sa liste d’éléments de données. (Hérité de DataBoundControl) |
| DataSourceObject |
Obtient un objet qui implémente l’interface IDataSource, qui fournit l’accès au contenu des données de l’objet. (Hérité de DataBoundControl) |
| DataTextField |
Obtient ou définit le champ de la source de données qui fournit le contenu texte des éléments de liste. (Hérité de ListControl) |
| DataTextFormatString |
Obtient ou définit la chaîne de mise en forme utilisée pour contrôler l’affichage des données liées au contrôle de liste. (Hérité de ListControl) |
| DataValueField |
Obtient ou définit le champ de la source de données qui fournit la valeur de chaque élément de liste. (Hérité de ListControl) |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control) |
| DisplayMode |
Obtient ou définit le mode d’affichage du contenu de liste dans un contrôle BulletedList. |
| Enabled |
Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl) |
| EnableTheming |
Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle. (Hérité de WebControl) |
| EnableViewState |
Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage et l’état d’affichage des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
| Events |
Obtient une liste de délégués de gestionnaire d’événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control) |
| FirstBulletNumber |
Obtient ou définit la valeur qui démarre la numérotation des éléments de liste dans un contrôle BulletedList ordonné. |
| Font |
Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl) |
| ForeColor |
Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl) |
| HasAttributes |
Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl) |
| HasChildViewState |
Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control) |
| Height |
Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl) |
| ID |
Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control) |
| IdSeparator |
Obtient le caractère utilisé pour séparer les identificateurs de contrôle. (Hérité de Control) |
| Initialized |
Obtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl) |
| IsBoundUsingDataSourceID |
Obtient une valeur indiquant si la propriété DataSourceID est définie. (Hérité de BaseDataBoundControl) |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle. (Hérité de Control) |
| IsDataBindingAutomatic |
Obtient une valeur qui indique si la liaison de données est automatique. (Hérité de BaseDataBoundControl) |
| IsEnabled |
Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl) |
| IsTrackingViewState |
Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage. (Hérité de Control) |
| IsUsingModelBinders |
Obtient une valeur qui indique si la liaison de modèle est en cours d’utilisation. (Hérité de DataBoundControl) |
| IsViewStateEnabled |
Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle. (Hérité de Control) |
| Items |
Obtient la collection d’éléments dans le contrôle de liste. (Hérité de ListControl) |
| ItemType |
Obtient ou définit le nom du type d’élément de données pour la liaison de données fortement typée. (Hérité de DataBoundControl) |
| LoadViewStateByID |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage par ID au lieu de l’index. (Hérité de Control) |
| NamingContainer |
Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur avec la même valeur de propriété ID. (Hérité de Control) |
| Page |
Obtient une référence à l’instance Page qui contient le contrôle serveur. (Hérité de Control) |
| Parent |
Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de page. (Hérité de Control) |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control) |
| RenderWhenDataEmpty |
Obtient ou définit une valeur qui indique si le contrôle est rendu si la source de données n’a pas de données ou si le contrôle n’est pas lié aux données. |
| RequiresDataBinding |
Obtient ou définit une valeur indiquant si la méthode DataBind() doit être appelée. (Hérité de BaseDataBoundControl) |
| SelectArguments |
Obtient un objet DataSourceSelectArguments que le contrôle lié aux données utilise lors de la récupération de données à partir d’un contrôle de source de données. (Hérité de DataBoundControl) |
| SelectedIndex |
Obtient ou définit l’index de base zéro de l’élément actuellement sélectionné dans un contrôle BulletedList. |
| SelectedItem |
Obtient l’élément actuellement sélectionné dans un contrôle BulletedList. |
| SelectedValue |
Obtient ou définit la propriété Value de l’objet ListItem sélectionné dans le contrôle BulletedList. |
| SelectMethod |
Nom de la méthode à appeler pour lire les données. (Hérité de DataBoundControl) |
| Site |
Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control) |
| SkinID |
Obtient ou définit la peau à appliquer au contrôle. (Hérité de WebControl) |
| Style |
Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du contrôle serveur Web. (Hérité de WebControl) |
| SupportsDisabledAttribute |
Obtient une valeur qui indique si le contrôle doit définir l’attribut |
| TabIndex |
Obtient ou définit l’index de tabulation du contrôle serveur Web. (Hérité de WebControl) |
| TagKey |
Obtient la valeur HtmlTextWriterTag du contrôle BulletedList spécifié. |
| TagName |
Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| Target |
Obtient ou définit la fenêtre ou le cadre cible dans lequel afficher le contenu de la page Web lié lorsqu’un lien hypertexte dans un contrôle BulletedList est cliqué. |
| TemplateControl |
Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control) |
| TemplateSourceDirectory |
Obtient le répertoire virtuel du Page ou UserControl qui contient le contrôle serveur actuel. (Hérité de Control) |
| Text |
Obtient ou définit le texte du contrôle BulletedList. |
| ToolTip |
Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web. (Hérité de WebControl) |
| UniqueID |
Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur. (Hérité de Control) |
| ValidateRequestMode |
Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses. (Hérité de Control) |
| ValidationGroup |
Obtient ou définit le groupe de contrôles pour lesquels le contrôle dérivé de la classe ListControl provoque la validation lorsqu’elle est renvoyée au serveur. (Hérité de ListControl) |
| ViewState |
Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un contrôle serveur sur plusieurs requêtes pour la même page. (Hérité de Control) |
| ViewStateIgnoresCase |
Obtient une valeur qui indique si l’objet StateBag ne respecte pas la casse. (Hérité de Control) |
| ViewStateMode |
Obtient ou définit le mode d’état d’affichage de ce contrôle. (Hérité de Control) |
| Visible |
Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page. (Hérité de Control) |
| Width |
Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl) |
Méthodes
| AddAttributesToRender(HtmlTextWriter) |
Ajoute les attributs html et les styles d’un contrôle BulletedList à afficher sur l’objet HtmlTextWriter spécifié. |
| AddedControl(Control, Int32) |
Appelé après l’ajout d’un contrôle enfant à la collection Controls de l’objet Control. (Hérité de Control) |
| AddParsedSubObject(Object) |
Avertit le contrôle serveur qu’un élément, XML ou HTML, a été analysé et ajoute l’élément à l’objet ControlCollection du contrôle serveur. (Hérité de Control) |
| ApplyStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ApplyStyleSheetSkin(Page) |
Applique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control) |
| BeginRenderTracing(TextWriter, Object) |
Commence le suivi au moment du design des données de rendu. (Hérité de Control) |
| BuildProfileTree(String, Boolean) |
Collecte des informations sur le contrôle serveur et le remet à la propriété Trace à afficher lorsque le suivi est activé pour la page. (Hérité de Control) |
| ClearCachedClientID() |
Définit la valeur ClientID mise en cache sur |
| ClearChildControlState() |
Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildState() |
Supprime les informations d’état d’affichage et d’état de contrôle pour tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildViewState() |
Supprime les informations d’état d’affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearEffectiveClientIDMode() |
Définit la propriété ClientIDMode de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (Hérité de Control) |
| ClearSelection() |
Efface la sélection de la liste et définit la propriété Selected de tous les éléments sur false. (Hérité de ListControl) |
| ConfirmInitState() |
Définit l’état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
Copie 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 les développeurs de contrôles. (Hérité de WebControl) |
| CreateChildControls() |
Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu. (Hérité de Control) |
| CreateControlCollection() |
Crée un objet ControlCollection pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur. (Hérité de Control) |
| CreateControlStyle() |
Crée l’objet de style utilisé en 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 les développeurs de contrôles. (Hérité de WebControl) |
| CreateDataSourceSelectArguments() |
Crée un objet DataSourceSelectArguments par défaut utilisé par le contrôle lié aux données si aucun argument n’est spécifié. (Hérité de DataBoundControl) |
| DataBind() |
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de BaseDataBoundControl) |
| DataBind(Boolean) |
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants avec une option pour déclencher l’événement DataBinding. (Hérité de Control) |
| DataBindChildren() |
Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control) |
| Dispose() |
Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control) |
| EndRenderTracing(TextWriter, Object) |
Met fin au suivi au moment du design des données de rendu. (Hérité de Control) |
| EnsureChildControls() |
Détermine si le contrôle serveur contient des contrôles enfants. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control) |
| EnsureDataBound() |
Appelle la méthode DataBind() si la propriété DataSourceID est définie et que le contrôle lié aux données est marqué pour exiger une liaison. (Hérité de BaseDataBoundControl) |
| EnsureID() |
Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| FindControl(String, Int32) |
Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec le |
| FindControl(String) |
Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre |
| Focus() |
Définit le focus d’entrée sur un contrôle. (Hérité de Control) |
| GetData() |
Récupère un objet DataSourceView que le contrôle lié aux données utilise pour effectuer des opérations de données. (Hérité de DataBoundControl) |
| GetDataSource() |
Récupère l’interface IDataSource à laquelle le contrôle lié aux données est associé, le cas échéant. (Hérité de DataBoundControl) |
| GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetRouteUrl(Object) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(String, Object) |
Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control) |
| HasControls() |
Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control) |
| HasEvents() |
Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control) |
| IsLiteralContent() |
Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
Restaure les informations d’état du contrôle à partir d’une demande de page précédente enregistrée par la méthode SaveControlState(). (Hérité de Control) |
| LoadViewState(Object) |
Charge l’état d’affichage précédemment enregistré du contrôle DetailsView. (Hérité de ListControl) |
| MapPathSecure(String) |
Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control) |
| MarkAsDataBound() |
Définit l’état du contrôle dans l’état d’affichage comme étant lié avec succès aux données. (Hérité de DataBoundControl) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MergeStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’interface utilisateur de la page. (Hérité de Control) |
| OnClick(BulletedListEventArgs) |
Déclenche l’événement Click pour le contrôle BulletedList. |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Déclenche l’événement CreatingModelDataSource. (Hérité de DataBoundControl) |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de ListControl) |
| OnDataBound(EventArgs) |
Déclenche l’événement DataBound. (Hérité de BaseDataBoundControl) |
| OnDataPropertyChanged() |
Rebind le contrôle lié aux données à ses données après la modification de l’une des propriétés d’identification de la source de données de base. (Hérité de DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Déclenche l’événement DataSourceViewChanged. (Hérité de DataBoundControl) |
| OnInit(EventArgs) |
Gère l’événement Init. (Hérité de BaseDataBoundControl) |
| OnLoad(EventArgs) |
Gère l’événement Load. (Hérité de DataBoundControl) |
| OnPagePreLoad(Object, EventArgs) |
Définit l’état initialisé du contrôle lié aux données avant le chargement du contrôle. (Hérité de DataBoundControl) |
| OnPreRender(EventArgs) |
Déclenche l’événement PreRender. (Hérité de ListControl) |
| OnSelectedIndexChanged(EventArgs) |
Déclenche l’événement SelectedIndexChanged. Cela vous permet de fournir un gestionnaire personnalisé pour l’événement. (Hérité de ListControl) |
| OnTextChanged(EventArgs) |
Déclenche l’événement TextChanged. (Hérité de ListControl) |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream utilisé pour lire un fichier. (Hérité de Control) |
| PerformDataBinding(IEnumerable) |
Lie la source de données spécifiée au contrôle dérivé de la classe ListControl. (Hérité de ListControl) |
| PerformSelect() |
Récupère les données de la source de données associée. (Hérité de ListControl) |
| RaiseBubbleEvent(Object, EventArgs) |
Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control) |
| RaisePostBackEvent(String) |
Déclenche des événements pour le contrôle BulletedList lorsqu’un formulaire est renvoyé au serveur. |
| RemovedControl(Control) |
Appelé après la suppression d’un contrôle enfant de la collection Controls de l’objet Control. (Hérité de Control) |
| Render(HtmlTextWriter) |
Écrit le contenu du contrôle BulletedList dans l’objet HtmlTextWriter spécifié pour l’affichage sur le client. |
| RenderBeginTag(HtmlTextWriter) |
Restitue la balise d’ouverture HTML du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| RenderBulletText(ListItem, Int32, HtmlTextWriter) |
Affiche le texte à puces de chaque élément de liste dans un contrôle BulletedList. |
| RenderChildren(HtmlTextWriter) |
Génère le contenu des enfants d’un contrôle serveur dans un objet HtmlTextWriter fourni, qui écrit le contenu à afficher sur le client. (Hérité de Control) |
| RenderContents(HtmlTextWriter) |
Affiche les éléments de liste d’un contrôle BulletedList sous forme de puces dans la HtmlTextWriterspécifiée. |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur vers un objet HtmlTextWriter fourni à l’aide d’un objet ControlAdapter fourni. (Hérité de Control) |
| RenderControl(HtmlTextWriter) |
Génère le contenu du contrôle serveur dans un objet HtmlTextWriter fourni et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de Control) |
| RenderEndTag(HtmlTextWriter) |
Affiche la balise de fermeture HTML du contrôle dans l’enregistreur spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ResolveAdapter() |
Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié. (Hérité de Control) |
| ResolveClientUrl(String) |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
| ResolveUrl(String) |
Convertit une URL en une URL utilisable sur le client demandeur. (Hérité de Control) |
| SaveControlState() |
Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre l’état d’affichage actuel du contrôle ListControl -derived et les éléments qu’il contient. (Hérité de ListControl) |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| SetPostDataSelection(Int32) |
Définit la propriété Selected d’un contrôle ListItem une fois qu’une page est publiée. (Hérité de ListControl) |
| SetRenderMethodDelegate(RenderMethod) |
Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de données de trace et de la valeur des données de trace. (Hérité de Control) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| TrackViewState() |
Marque le point de départ pour commencer le suivi et l’enregistrement des modifications de l’état d’affichage dans un contrôle ListControl -derived. (Hérité de ListControl) |
| ValidateDataSource(Object) |
Vérifie que l’objet auquel un contrôle lié aux données est lié est un contrôle qu’il peut utiliser. (Hérité de DataBoundControl) |
| VerifyMultiSelect() |
Détermine si le contrôle de liste prend en charge le mode de sélection multiple. (Hérité de ListControl) |
Événements
| CallingDataMethods |
Se produit lorsque les méthodes de données sont appelées. (Hérité de DataBoundControl) |
| Click |
Se produit lorsqu’un bouton de lien dans un contrôle BulletedList est cliqué. |
| CreatingModelDataSource |
Se produit lorsque l’objet ModelDataSource est créé. (Hérité de DataBoundControl) |
| DataBinding |
Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control) |
| DataBound |
Se produit après la liaison du contrôle serveur à une source de données. (Hérité de BaseDataBoundControl) |
| Disposed |
Se produit lorsqu’un contrôle serveur est libéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control) |
| Init |
Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control) |
| Load |
Se produit lorsque le contrôle serveur est chargé dans l’objet Page. (Hérité de Control) |
| PreRender |
Se produit après le chargement de l’objet Control, mais avant le rendu. (Hérité de Control) |
| SelectedIndexChanged |
Se produit lorsque la sélection du contrôle de liste change entre les publications sur le serveur. (Hérité de ListControl) |
| TextChanged |
Se produit lorsque les propriétés Text et SelectedValue changent. (Hérité de ListControl) |
| Unload |
Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control) |
Implémentations d’interfaces explicites
| IAttributeAccessor.GetAttribute(String) |
Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Définit un attribut du contrôle Web sur le nom et la valeur spécifiés. (Hérité de WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control) |
| IControlDesignerAccessor.UserData |
Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control) |
| IDataBindingsAccessor.DataBindings |
Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control) |
| IDataBindingsAccessor.HasDataBindings |
Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control) |
| IExpressionsAccessor.Expressions |
Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control) |
| IExpressionsAccessor.HasExpressions |
Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
| IPostBackEventHandler.RaisePostBackEvent(String) |
Pour obtenir une description de cette méthode, consultez RaisePostBackEvent(String). |
Méthodes d’extension
| EnablePersistedSelection(BaseDataBoundControl) |
Obsolète.
Permet de conserver la sélection dans les contrôles de données qui prennent en charge la sélection et la pagination. |
| FindDataSourceControl(Control) |
Retourne la source de données associée au contrôle de données pour le contrôle spécifié. |
| FindFieldTemplate(Control, String) |
Retourne le modèle de champ de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l’objet métatable pour le contrôle de données contenant. |
S’applique à
Voir aussi
- BulletStyle
- FirstBulletNumber
- BulletImageUrl
- DisplayMode
- Click
- ListItem
- DataSourceControl
- de contrôle serveur web BulletedList
