Partager via

HtmlSelect.DataSourceID Propriété

Définition

Espace de noms:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

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.

public:
 virtual property System::String ^ DataSourceID { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataSourceID { get; set; }
member this.DataSourceID : string with get, set
Public Overridable Property DataSourceID As String

Valeur de propriété

String

Identificateur programmatique affecté au contrôle de source de données. La valeur par défaut est une chaîne vide («  »), qui indique que la propriété n’a pas été définie.

Exceptions

HttpException

Impossible de résoudre la source de données, car une valeur est spécifiée pour la DataSource propriété et la DataSourceID propriété.

Exemples

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 la DataSourceID propriété pour définir ou accéder à 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. Le contrôle de source de données référencé par la DataSourceID propriété peut être n’importe quel contrôle qui implémente l’interface IDataSource . Le contrôle de source de données doit exister dans le même conteneur d’affectation de noms que le HtmlSelect contrôle qui le référence ou dans un contrôle parent du HtmlSelect contrôle. Lorsque vous spécifiez une valeur pour cette propriété, le HtmlSelect contrôle est automatiquement lié au contrôle de source de données spécifié. Vous n’avez pas besoin d’écrire du code qui appelle explicitement la DataBind méthode.

Vous pouvez également utiliser la DataSource propriété pour spécifier la source de valeurs à lier à un HtmlSelect contrôle. La source de données doit être une collection qui implémente l’interface (par System.Data.DataViewexemple, ou System.Collections.Generic.List<T>System.Collections.ArrayList) ou l’interfaceIListSource.System.Collections.IEnumerable Lorsque vous définissez la DataSource propriété, vous devez écrire manuellement le code pour effectuer une liaison de données.

Si les valeurs sont spécifiées pour la DataSource propriété et la DataSourceID propriété, ASP.NET n’est pas en mesure de résoudre la source de données et une System.Web.HttpException exception est levée.

S’applique à

Voir aussi