HtmlSelect.DataSourceID Propriedade

Referência

Definição

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define a propriedade ID do controle de fonte de dados que o controle HtmlSelect deve usar para recuperar a 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 da propriedade

String

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

Exceções

HttpException

A fonte de dados não pode ser resolvida porque foi especificado um valor para as propriedades DataSource e DataSourceID.

Exemplos

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

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

Comentários

Use a DataSourceID propriedade para definir ou acessar a ID propriedade do controle da fonte de dados que o HtmlSelect controle deve usar para recuperar sua fonte de dados. O controle da fonte de dados referenciado pela DataSourceID propriedade pode ser qualquer controle que implemente a IDataSource interface. O controle da fonte de dados deve existir no mesmo contêiner de nomenclatura que o controle que faz referência a HtmlSelect ele ou em um controle pai do HtmlSelect controle. Quando você especifica um valor para essa propriedade, o HtmlSelect controle é automaticamente associado ao controle da fonte de dados especificado. Você não precisa escrever um código que chame explicitamente o DataBind método.

Como alternativa, você pode usar a DataSource propriedade para especificar a fonte de valores a serem associados a um HtmlSelect controle. A fonte de dados deve ser uma coleção que implemente a System.Collections.IEnumerable interface (como System.Data.DataView, System.Collections.ArrayListou ) ou System.Collections.Generic.List<T>a IListSource interface. Ao definir a DataSource propriedade, você deve escrever manualmente o código para executar a associação de dados.

Se os valores forem especificados para a DataSource propriedade e a DataSourceID propriedade, ASP.NET não poderá resolver a fonte de dados e uma System.Web.HttpException exceção será gerada.

Aplica-se a

Confira também

DataSource

Compartilhar via