HtmlSelect.DataSourceID Proprietà
Definizione
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 ID proprietà del controllo origine dati che il controllo deve utilizzare per recuperare l'origine HtmlSelect 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à
Identificatore programmatico assegnato al controllo origine dati. Il valore predefinito è una stringa vuota (""), che indica che la proprietà non è stata impostata.
Eccezioni
Impossibile risolvere l'origine dati perché viene specificato un valore sia per la DataSource proprietà che per la DataSourceID proprietà .
Esempio
Nell'esempio di codice seguente viene illustrato come utilizzare la DataSourceID proprietà per specificare l'origine dati per un HtmlSelect controllo . La DataSourceID proprietà viene impostata sulla ID proprietà del SqlDataSource controllo utilizzato per recuperare i dati. Quando la pagina viene caricata, il HtmlSelect controllo viene associato 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 ID proprietà del controllo origine dati che il HtmlSelect controllo deve utilizzare per recuperare l'origine 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 di denominazione del HtmlSelect controllo che vi fa riferimento o in un controllo padre del HtmlSelect controllo . Quando si specifica un valore per questa proprietà, il HtmlSelect controllo viene associato automaticamente al controllo origine dati specificato. Non è necessario scrivere codice che chiama in modo esplicito il DataBind metodo .
In alternativa, è possibile utilizzare la DataSource proprietà per specificare l'origine dei valori da associare a un HtmlSelect controllo. L'origine dati deve essere una raccolta che implementa l'interfaccia System.Collections.IEnumerable ( ad esempio System.Data.DataView, System.Collections.ArrayListo System.Collections.Generic.List<T>) o l'interfaccia IListSource . Quando si imposta la DataSource proprietà , è necessario scrivere manualmente il codice per eseguire il data binding.
Se i valori vengono specificati sia per la DataSource proprietà che per la DataSourceID proprietà , ASP.NET non è in grado di risolvere l'origine dati e viene generata un'eccezione System.Web.HttpException .