HtmlSelect.DataSourceID Propriété

Référence

Définition

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

Assembly:: System.Web.dll

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.

Obtient ou définit la propriété ID du contrôle de source de données que le contrôle HtmlSelect 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 assigné au contrôle de source de données. La valeur par défaut est une chaîne vide (""), ce qui signifie que cette propriété n'a pas été définie.

Exceptions

HttpException

La source de données ne peut pas être déterminée, car une valeur est spécifiée à la fois pour la propriété DataSource et pour la propriété DataSourceID.

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 soit dans le même conteneur d’affectation de noms que le HtmlSelect contrôle qui y fait référence, soit 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 des valeurs à lier à un HtmlSelect contrôle. La source de données doit être une collection qui implémente l’interface System.Collections.IEnumerable (par System.Data.DataViewexemple , System.Collections.ArrayListou System.Collections.Generic.List<T>) ou l’interface IListSource . Lorsque vous définissez la DataSource propriété, vous devez écrire manuellement le code pour effectuer la liaison de données.

Si des 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

DataSource