HtmlSelect.DataSourceID Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la propiedad ID del control de origen de datos que debe utilizar el control HtmlSelect para recuperar su origen de datos.
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 propiedad
Identificador de programación asignado al control de origen de datos. El valor predeterminado es una cadena vacía (""), lo que indica que aún no se ha establecido la propiedad.
Excepciones
No se puede resolver el origen de datos porque se ha especificado un valor tanto para la propiedad DataSource, como para la propiedad DataSourceID.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la DataSourceID propiedad para especificar el origen de datos de un HtmlSelect control. La DataSourceID propiedad se establece en la ID propiedad del SqlDataSource control utilizado para recuperar los datos. Cuando se carga la página, el HtmlSelect control se enlaza automáticamente al origen de datos especificado por el SqlDataSource control y los datos se muestran al usuario.
<%@ 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>
Comentarios
Utilice la DataSourceID propiedad para establecer o tener acceso a la ID propiedad del control de origen de datos que el HtmlSelect control debe usar para recuperar su origen de datos. El control de origen de datos al que hace referencia la DataSourceID propiedad puede ser cualquier control que implemente la IDataSource interfaz . El control de origen de datos debe existir en el mismo contenedor de nomenclatura que el HtmlSelect control que hace referencia a él o en un control primario del HtmlSelect control. Cuando se especifica un valor para esta propiedad, el HtmlSelect control se enlaza automáticamente al control de origen de datos especificado. No es necesario escribir código que llame explícitamente al DataBind método .
Como alternativa, puede usar la DataSource propiedad para especificar el origen de los valores que se van a enlazar a un HtmlSelect control. El origen de datos debe ser una colección que implemente la System.Collections.IEnumerable interfaz (como System.Data.DataView, System.Collections.ArrayListo System.Collections.Generic.List<T>) o la IListSource interfaz . Al establecer la DataSource propiedad , debe escribir manualmente el código para realizar el enlace de datos.
Si se especifican valores para la DataSource propiedad y la DataSourceID propiedad , ASP.NET no puede resolver el origen de datos y se produce una System.Web.HttpException excepción.