¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

SqlDataSource (Clase)

Representa una base de datos SQL para controles enlazados a datos.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

public class SqlDataSource : DataSourceControl
public class SqlDataSource extends DataSourceControl
public class SqlDataSource extends DataSourceControl
No aplicable.

El control de origen de datos SqlDataSource representa los datos de una base de datos relacional SQL para controles enlazados a datos. Puede utilizar el control SqlDataSource junto con un control enlazado a datos para recuperar datos de una base de datos relacional y para mostrar, editar y ordenar datos en una página Web con poco código o ninguno.

NotaNota:

Si no conoce las características de acceso a datos de ASP.NET 2.0, lea uno o varios de los temas siguientes antes de continuar:

Para conectar a una base de datos, debe establecer la propiedad ConnectionString en una cadena de conexión válida. El control SqlDataSource admite cualquier base de datos relacional SQL que pueda conectarse mediante un proveedor ADO.NET, tal como SqlClient, OleDb, Odbc o OracleClient. Para obtener información sobre cómo proteger las cadenas de conexión, vea Cómo: Proteger cadenas de conexión al utilizar controles de orígenes de datos.

Para recuperar datos de una base de datos subyacente, establezca la propiedad SelectCommand con una consulta SQL. Si la base de datos a la que está asociada el control SqlDataSource admite procedimientos almacenados, puede establecer la propiedad SelectCommand en el nombre de un procedimiento almacenado. La consulta SQL que especifique también puede ser una consulta parametrizada. Puede agregar objetos Parameter que asociados a una consulta parametrizada a la colección SelectParameters. Para obtener más información sobre las consultas SQL parametrizadas y su sintaxis, vea Utilizar parámetros con controles de origen de datos.

El control SqlDataSource recupera datos cada vez que se llama al método Select. Este método proporciona acceso mediante programación al método especificado por la propiedad SelectMethod. Los controles que se enlazan a SqlDataSource llaman automáticamente al método Select cuando se llama a su método DataBind. Si establece la propiedad DataSourceID de un control enlazado a datos, el control se enlaza automáticamente a los datos del origen de datos, según sea necesario. Establecer la propiedad DataSourceID es el método recomendado para enlazar un control ObjectDataSource a un control enlazado a datos. También puede utilizar la propiedad DataSource, pero deberá llamar explícitamente al método DataBind del control enlazado a datos. Algunos ejemplos de controles enlazados a datos que puede utilizar SqlDataSource son DataGrid, DetailsView, DataList y DropDownList. Puede llamar en cualquier momento al método Select mediante programación para recuperar los datos de la base de datos subyacente.

En escenarios de declaración y programación ASP.NET, puede establecer la propiedad DataSourceID del control enlazado a datos en el Id. del control SqlDataSource. También puede asignar una instancia de la clase SqlDataSource a la propiedad DataSource del control enlazado a datos. Para obtener más información sobre cómo enlazar el control enlazado a datos a los controles de origen de datos, vea Información general sobre el acceso a datos en ASP.NET.

Dependiendo de las capacidades del producto de base de datos subyacente y de la configuración de la instancia de la clase SqlDataSource, puede realizar operaciones de datos tales como actualizaciones, inserciones y eliminaciones. Para realizar estas operaciones de datos, establezca el texto de comando adecuado y cualquier parámetro asociado para la operación que desee realizar. Por ejemplo, para una operación de actualización, establezca la propiedad UpdateCommand en una cadena SQL o en el nombre de un procedimiento almacenado y agregue los parámetros necesarios a la colección UpdateParameters. La actualización se realiza cuando se llama al método Update, explícitamente mediante código o automáticamente mediante un control enlazado a datos. El mismo modelo general se sigue para las operaciones Delete y Insert.

Las consultas y comandos SQL que utilice en las propiedades SelectCommand, UpdateCommand, InsertCommand y DeleteCommand se pueden parametrizar. Esto significa que la consulta o comando puede utilizar marcadores de posición en lugar de valores literales y enlazar los marcadores de posición a variables definidas de aplicación o definidas por el usuario. Puede enlazar parámetros de series SQL a variables de sesión, valores que se pasan en la cadena de consulta a una página de formularios Web Forms, valores de propiedades de otros controles de servidor, y más. Para obtener más información sobre cómo utilizar los parámetros en consultas SQL con el control SqlDataSource, vea Utilizar parámetros con controles de origen de datos, Utilizar parámetros con el control SqlDataSource y Utilizar parámetros con el control SqlDataSource

De manera predeterminada, el control SqlDataSource funciona con el proveedor de datos de .NET Framework para SQL Server, pero SqlDataSource no es específico de Microsoft SQL Server. Puede conectar el control SqlDataSource con cualquier producto de base de datos para el que haya un proveedor de ADO.NET administrado. Cuando se utiliza con el proveedor System.Data.OleDb, el control SqlDataSource puede trabajar con cualquier base de datos compatible con OLE DB. Cuando se utiliza con el proveedor System.Data.Odbc, el control SqlDataSource se puede utilizar con cualquier controlador y base de datos ODBC, incluidas IBM DB2, MySQL y PostgreSQL. Cuando se utiliza con el proveedor System.Data.OracleClient, SqlDataSource puede trabajar con bases de datos de Oracle 8.1.7 y posteriores. La lista de proveedores permitidos se registra en la sección DbProviderFactories del archivo de configuración, o en el archivo Machine.config o Web.config. Para obtener más información, vea Seleccionar datos mediante el control SqlDataSource.

Si muestra datos en la página utilizando un control SqlDataSource, puede aumentar el rendimiento de la página con las capacidades de almacenamiento en caché de datos del control de origen de datos. El almacenamiento en caché reduce la carga de procesamiento en los servidores de base de datos a expensas de la memoria del servidor Web; en la mayoría de los casos, es un intercambio favorable. El control SqlDataSource almacena los datos en memoria caché automáticamente cuando la propiedad EnableCaching está establecida en true y la propiedad CacheDuration está establecida en el número de segundos durante los cuales la memoria caché almacena datos antes de descartar la entrada de caché. También puede especificar un valor CacheExpirationPolicy y un valor SqlCacheDependency opcional.

El control SqlDataSource proporciona funciones adicionales, como se muestra en la tabla siguiente.

Función

Requisitos

Almacenamiento en caché

Establezca la propiedad DataSourceMode en el valor DataSet, la propiedad EnableCaching en true, y las propiedades CacheDuration y CacheExpirationPolicy de acuerdo con el comportamiento de caché que desee para los datos almacenados en caché.

Eliminación

Establezca la propiedad DeleteCommand en una instrucción SQL utilizada para eliminar datos. Esta instrucción suele parametrizarse.

Filtración

Establezca la propiedad DataSourceMode en el valor DataSet. Establezca la propiedad FilterExpression en una expresión de filtrado utilizada para filtrar los datos cuando se llama al método Select.

Inserción

Establezca la propiedad InsertCommand en una instrucción SQL utilizada para insertar datos. Esta instrucción suele parametrizarse.

Paginación

Actualmente, el control SqlDataSource no la admite; sin embargo, algunos controles enlazados a datos, tales como GridView, admiten la paginación cuando se establece la propiedad DataSourceMode en el valor DataSet.

Selección

Establezca la propiedad SelectCommand en una instrucción SQL utilizada para recuperar datos.

Ordenación

Establezca la propiedad DataSourceMode en DataSet.

Actualización

Establezca la propiedad UpdateCommand en una instrucción SQL utilizada para actualizar datos. Esta instrucción suele parametrizarse.

Como ocurre con todos los controles de origen de datos, el control SqlDataSource se asocia a una clase de vista de origen de datos. El control SqlDataSource sólo tiene una SqlDataSourceView asociada y siempre se denomina Table.

No hay representación visual del control SqlDataSource; se implementa como un control para que pueda crearlo mediante declaración y, opcionalmente, para permitirle participar en la administración de estados. Por consiguiente, el control SqlDataSource no admite las características visuales, como las proporcionadas por las propiedades EnableTheming o SkinID.

TemaUbicación
Cómo: Conectar con una base de datos de Oracle mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Personalizar controles para la edición en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantilla en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear páginas Web principal-detalle en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos ODBC mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Ordenación simple del control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Editar e insertar datos en páginas Web con el control de servidor Web DetailsViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos jerárquicos en un control TreeViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Acceso a datos básico en páginas WebGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar y dar formato a datos con el control de servidor Web DataListGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Proteger cadenas de conexión al utilizar controles de orígenes de datos (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos con formato en páginas Web con el control de servidor Web FormViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles Repeater de servidor Web a una página de formularios Web Forms (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar una lista desplegable mientras se edita en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar el filtrado para los controles SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos mediante un procedimiento almacenado en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos de Access mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos de SQL Server mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Acceso a datos básico en páginas WebGenerar aplicaciones con Visual Web Developer
Tutorial: Mostrar una lista desplegable mientras se edita en el control de servidor Web GridViewGenerar aplicaciones con Visual Web Developer
Tutorial: Crear páginas Web principal-detalle en Visual StudioGenerar aplicaciones con Visual Web Developer
Tutorial: Ordenación simple del control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Mostrar anuncios desde una base de datos mediante el control AdRotator de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Editar e insertar datos en páginas Web con el control de servidor Web DetailsViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Personalizar controles para la edición en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Permitir a los usuarios eliminar elementos en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos de Access mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos de Oracle mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos jerárquicos en un control TreeViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar y dar formato a datos con el control de servidor web DataListGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos de SQL Server mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Proteger cadenas de conexión al utilizar controles de origen de datosGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos con formato en páginas web con el control de servidor web FormViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles Repeater de servidor web a una página de formularios Web FormsGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantillaGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar una lista desplegable mientras se edita en el control de servidor web GridViewdv_vwdcon
Cómo: Habilitar el filtrado para el control SqlDataSourceGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos mediante un procedimiento almacenado en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Obtener acceso a SQL Server como usuario localGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Obtener acceso a SQL Server mediante un usuario de dominio Windows asignadoGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantilla en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos ODBC mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Mostrar anuncios desde una base de datos mediante el control AdRotator de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Permitir a los usuarios eliminar elementos en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Conectar con una base de datos Oracle mediante el control SqlDataSourceGenerar aplicaciones Web ASP .NET
Cómo: Enlazar a los datos de un control con plantillaGenerar aplicaciones Web ASP .NET
Cómo: Conectar con una base de datos de Access mediante el control SqlDataSourceGenerar aplicaciones Web ASP .NET
Cómo: Habilitar el filtrado para el control SqlDataSourceGenerar aplicaciones Web ASP .NET
Cómo: Proteger cadenas de conexión al utilizar controles de orígenes de datosGenerar aplicaciones Web ASP .NET
Cómo: Conectar con una base de datos ODBC mediante el control SqlDataSourceGenerar aplicaciones Web ASP .NET
Cómo: Conectar con una base de datos de SQL Server mediante el control SqlDataSourceGenerar aplicaciones Web ASP .NET
Cómo: Obtener acceso a SQL Server como usuario localGenerar aplicaciones Web ASP .NET
Cómo: Obtener acceso a SQL Server mediante un usuario de dominio Windows asignadoGenerar aplicaciones Web ASP .NET
Tutorial: Ordenación simple del control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Mostrar anuncios desde una base de datos mediante el control AdRotator de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Editar e insertar datos en páginas Web con el control de servidor Web DetailsViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Personalizar controles para la edición en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Permitir a los usuarios eliminar elementos en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos de Access mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos de Oracle mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos jerárquicos en un control TreeViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar y dar formato a datos con el control de servidor web DataListGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos de SQL Server mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Proteger cadenas de conexión al utilizar controles de origen de datosGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos con formato en páginas web con el control de servidor web FormViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles Repeater de servidor web a una página de formularios Web FormsGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantillaGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar el filtrado para el control SqlDataSourceGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos mediante un procedimiento almacenado en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Obtener acceso a SQL Server como usuario localGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Obtener acceso a SQL Server mediante un usuario de dominio Windows asignadoGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantilla en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos ODBC mediante el control SqlDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio

Esta sección contiene cuatro ejemplos de código:

  • El primer ejemplo de código muestra cómo mostrar datos de SQL Server en un control GridView utilizando sintaxis declarativa.

  • El segundo ejemplo de código muestra cómo mostrar datos de una base de datos compatible con ODBC en un control GridView utilizando sintaxis declarativa.

  • El tercer ejemplo de código muestra cómo mostrar y actualizar datos en un control GridView.

  • El cuarto ejemplo de código muestra cómo mostrar y actualizar datos en un control DropDownList.

En el ejemplo de código siguiente se muestra cómo utilizar un control SqlDataSource mediante declaración para recuperar datos de SQL Server y mostrarlos en un control GridView.

<!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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<!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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

En el ejemplo de código siguiente se muestra cómo utilizar un control SqlDataSource mediante declaración para recuperar datos de una base de datos compatible con ODBC y mostrarlos en un control GridView. La propiedad ProviderName es el nombre del proveedor de datos de .NET Framework para ODBC, que es System.Data.Odbc.

<!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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<!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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

El ejemplo de código siguiente muestra un escenario común de presentación y actualización con el control GridView. Como con los ejemplos anteriores, en el control GridView se muestran datos de la base de datos Northwind. Además, dado que se especifica una propiedad UpdateCommand y que la propiedad AutoGenerateEditButton está establecida en true, puede editar y actualizar los registros sin código adicional. El control GridView controla automáticamente la adición de parámetros a la colección UpdateParameters y llama al método Update cuando se hace clic en el botón Actualizar del control GridView.

<!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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </asp:GridView>

    </form>
  </body>
</html>

<!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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <Columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </Columns>

      </asp:GridView>

    </form>
  </body>
</html>

El ejemplo de código siguiente muestra un escenario común de presentación y actualización con los controles DropDownList y TextBox. El control DropDownList no agrega automáticamente los parámetros de actualización a la colección UpdateParameters ni llama al método Update, por lo tanto, deberá hacerlo el propio usuario. Los parámetros de actualización se especifican mediante declaración y puede agregar un controlador de eventos para realizar la operación Update cuando se provoca un evento.

Nota de seguridadNota: de seguridad

En este ejemplo se incluye un cuadro de texto que acepta datos del usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas Web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de secuencia de comandos. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 private void On_Click(Object source, EventArgs e) {
    try {
        SqlDataSource1.Update();
    }
    catch (Exception except) {
        // Handle the Exception.
    }

    Label2.Text="The record was updated successfully!";
 }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />

    </form>
  </body>
</html>

<%@Page  Language="VJ#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 private void On_Click(Object source, System.EventArgs e)
 {
    try {
       SqlDataSource1.Update();
    }
    catch (Exception except) {
        // Handle the Exception.
    }
    Label2.set_Text("The record was updated successfully!");
 } //On_Click
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />

    </form>
  </body>
</html>

System.Object
   System.Web.UI.Control
     System.Web.UI.DataSourceControl
      System.Web.UI.WebControls.SqlDataSource
         System.Web.UI.WebControls.AccessDataSource

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar:
© 2015 Microsoft