BaseDataList.DataSource 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 el origen que contiene una lista de valores que se utiliza para rellenar los elementos contenidos en el control.
public:
virtual property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };[System.ComponentModel.Bindable(true)]
public virtual object DataSource { get; set; }[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public virtual object DataSource { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.DataSource : obj with get, set[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
member this.DataSource : obj with get, setPublic Overridable Property DataSource As ObjectValor de propiedad
Interfaz IEnumerable o IListSource que contiene una colección de valores que se utilizan para suministrar datos a este control. El valor predeterminado es null.
- Atributos
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.
El origen de datos es de un tipo no válido. El origen de datos debe ser null o implementar la interfaz IEnumerable o IListSource.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la DataSource propiedad para especificar el origen de datos que se va a enlazar a un DataGrid control.
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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" >
<script language="C#" runat="server">
ICollection CreateDataSource()
{
DataTable dt = new DataTable();
DataRow dr;
dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
for (int i = 0; i < 9; i++)
{
dr = dt.NewRow();
dr[0] = i;
dr[1] = "Item " + i.ToString();
dr[2] = 1.23 * (i + 1);
dt.Rows.Add(dr);
}
DataView dv = new DataView(dt);
return dv;
}
void Page_Load(Object sender, EventArgs e)
{
if (!IsPostBack)
{
// Load this data only once.
ItemsGrid.DataSource= CreateDataSource();
ItemsGrid.DataBind();
}
}
</script>
<head runat="server">
<title>DataGrid Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataGrid Example</h3>
<b>Product List</b>
<asp:DataGrid id="ItemsGrid"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
AutoGenerateColumns="true"
runat="server">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
</asp:DataGrid>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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" >
<script language="VB" runat="server">
Function CreateDataSource() As ICollection
Dim dt As New DataTable()
Dim dr As DataRow
dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
Dim i As Integer
For i = 0 To 8
dr = dt.NewRow()
dr(0) = i
dr(1) = "Item " + i.ToString()
dr(2) = 1.23 *(i + 1)
dt.Rows.Add(dr)
Next i
Dim dv As New DataView(dt)
Return dv
End Function 'CreateDataSource
Sub Page_Load(sender As Object, e As EventArgs)
If Not IsPostBack Then
' Load this data only once.
ItemsGrid.DataSource = CreateDataSource()
ItemsGrid.DataBind()
End If
End Sub 'Page_Load
</script>
<head runat="server">
<title>DataGrid Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataGrid Example</h3>
<b>Product List</b>
<asp:DataGrid id="ItemsGrid"
BorderColor="black"
BorderWidth="1"
CellPadding="3"
AutoGenerateColumns="true"
runat="server">
<HeaderStyle BackColor="#00aaaa">
</HeaderStyle>
</asp:DataGrid>
</form>
</body>
</html>
Comentarios
Utilice la DataSource propiedad para especificar el origen de valores que se enlazarán a un control de lista de datos. Un 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 para enlazar a un control derivado de la BaseDataList clase . Al establecer la DataSource propiedad , debe escribir manualmente el código para realizar el enlace de datos.
Si el origen de datos especificado por la DataSource propiedad contiene varios orígenes de datos, utilice la DataMember propiedad para especificar el origen específico que se va a enlazar al control. Por ejemplo, si tiene un System.Data.DataSet objeto con varias tablas, debe especificar qué tabla se va a enlazar al control. Después de especificar el origen de datos, use el DataBind método para enlazar el origen de datos al control .
Como alternativa, puede usar la DataSourceID propiedad para enlazar automáticamente a un origen de datos representado por un control de origen de datos. Al establecer la DataSourceID propiedad , el control de lista de datos 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 .
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.
Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, vea ThemeableAttribute y ASP.NET Temas y máscaras.
