HtmlSelect.DataSourceID Propriedade

Definição

Espaço de Nomes:
System.Web.UI.HtmlControls
Assemblagem:
System.Web.dll

Obtém ou define a ID propriedade do controlo de fonte de dados que o HtmlSelect controlo deve usar para recuperar a sua fonte de dados.

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

Valor de Propriedade

String

O identificador programático atribuído ao controlo de fonte dos dados. O valor padrão é uma cadeia vazia (""), que indica que a propriedade não foi definida.

Exceções

HttpException

A fonte de dados não pode ser resolvida porque um valor é especificado tanto para a DataSource propriedade como para a propriedade DataSourceID .

Exemplos

O exemplo de código seguinte demonstra como usar a DataSourceID propriedade para especificar a fonte de dados de um HtmlSelect controlo. A DataSourceID propriedade é definida para a ID propriedade do SqlDataSource controlo usado para recuperar os dados. Quando a página é carregada, o controlo HtmlSelect liga-se automaticamente à fonte de dados especificada pelo SqlDataSource controlo e os dados são exibidos ao utilizador.

<%@ 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>

Observações

Use a DataSourceID propriedade para definir ou aceder à ID propriedade do controlo de fonte de dados que o HtmlSelect controlo deve usar para recuperar a sua fonte de dados. O controlo de fonte de dados referenciado pela DataSourceID propriedade pode ser qualquer controlo que implemente a IDataSource interface. O controlo de fonte de dados deve existir ou no mesmo contentor de nomenclatura do controlo HtmlSelect que o referencia, ou num controlo pai do HtmlSelect controlo. Quando especifica um valor para esta propriedade, o controlo HtmlSelect liga-se automaticamente ao controlo de fonte de dados especificado. Não precisas de escrever código que chame explicitamente o DataBind método.

Alternativamente, pode usar a DataSource propriedade para especificar a fonte dos valores a atribuir a um HtmlSelect controlo. A fonte de dados deve ser uma coleção que implemente a System.Collections.IEnumerable interface (como System.Data.DataView, System.Collections.ArrayList, ou System.Collections.Generic.List<T>) ou a IListSource interface. Quando defines a DataSource propriedade, tens de escrever manualmente o código para realizar a ligação de dados.

Se forem especificados valores tanto para a propriedade DataSource como para a propriedade DataSourceID, ASP.NET não conseguir resolver a fonte de dados e é lançada uma exceção System.Web.HttpException.

Aplica-se a

Ver também