HtmlSelect 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.
Autorise l’accès par programmation à l’élément HTML <select> sur le serveur.
public ref class HtmlSelect : System::Web::UI::HtmlControls::HtmlContainerControl, System::Web::UI::IPostBackDataHandler[System.Web.UI.ValidationProperty("Value")]
public class HtmlSelect : System.Web.UI.HtmlControls.HtmlContainerControl, System.Web.UI.IPostBackDataHandler[<System.Web.UI.ValidationProperty("Value")>]
type HtmlSelect = class
inherit HtmlContainerControl
interface IPostBackDataHandler
interface IParserAccessorPublic Class HtmlSelect
Inherits HtmlContainerControl
Implements IPostBackDataHandler- Héritage
- Attributs
- Implémente
Exemples
L’exemple de code suivant montre comment créer un HtmlSelect contrôle en déclarant explicitement les éléments qui apparaissent dans le contrôle.
<%@ 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">
<script runat="server">
void Button_Click (Object sender, EventArgs e)
{
Label1.Text = "You selected:";
for (int i = 0; i <= Select1.Items.Count - 1; i++)
{
if (Select1.Items[i].Selected)
Label1.Text += "<br /> -" + Select1.Items[i].Text;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br /><br />
<select id="Select1"
multiple="true"
runat="server">
<option value="1" selected="selected"> Item 1 </option>
<option value="2"> Item 2 </option>
<option value="3"> Item 3 </option>
<option value="4"> Item 4 </option>
<option value="5"> Item 5 </option>
<option value="6"> Item 6 </option>
</select>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Button_Click (sender As Object, e As EventArgs)
Dim i As Integer
Label1.Text = "You selected:"
For i = 0 to Select1.Items.Count - 1
If Select1.Items(i).Selected Then
Label1.Text = Label1.Text & "<br /> -" _
& Select1.Items(i).Text
End If
Next i
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br /><br />
<select id="Select1"
multiple="true"
runat="server">
<option value="1" selected="selected"> Item 1 </option>
<option value="2"> Item 2 </option>
<option value="3"> Item 3 </option>
<option value="4"> Item 4 </option>
<option value="5"> Item 5 </option>
<option value="6"> Item 6 </option>
</select>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
L’exemple de code suivant montre comment créer un HtmlSelect contrôle en liant le contrôle à une source de données.
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>
<!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> HtmlSelect Example </title>
<script runat="server">
void Page_Load (Object sender, EventArgs e)
{
// Bind the HtmlSelect control to a data source when the page is initially loaded.
if (!IsPostBack)
{
// Open a connection to the database and run the query.
// Note that the connection string may vary depending on your
// database server settings.
string ConnectString = "server=localhost;database=pubs;integrated security=SSPI";
string QueryString = "select * from authors";
SqlConnection myConnection = new SqlConnection(ConnectString);
SqlDataAdapter myCommand = new SqlDataAdapter(QueryString, myConnection);
// Create a dataset to store the query results.
DataSet ds = new DataSet();
myCommand.Fill(ds, "Authors");
// Bind the HtmlSelect control to the data source.
Select1.DataSource = ds;
Select1.DataTextField = "au_fname";
Select1.DataValueField = "au_fname";
Select1.DataBind();
}
}
void Button_Click (Object sender, EventArgs e)
{
// Display the selected items.
Label1.Text = "You selected:";
for (int i=0; i<=Select1.Items.Count - 1; i++)
{
if (Select1.Items[i].Selected)
Label1.Text += "<br /> - " + Select1.Items[i].Text;
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list. <br />
Use the Control or Shift key to select multiple items. <br /><br />
<select id="Select1"
multiple="true"
runat="server"/>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>
<!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> HtmlSelect Example </title>
<script runat="server">
Sub Page_Load (sender As Object, e As EventArgs)
' Bind the HtmlSelect control to a data source when the page is initially loaded.
If Not IsPostBack Then
' Open a connection to the database and run the query.
' Note that the connection string may vary depending on your
' database server settings.
Dim ConnectString As String = "server=localhost;database=pubs;integrated security=SSPI"
Dim QueryString As String = "select * from authors"
Dim myConnection As SqlConnection = New SqlConnection(ConnectString)
Dim myCommand As SqlDataAdapter = New SqlDataAdapter(QueryString, myConnection)
' Create a dataset to store the query results.
Dim ds As DataSet = New DataSet()
myCommand.Fill(ds, "Authors")
' Bind the HtmlSelect control to the data source.
Select1.DataSource = ds
Select1.DataTextField = "au_fname"
Select1.DataValueField = "au_fname"
Select1.DataBind()
End If
End Sub
Sub Button_Click (sender As Object, e As EventArgs)
Dim i As Integer
Label1.Text = "You selected:"
For i = 0 To Select1.Items.Count - 1
If Select1.Items(i).Selected Then
Label1.Text = Label1.Text & "<br /> - " & Select1.Items(i).Text
End If
Next i
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list. <br />
Use the Control or Shift key to select multiple items. <br /><br />
<select id="Select1"
multiple="true"
runat="server"/>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
L’exemple de code suivant montre comment utiliser la DataSourceID propriété pour spécifier la source de données d’un HtmlSelect contrôle. La DataSourceID propriété est définie sur la ID propriété du SqlDataSource contrôle utilisé pour récupérer les données. Lorsque la page est chargée, le HtmlSelect contrôle est automatiquement lié à la source de données spécifiée par le SqlDataSource contrôle et les données sont affichées à l’utilisateur.
<%@ 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 id="Head1" runat="server">
<title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
<div>
<h3> HtmlSelect.DataSourceID Example </h3>
<p>Select an item from the list</p>
<select id="Select1"
name="Select1"
datasourceid="SqlDataSource1"
datatextfield="ProductName"
runat="server">
</select>
<asp:sqldatasource id="SqlDataSource1"
connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
runat="server">
</asp:sqldatasource>
</div>
</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 id="Head1" runat="server">
<title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
<div>
<h3> HtmlSelect.DataSourceID Example </h3>
<p>Select an item from the list</p>
<select id="Select1"
name="Select1"
datasourceid="SqlDataSource1"
datatextfield="ProductName"
runat="server">
</select>
<asp:sqldatasource id="SqlDataSource1"
connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
runat="server">
</asp:sqldatasource>
</div>
</form>
</body>
</html>
Remarques
Utilisez le HtmlSelect contrôle pour créer une zone de sélection. Spécifiez les listes d’éléments dans le contrôle en plaçant des éléments HTML <option> entre les balises d’ouverture et de fermeture <select> . Chaque élément est représenté par un System.Web.UI.WebControls.ListItem objet. Pour spécifier le texte affiché pour chaque élément du contrôle, vous pouvez définir la ListItem.Text propriété de l’élément ou simplement placer du texte entre les balises d’ouverture et de fermeture <option> . En définissant la ListItem.Value propriété de l’élément, vous pouvez associer une valeur à l’élément différent du texte. Pour sélectionner un élément dans la liste par défaut, définissez la ListItem.Selected propriété de l’élément truesur .
Vous pouvez contrôler l’apparence et le comportement du HtmlSelect contrôle en définissant les propriétés et Multiple les Size propriétés. La Size propriété spécifie la hauteur (en lignes) du contrôle. La Multiple propriété spécifie si plusieurs éléments peuvent être sélectionnés simultanément dans le HtmlSelect contrôle.
Par défaut, le HtmlSelect contrôle s’affiche sous la forme d’une zone de liste déroulante. Si vous autorisez plusieurs sélections (en définissant la Multiple propriété sur true) ou spécifiez une hauteur supérieure à une ligne (en définissant la Size propriété sur une valeur supérieure 1à ), le contrôle s’affiche sous la forme d’une zone de liste.
Pour déterminer l’élément sélectionné dans un contrôle de sélection HtmlSelect unique, utilisez la SelectedIndex propriété pour obtenir l’index de l’élément sélectionné. Vous pouvez ensuite utiliser cette valeur pour récupérer l’élément de la Items collection.
Pour déterminer les éléments sélectionnés à partir d’un HtmlSelect contrôle qui autorise plusieurs sélections, effectuez une itération dans la Items collection et testez la ListItem.Selected propriété de chaque élément.
La HtmlSelect classe fournit deux propriétés pour prendre en charge la liaison de données. Pour lier des données à n’importe quel objet qui implémente l’interface System.Collections.IEnumerable (par System.Data.DataViewexemple, , System.Collections.ArrayListet System.Collections.Generic.List<T>) ou l’interface IListSource , utilisez la DataSource propriété pour spécifier la source de données à lier. Lorsque vous définissez la DataSource propriété, vous devez écrire manuellement le code pour effectuer la liaison de données. Pour lier automatiquement un HtmlSelect contrôle à une source de données représentée par un contrôle de source de données, utilisez la DataSourceID propriété et définissez sa valeur sur la ID propriété du contrôle de source de données à utiliser. Lorsque vous définissez la DataSourceID propriété, le HtmlSelect contrôle est automatiquement lié au contrôle de source de données spécifié. Par conséquent, vous n’avez pas besoin d’appeler explicitement la DataBind méthode.
Vous pouvez également spécifier les champs de la source de données liés aux propriétés et ListItem.Value aux ListItem.Text propriétés d’un élément du contrôle en définissant respectivement les DataTextField champs et DataValueField les propriétés. Si la source de données contient plusieurs sources de données, utilisez la DataMember propriété pour spécifier la source spécifique à lier au contrôle. Par exemple, si vous avez un System.Data.DataSet objet avec plusieurs tables, vous devez spécifier la table à lier au contrôle avec la DataMember propriété.
Pour obtenir la liste des valeurs de propriété initiales d’une instance de HtmlSelect, consultez le HtmlSelect constructeur.
Constructeurs
| Nom | Description |
|---|---|
| HtmlSelect() |
Initialise une nouvelle instance de la classe HtmlSelect. |
Propriétés
| Nom | Description |
|---|---|
| Adapter |
Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
| AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control) |
| Attributes |
Obtient une collection de toutes les paires nom et valeur d’attribut exprimées sur une balise de contrôle serveur dans la page ASP.NET. (Hérité de HtmlControl) |
| BindingContainer |
Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control) |
| 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 ClientID propriété. (Hérité de Control) |
| ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (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 un ControlCollection objet qui représente les contrôles enfants d’un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur. (Hérité de Control) |
| DataItemContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control) |
| DataKeysContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control) |
| DataMember |
Obtient ou définit le jeu de données à lier au contrôle à HtmlSelect partir d’une DataSource propriété avec plusieurs jeux de données. |
| DataSource |
Obtient ou définit la source d’informations à lier au HtmlSelect contrôle. |
| DataSourceID |
Obtient ou définit la ID propriété du contrôle de source de données que le HtmlSelect contrôle doit utiliser pour récupérer sa source de données. |
| DataTextField |
Obtient ou définit le champ de la source de données à lier à la Text propriété de chaque élément du HtmlSelect contrôle. |
| DataValueField |
Obtient ou définit le champ de la source de données à lier à la Value propriété de chaque élément du HtmlSelect contrôle. |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control) |
| Disabled |
Obtient ou définit une valeur indiquant si le contrôle serveur HTML est désactivé. (Hérité de HtmlControl) |
| EnableTheming |
Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle. (Hérité de Control) |
| 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) |
| 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) |
| 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) |
| InnerHtml |
Obtient ou définit le contenu entre les balises d’ouverture et de fermeture du contrôle sans convertir automatiquement des caractères spéciaux en leurs entités HTML équivalentes. Cette propriété n’est pas prise en charge pour ce contrôle. |
| InnerText |
Obtient ou définit le contenu entre les balises d’ouverture et de fermeture du contrôle avec la conversion automatique de caractères spéciaux en leurs entités HTML équivalentes. Cette propriété n’est pas prise en charge pour ce contrôle. |
| IsBoundUsingDataSourceID |
Obtient une valeur indiquant si une DataSourceID propriété est définie pour le HtmlSelect contrôle. |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle. (Hérité de Control) |
| IsTrackingViewState |
Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage. (Hérité de Control) |
| IsViewStateEnabled |
Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle. (Hérité de Control) |
| Items |
Obtient une collection qui contient les éléments répertoriés dans un HtmlSelect contrôle. |
| LoadViewStateByID |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index. (Hérité de Control) |
| Multiple |
Obtient ou définit une valeur indiquant si plusieurs éléments peuvent être sélectionnés simultanément dans le HtmlSelect contrôle. |
| Name |
Obtient ou définit le nom d’identificateur unique associé au HtmlSelect contrôle. |
| 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 la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (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) |
| RequiresDataBinding |
Obtient ou définit une valeur indiquant si le HtmlSelect contrôle doit être lié à sa source de données spécifiée. |
| SelectedIndex |
Obtient ou définit l’index ordinal de l’élément sélectionné dans un HtmlSelect contrôle. |
| SelectedIndices |
Obtient une collection qui contient les index de base zéro de tous les éléments actuellement sélectionnés dans le HtmlSelect contrôle. |
| 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) |
| Size |
Obtient ou définit la hauteur (en lignes) du HtmlSelect contrôle. |
| SkinID |
Obtient ou définit la peau à appliquer au contrôle. (Hérité de Control) |
| Style |
Obtient une collection de toutes les propriétés de feuille de style en cascade (CSS) appliquées à un contrôle serveur HTML spécifié dans le fichier ASP.NET. (Hérité de HtmlControl) |
| TagName |
Obtient le nom d’élément d’une balise qui contient une |
| 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 PageUserControl ou qui contient le contrôle serveur actuel. (Hérité de Control) |
| 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) |
| Value |
Obtient la valeur de l’élément sélectionné dans le HtmlSelect contrôle ou définit la SelectedIndex propriété du contrôle sur l’index du premier élément de la liste avec la valeur spécifiée. |
| 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’état d’affichage respecte la HtmlControl casse. (Hérité de HtmlControl) |
| 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) |
Méthodes
| Nom | Description |
|---|---|
| AddedControl(Control, Int32) |
Appelé après l’ajout d’un contrôle enfant à la Controls collection de l’objet Control . (Hérité de Control) |
| AddParsedSubObject(Object) |
Ajoute un contrôle enfant analysé au HtmlSelect contrôle. |
| 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 Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control) |
| ClearCachedClientID() |
Définit la valeur mise en ClientID 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 ClientIDMode propriété 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 liste du HtmlSelect contrôle et définit la Selected propriété de tous les éléments sur |
| 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 EmptyControlCollection objet pour le HtmlSelect contrôle. |
| DataBind() |
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control) |
| 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() |
Vérifie que le HtmlSelect contrôle nécessite une liaison de données et qu’un contrôle de source de données valide est spécifié avant d’appeler la DataBind() méthode. |
| 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 l’entier spécifié |
| FindControl(String) |
Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié |
| Focus() |
Définit le focus d’entrée sur un contrôle. (Hérité de Control) |
| GetAttribute(String) |
Obtient la valeur de l’attribut nommé sur le HtmlControl contrôle. (Hérité de HtmlControl) |
| GetData() |
Obtient un IEnumerable objet qui représente la source de données liée au HtmlSelect contrôle. |
| 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 UniqueID propriété 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 qui a été enregistrée par la SaveControlState() méthode. (Hérité de Control) |
| LoadPostData(String, NameValueCollection) |
Traite les données de publication pour le HtmlSelect contrôle. |
| LoadViewState(Object) |
Restaure les HtmlSelect informations d’état d’affichage du contrôle à partir d’une demande de page précédente enregistrée par la SaveViewState() méthode. |
| MapPathSecure(String) |
Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| 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) |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding d’un HtmlSelect contrôle. |
| OnDataPropertyChanged() |
Appelé lorsque la propriété ou la DataSourcepropriété DataSourceIDDataMemberest modifiée. |
| OnDataSourceViewChanged(Object, EventArgs) |
Appelé lorsque la propriété ou la DataSourcepropriété DataSourceIDDataMemberest modifiée. |
| OnInit(EventArgs) |
Déclenche l’événement Init pour le HtmlSelect contrôle. |
| OnInit(EventArgs) |
Déclenche l’événement Init. (Hérité de Control) |
| OnLoad(EventArgs) |
Déclenche l’événement Load pour le HtmlSelect contrôle. |
| OnLoad(EventArgs) |
Déclenche l’événement Load. (Hérité de Control) |
| OnPreRender(EventArgs) |
Déclenche l’événement PreRender pour le HtmlSelect contrôle. |
| OnServerChange(EventArgs) |
Déclenche l’événement ServerChange du HtmlSelect contrôle. Cela vous permet de fournir un gestionnaire personnalisé pour l’événement. |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream élément utilisé pour lire un fichier. (Hérité de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control) |
| RaisePostDataChangedEvent() |
Appelle la OnServerChange(EventArgs) méthode pour signaler au HtmlSelect contrôle que l’état du contrôle a changé. |
| RemovedControl(Control) |
Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control) |
| Render(HtmlTextWriter) |
Restitue le HtmlContainerControl contrôle à l’objet spécifié HtmlTextWriter . (Hérité de HtmlContainerControl) |
| RenderAttributes(HtmlTextWriter) |
Restitue les HtmlSelect attributs du contrôle à l’objet spécifié HtmlTextWriter . |
| RenderBeginTag(HtmlTextWriter) |
Affiche la balise HTML ouvrante du contrôle dans l’objet spécifié HtmlTextWriter . (Hérité de HtmlControl) |
| RenderChildren(HtmlTextWriter) |
Restitue les HtmlSelect contrôles enfants du contrôle à l’objet spécifié HtmlTextWriter . |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control) |
| RenderControl(HtmlTextWriter) |
Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter 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 du HtmlContainerControl contrôle sur l’objet spécifié HtmlTextWriter . (Hérité de HtmlContainerControl) |
| 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 les HtmlSelect modifications de l’état d’affichage du contrôle qui se sont produites depuis la publication de la page sur le serveur. |
| Select(Int32[]) |
Sélectionne plusieurs éléments de la HtmlSelect collection du Items contrôle. |
| SetAttribute(String, String) |
Définit la valeur de l’attribut nommé sur le HtmlControl contrôle. (Hérité de HtmlControl) |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| 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() |
Effectue le suivi des modifications de l’état d’affichage du HtmlSelect contrôle afin que les modifications puissent être stockées dans l’objet du StateBag contrôle. Cet objet est accessible via la ViewState propriété. |
Événements
| Nom | Description |
|---|---|
| DataBinding |
Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control) |
| 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) |
| ServerChange |
Se produit lorsque les éléments sélectionnés dans le HtmlSelect contrôle changent entre les publications sur le serveur. |
| Unload |
Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control) |
Implémentations d’interfaces explicites
Méthodes d’extension
| Nom | Description |
|---|---|
| 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. |
