HtmlSelect.DataSourceID Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta la proprietà ID del controllo origine dati che il controllo HtmlSelect deve utilizzare per recuperare la propria origine dati.

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

Valore della proprietà

String

Identificatore a livello di codice assegnato al controllo origine dati. Il valore predefinito è una stringa vuota (""), che indica che questa proprietà non è stata impostata.

Eccezioni

HttpException

L'origine dati non può essere risolta perché è stato specificato un valore sia per la proprietà DataSource che per la proprietà DataSourceID.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la proprietà per specificare l'origine DataSourceID dati per un HtmlSelect controllo. La DataSourceID proprietà è impostata sulla ID proprietà del SqlDataSource controllo utilizzata per recuperare i dati. Quando la pagina viene caricata, il HtmlSelect controllo associa automaticamente all'origine dati specificata dal SqlDataSource controllo e i dati vengono visualizzati all'utente.

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

Commenti

Utilizzare la DataSourceID proprietà per impostare o accedere alla proprietà del controllo origine dati che il controllo deve usare per recuperare l'origine ID HtmlSelect dati. Il controllo origine dati a cui fa riferimento la DataSourceID proprietà può essere qualsiasi controllo che implementa l'interfaccia IDataSource . Il controllo origine dati deve esistere nello stesso contenitore HtmlSelect di denominazione del controllo a cui fa riferimento o in un controllo padre del HtmlSelect controllo. Quando si specifica un valore per questa proprietà, il HtmlSelect controllo associa automaticamente al controllo origine dati specificato. Non è necessario scrivere codice che chiama in modo esplicito il DataBind metodo.

In alternativa, è possibile usare la proprietà per specificare l'origine DataSource dei valori da associare a un HtmlSelect controllo. L'origine dati deve essere una raccolta che implementa l'interfaccia (ad esempio , o ) System.Collections.Generic.List<T>o l'interfaccia.System.Collections.IEnumerable IListSource System.Collections.ArrayList System.Data.DataView Quando si imposta la proprietà, è necessario scrivere manualmente il DataSource codice per eseguire il data binding.

Se i valori vengono specificati sia per la proprietà che per la DataSource proprietà, ASP.NET non è in grado di risolvere l'origine DataSourceID dati e viene generata un'eccezione System.Web.HttpException .

Si applica a

Vedi anche

DataSource