SqlDataSource Clase
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í.
Representa una base de datos SQL para controles enlazados a datos.
public ref class SqlDataSource : System::Web::UI::DataSourceControl
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.SqlDataSource))]
public class SqlDataSource : System.Web.UI.DataSourceControl
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.SqlDataSource))>]
type SqlDataSource = class
inherit DataSourceControl
Public Class SqlDataSource
Inherits DataSourceControl
- Herencia
- Derivado
- Atributos
Ejemplos
Esta sección contiene cuatro ejemplos de código:
En el primer ejemplo de código se muestra cómo mostrar datos de SQL Server en un control mediante la GridView sintaxis declarativa.
En el segundo ejemplo de código se muestra cómo mostrar datos de una base de datos compatible con ODBC en un GridView control mediante la sintaxis declarativa.
En el tercer ejemplo de código se muestra cómo mostrar y actualizar datos en un GridView control .
En el cuarto ejemplo de código se muestra cómo mostrar y actualizar datos en un DropDownList control .
Nota
En estos ejemplos se muestra cómo usar la sintaxis declarativa para el acceso a datos. Para obtener información sobre cómo acceder a los datos mediante código en lugar de marcado, consulte Acceso a datos en Visual Studio.
En el ejemplo de código siguiente se muestra cómo usar un SqlDataSource control mediante declaración para recuperar datos de SQL Server y mostrarlos en un GridView control.
<%@ 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 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>
<%@ 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 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>
En el ejemplo de código siguiente se muestra cómo usar un SqlDataSource control mediante declaración para recuperar datos de una base de datos compatible con ODBC y mostrarlos en un GridView control . La ProviderName propiedad es el nombre del proveedor de datos de .NET Framework para ODBC, que es System.Data.Odbc.
<%@ 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 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>
<%@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 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>
En el ejemplo de código siguiente se muestra un escenario común de visualización y actualización con el GridView control . Al igual que con los ejemplos anteriores, los datos de la base de datos Northwind se muestran en el GridView control . Además, dado que se especifica una UpdateCommand propiedad y la AutoGenerateEditButton propiedad se establece true
en , puede editar y actualizar los registros sin código adicional. El GridView control controla automáticamente la adición de parámetros a la UpdateParameters colección y llama al Update método cuando se hace clic en el botón Actualizar del GridView control.
<%@ 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 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>
<%@ 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 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>
En el ejemplo de código siguiente se muestra un escenario común de visualización y actualización con los DropDownList controles y TextBox . El DropDownList control no agrega automáticamente parámetros de actualización a la UpdateParameters colección ni llama al Update método , por lo que debe hacerlo. Los parámetros de actualización se especifican mediante declaración y se puede agregar un controlador de eventos para realizar la Update operación cuando se genera un evento.
Importante
En este ejemplo se incluye un cuadro de texto que acepta la entrada del usuario, que es una amenaza de seguridad potencial. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.
<%@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="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub On_Click(ByVal source As Object, ByVal e As EventArgs)
Try
SqlDataSource1.Update()
Catch except As Exception
' Handle the Exception.
End Try
Label2.Text="The record was updated successfully!"
End Sub '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="<%$ 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>
Comentarios
En este tema:
Introducción
El SqlDataSource control de origen de datos representa los datos de una base de datos relacional de SQL a los controles enlazados a datos. Puede usar el SqlDataSource control 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 o ningún código.
Conexiones de datos
Para conectarse a una base de datos, debe establecer la ConnectionString propiedad en una cadena de conexión válida.
SqlDataSource puede admitir cualquier base de datos relacional de SQL a la que se pueda conectar mediante un proveedor de ADO.NET, como el SqlClient
proveedor , OleDb
, Odbc
o OracleClient
. Para obtener información sobre cómo proteger las cadenas de conexión, vea How To: Secure Connection Strings when Using Data Source Controls.
Para recuperar datos de una base de datos subyacente, establezca la SelectCommand propiedad con una consulta SQL. Si la base de datos SqlDataSource asociada a admite procedimientos almacenados, puede establecer la SelectCommand propiedad en el nombre de un procedimiento almacenado. La consulta SQL que especifique también puede ser una consulta con parámetros. Puede agregar Parameter objetos asociados a una consulta con parámetros a la SelectParameters colección. Para obtener más información sobre las consultas SQL con parámetros y su sintaxis, consulte Uso de parámetros con controles de origen de datos para filtrar.
El SqlDataSource control recupera datos cada vez que se llama al Select método . Este método proporciona acceso mediante programación al método especificado por SelectMethod la propiedad . Los Select controles que se enlazan a cuando DataBind se llama al método llaman automáticamente al SqlDataSource método . Si establece la DataSourceID propiedad 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 DataSourceID
propiedad es el método recomendado para enlazar un ObjectDataSource control a un control enlazado a datos. Como alternativa, puede usar la DataSource
propiedad , pero después debe llamar explícitamente al DataBind método del control enlazado a datos. Algunos ejemplos de controles enlazados a datos que pueden usar SqlDataSource son DataGrid, DetailsView, DataListy DropDownList. Puede llamar al Select método mediante programación en cualquier momento para recuperar datos de la base de datos subyacente.
En escenarios de ASP.NET declarativos y mediante programación, puede establecer la DataSourceID propiedad del control enlazado a datos en el identificador del SqlDataSource control. También puede asignar una instancia de la SqlDataSource clase a la DataSource propiedad 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, consulte ASP.NET Opciones de acceso a datos.
Realizar operaciones de datos
Dependiendo de las funcionalidades del producto de base de datos subyacente y de la configuración de la instancia de la SqlDataSource clase, puede realizar operaciones de datos, como actualizaciones, inserciones y eliminaciones. Para realizar estas operaciones de datos, establezca el texto del comando adecuado y los parámetros asociados para la operación que desea realizar. Por ejemplo, para una operación de actualización, establezca la UpdateCommand propiedad en una cadena SQL o el nombre de un procedimiento almacenado y agregue los parámetros necesarios a la UpdateParameters colección. La actualización se realiza cuando se llama al Update método, ya sea explícitamente por el código o automáticamente por un control enlazado a datos. Se sigue el mismo patrón general para Delete las operaciones y Insert .
Las consultas y comandos SQL que se usan en las SelectCommandpropiedades , UpdateCommand, InsertCommandy DeleteCommand se pueden parametrizar. Esto significa que la consulta o el comando pueden usar marcadores de posición en lugar de valores literales y enlazar los marcadores de posición a variables definidas por el usuario o de la aplicación. Puede enlazar parámetros en consultas SQL a variables de sesión, valores que se pasan en la cadena de consulta de una página de Formularios Web Forms, los valores de propiedad de otros controles de servidor, etc. Para obtener más información sobre cómo usar parámetros en consultas SQL con SqlDataSource, vea Uso de parámetros con controles de origen de datos para filtrar y usar parámetros con el control SqlDataSource.
Nota
De forma predeterminada, si uno de los parámetros es null
cuando se ejecuta un Select
comando, no se devolverá ningún dato y no se producirá ninguna excepción. Puede cambiar este comportamiento estableciendo la CancelSelectOnNullParameter propiedad en false
.
Proveedor de datos
De forma predeterminada, el SqlDataSource control 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 SqlDataSource control con cualquier producto de base de datos para el que haya un proveedor de ADO.NET administrado. Cuando se usa con el System.Data.OleDb proveedor, SqlDataSource puede trabajar con cualquier base de datos compatible con OLE DB. Cuando se usa con el System.Data.Odbc proveedor, SqlDataSource se puede usar con cualquier controlador y base de datos ODBC, incluido IBM DB2, MySQL y PostgreSQL. Cuando se usa con el System.Data.OracleClient proveedor, SqlDataSource puede trabajar con bases de datos de Oracle 8.1.7 y versiones posteriores. La lista de proveedores permitidos se registra en la DbProviderFactories
sección del archivo de configuración, ya sea en el archivo Machine.config o Web.config. Para obtener más información, vea Seleccionar datos mediante el control SqlDataSource.
Almacenamiento en memoria caché
Si muestra datos en la página mediante un SqlDataSource control , puede aumentar el rendimiento de la página mediante las funcionalidades 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 bases de datos a costa de la memoria en el servidor web; en la mayoría de los casos, esto es un buen equilibrio. El SqlDataSource almacena automáticamente los datos cuando la EnableCaching propiedad se establece true
en y la CacheDuration propiedad se establece en el número de segundos en que la memoria caché almacena los datos antes de que se descarte la entrada de caché. También puede especificar un CacheExpirationPolicy valor opcional y SqlCacheDependency .
Características adicionales
SqlDataSource proporciona funcionalidades adicionales, como se muestra en la tabla siguiente.
Funcionalidad | Requisitos |
---|---|
Almacenamiento en memoria caché | Establezca la DataSourceMode propiedad en el DataSet valor , la EnableCaching propiedad true en y las CacheDuration propiedades y CacheExpirationPolicy según el comportamiento de almacenamiento en caché que desee para los datos almacenados en caché. |
Eliminando | Establezca la DeleteCommand propiedad en una instrucción SQL que se usa para eliminar datos. Esta instrucción se suele parametrizar. |
Filtros | Establezca la DataSourceMode propiedad en el DataSet valor . Establezca la FilterExpression propiedad en una expresión de filtrado utilizada para filtrar los datos cuando se llama al Select método . |
Inserción | Establezca la InsertCommand propiedad en una instrucción SQL que se usa para insertar datos. Esta instrucción se suele parametrizar. |
Paginación | Actualmente no es compatible con SqlDataSource, pero algunos controles enlazados a datos, como GridView, admiten la paginación al establecer la DataSourceMode propiedad en el DataSet valor. |
Seleccionar | Establezca la SelectCommand propiedad en una instrucción SQL que se usa para recuperar datos. |
Ordenar | Establezca la propiedad DataSourceMode en DataSet. |
Actualizando | Establezca la UpdateCommand propiedad en una instrucción SQL utilizada para actualizar los datos. Esta instrucción se suele parametrizar. |
Vista del origen de datos
Al igual que con todos los controles de origen de datos, el SqlDataSource control está asociado a una clase de vista del origen de datos. El SqlDataSource control tiene solo uno asociado SqlDataSourceViewy siempre se denomina Table
.
No hay representación visual del SqlDataSource control; se implementa como un control para que pueda crearlo declarativamente y, opcionalmente, para permitir que participe en la administración de estado. Como resultado, no SqlDataSource admite características visuales, como las proporcionadas por la EnableTheming propiedad o SkinID .
Sintaxis declarativa
<asp:SqlDataSource
CacheDuration="string|Infinite"
CacheExpirationPolicy="Absolute|Sliding"
CacheKeyDependency="string"
CancelSelectOnNullParameter="True|False"
ConflictDetection="OverwriteChanges|CompareAllValues"
ConnectionString="string"
DataSourceMode="DataReader|DataSet"
DeleteCommand="string"
DeleteCommandType="Text|StoredProcedure"
EnableCaching="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
FilterExpression="string"
ID="string"
InsertCommand="string"
InsertCommandType="Text|StoredProcedure"
OldValuesParameterFormatString="string"
OnDataBinding="DataBinding event handler"
OnDeleted="Deleted event handler"
OnDeleting="Deleting event handler"
OnDisposed="Disposed event handler"
OnFiltering="Filtering event handler"
OnInit="Init event handler"
OnInserted="Inserted event handler"
OnInserting="Inserting event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelected="Selected event handler"
OnSelecting="Selecting event handler"
OnUnload="Unload event handler"
OnUpdated="Updated event handler"
OnUpdating="Updating event handler"
ProviderName="string|System.Data.Odbc|System.Data.OleDb|
System.Data.OracleClient|System.Data.SqlClient|
Microsoft.SqlServerCe.Client"
runat="server"
SelectCommand="string"
SelectCommandType="Text|StoredProcedure"
SkinID="string"
SortParameterName="string"
SqlCacheDependency="string"
UpdateCommand="string"
UpdateCommandType="Text|StoredProcedure"
Visible="True|False"
>
<DeleteParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</DeleteParameters>
<FilterParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</FilterParameters>
<InsertParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</InsertParameters>
<SelectParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</SelectParameters>
<UpdateParameters>
<asp:ControlParameter
ControlID="string"
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:CookieParameter
ConvertEmptyStringToNull="True|False"
CookieName="string"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:FormParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
FormField="string"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:Parameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:ProfileParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
PropertyName="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:QueryStringParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
QueryStringField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
<asp:SessionParameter
ConvertEmptyStringToNull="True|False"
DefaultValue="string"
Direction="Input|Output|InputOutput|ReturnValue"
Name="string"
SessionField="string"
Size="integer"
Type="Empty|Object|DBNull|Boolean|Char|SByte|
Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
Single|Double|Decimal|DateTime|String"
/>
</UpdateParameters>
</asp:SqlDataSource>
Constructores
SqlDataSource() |
Inicializa una nueva instancia de la clase SqlDataSource. |
SqlDataSource(String, String) |
Inicializa una nueva instancia de la clase SqlDataSource con la cadena de conexión especificada y el comando Select. |
SqlDataSource(String, String, String) |
Inicializa una nueva instancia de la clase SqlDataSource con la cadena de conexión especificada y el comando Select. |
Propiedades
Adapter |
Obtiene el adaptador específico del explorador para el control. (Heredado de Control) |
AppRelativeTemplateSourceDirectory |
Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control. (Heredado de Control) |
BindingContainer |
Obtiene el control que contiene el enlace de datos de este control. (Heredado de Control) |
CacheDuration |
Obtiene o establece el período de tiempo, en segundos, que el control de origen de datos almacena en memoria caché los datos recuperados por el método Select(DataSourceSelectArguments). |
CacheExpirationPolicy |
Obtiene o establece el comportamiento de expiración de la memoria caché que, combinado con la duración, describe el comportamiento de almacenamiento en caché que usa el control de origen de datos. |
CacheKeyDependency |
Obtiene o establece una dependencia de clave definida por el usuario que está vinculada a todos los objetos de caché de datos creados por el control de origen de datos. Todos los objetos de caché expiran explícitamente cuando expira la clave. |
CancelSelectOnNullParameter |
Obtiene o establece un valor que indica si se ha cancelado una operación de recuperación de datos cuando algún parámetro de la colección SelectParameters se evalúa como |
ChildControlsCreated |
Obtiene un valor que indica si se han creado controles secundarios del control de servidor. (Heredado de Control) |
ClientID |
Obtiene el identificador del control de servidor generado por ASP.NET. (Heredado de DataSourceControl) |
ClientIDMode |
Esta propiedad no se utiliza para los controles de orígenes de datos. (Heredado de DataSourceControl) |
ClientIDSeparator |
Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Heredado de Control) |
ConflictDetection |
Obtiene o establece el valor que indica cómo el control SqlDataSource realiza actualizaciones y eliminaciones cuando los datos de una fila de la base de datos subyacente cambian mientras dura la operación. |
ConnectionString |
Obtiene o establece la cadena de conexión específica del proveedor de ADO.NET que utiliza el control SqlDataSource para conectarse a una base de datos subyacente. |
Context |
Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Heredado de Control) |
Controls |
Obtiene un objeto ControlCollection que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario. (Heredado de DataSourceControl) |
DataItemContainer |
Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Heredado de Control) |
DataKeysContainer |
Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Heredado de Control) |
DataSourceMode |
Obtiene o establece el modo de la recuperación de datos que utiliza el control SqlDataSource para obtener los datos. |
DeleteCommand |
Obtiene o establece la cadena de SQL que utiliza el control SqlDataSource para eliminar datos de la base de datos subyacente. |
DeleteCommandType |
Obtiene o establece un valor que indica si el texto de la propiedad DeleteCommand, es una instrucción SQL o el nombre de un procedimiento almacenado. |
DeleteParameters |
Obtiene la colección de parámetros que contiene los parámetros utilizados por la propiedad DeleteCommand desde el objeto SqlDataSourceView asociado con el control SqlDataSource. |
DesignMode |
Obtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Heredado de Control) |
EnableCaching |
Obtiene o establece un valor que indica si el control SqlDataSource está habilitado. |
EnableTheming |
Obtiene un valor que indica si el control admite temas. (Heredado de DataSourceControl) |
EnableViewState |
Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante. (Heredado de Control) |
Events |
Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Heredado de Control) |
FilterExpression |
Obtiene o establece una expresión de filtrado que se aplica cuando se llama al método Select(DataSourceSelectArguments). |
FilterParameters |
Obtiene una colección de parámetros que están asociados a los marcadores de posición de parámetros de la cadena FilterExpression. |
HasChildViewState |
Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista. (Heredado de Control) |
ID |
Obtiene o establece el identificador de programación asignado al control de servidor. (Heredado de Control) |
IdSeparator |
Obtiene el carácter utilizado para separar los identificadores de control. (Heredado de Control) |
InsertCommand |
Obtiene o establece la cadena de SQL que utiliza el control SqlDataSource para insertar datos en la base de datos subyacente. |
InsertCommandType |
Obtiene o establece un valor que indica si el texto de la propiedad InsertCommand, es una instrucción SQL o el nombre de un procedimiento almacenado. |
InsertParameters |
Obtiene la colección de parámetros que contiene los parámetros utilizados por la propiedad InsertCommand desde el objeto SqlDataSourceView asociado con el control SqlDataSource. |
IsChildControlStateCleared |
Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Heredado de Control) |
IsTrackingViewState |
Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Heredado de Control) |
IsViewStateEnabled |
Obtiene un valor que indica si el estado de vista está habilitado para este control. (Heredado de Control) |
LoadViewStateByID |
Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice. (Heredado de Control) |
NamingContainer |
Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad ID. (Heredado de Control) |
OldValuesParameterFormatString |
Obtiene o establece una cadena de formato para aplicar a los nombres de cualquier parámetro que se pase al método Delete() o Update(). |
Page |
Obtiene una referencia a la instancia Page que contiene el control de servidor. (Heredado de Control) |
Parent |
Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Heredado de Control) |
ProviderName |
Obtiene o establece el nombre del proveedor de datos de .NET Framework que utiliza el control SqlDataSource para conectar a un origen de datos subyacente. |
RenderingCompatibility |
Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Heredado de Control) |
SelectCommand |
Obtiene o establece la cadena de SQL que utiliza el control SqlDataSource para recuperar datos de la base de datos subyacente. |
SelectCommandType |
Obtiene o establece un valor que indica si el texto de la propiedad SelectCommand, es una consulta SQL o el nombre de un procedimiento almacenado. |
SelectParameters |
Obtiene la colección de parámetros que contiene los parámetros utilizados por la propiedad SelectCommand desde el objeto SqlDataSourceView asociado con el control SqlDataSource. |
Site |
Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño. (Heredado de Control) |
SkinID |
Obtiene la máscara que se va a aplicar al control DataSourceControl. (Heredado de DataSourceControl) |
SortParameterName |
Obtiene o establece el nombre de un parámetro de procedimiento almacenado que se usa para ordenar los datos recuperados cuando la recuperación de datos se realiza mediante un procedimiento almacenado. |
SqlCacheDependency |
Obtiene o establece una cadena delimitada por puntos y comas que indica las bases de datos y las tablas que deben utilizarse para la dependencia de caché de Microsoft SQL Server. |
TemplateControl |
Obtiene o establece una referencia a la plantilla que contiene este control. (Heredado de Control) |
TemplateSourceDirectory |
Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Heredado de Control) |
UniqueID |
Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Heredado de Control) |
UpdateCommand |
Obtiene o establece la cadena de SQL que utiliza el control SqlDataSource para actualizar datos en la base de datos subyacente. |
UpdateCommandType |
Obtiene o establece un valor que indica si el texto de la propiedad UpdateCommand, es una instrucción SQL o el nombre de un procedimiento almacenado. |
UpdateParameters |
Obtiene la colección de parámetros que contiene los parámetros utilizados por la propiedad UpdateCommand desde el objeto SqlDataSourceView asociado con el control SqlDataSource. |
ValidateRequestMode |
Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos. (Heredado de Control) |
ViewState |
Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página. (Heredado de Control) |
ViewStateIgnoresCase |
Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Heredado de Control) |
ViewStateMode |
Obtiene o establece el modo del estado de vista de este control. (Heredado de Control) |
Visible |
Obtiene o establece un valor que indica si el control se muestra gráficamente. (Heredado de DataSourceControl) |
Métodos
AddedControl(Control, Int32) |
Se llama después de agregar un control secundario a la colección Controls del objeto Control. (Heredado de Control) |
AddParsedSubObject(Object) |
Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor. (Heredado de Control) |
ApplyStyleSheetSkin(Page) |
Aplica al control las propiedades de estilo definidas en la hoja de estilos de página. (Heredado de DataSourceControl) |
BeginRenderTracing(TextWriter, Object) |
Comienza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control) |
BuildProfileTree(String, Boolean) |
Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página. (Heredado de Control) |
ClearCachedClientID() |
Establece en |
ClearChildControlState() |
Elimina la información sobre el estado de control de los controles secundarios del control de servidor. (Heredado de Control) |
ClearChildState() |
Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor. (Heredado de Control) |
ClearChildViewState() |
Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Heredado de Control) |
ClearEffectiveClientIDMode() |
Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Heredado de Control) |
CreateChildControls() |
Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos. (Heredado de Control) |
CreateControlCollection() |
Crea una colección para almacenar controles secundarios. (Heredado de DataSourceControl) |
CreateDataSourceView(String) |
Crea un objeto de vista de origen de datos que se asocia al control de origen de datos. |
DataBind() |
Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios. (Heredado de Control) |
DataBind(Boolean) |
Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding. (Heredado de Control) |
DataBindChildren() |
Enlaza un origen de datos a los controles secundarios del control de servidor. (Heredado de Control) |
Delete() |
Realiza una operación de eliminación mediante la cadena SQL DeleteCommand SQL y cualquier parámetro que esté en la colección DeleteParameters. |
Dispose() |
Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Heredado de Control) |
EndRenderTracing(TextWriter, Object) |
Finaliza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control) |
EnsureChildControls() |
Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Heredado de Control) |
EnsureID() |
Crea un identificador para controles que no tiene un identificador asignado. (Heredado de Control) |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
FindControl(String) |
Busca un control de servidor con el parámetro |
FindControl(String, Int32) |
Busca el contenedor de nomenclatura actual para un control de servidor con el |
Focus() |
Establece el foco de entrada en el control. (Heredado de DataSourceControl) |
GetDbProviderFactory() |
Devuelve el objeto DbProviderFactory asociado con el proveedor de ADO.NET identificado por la propiedad ProviderName. |
GetDesignModeState() |
Obtiene datos en tiempo de diseño para un control. (Heredado de Control) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetRouteUrl(Object) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control) |
GetRouteUrl(RouteValueDictionary) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control) |
GetRouteUrl(String, Object) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control) |
GetRouteUrl(String, RouteValueDictionary) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
GetUniqueIDRelativeTo(Control) |
Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Heredado de Control) |
GetView(String) |
Obtiene la vista de origen de datos con nombre asociada al control de origen de datos. |
GetViewNames() |
Obtiene una colección de nombres que representa la lista de objetos de vista asociados al control SqlDataSource. |
HasControls() |
Determina si el control de servidor contiene controles secundarios. (Heredado de DataSourceControl) |
HasEvents() |
Devuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Heredado de Control) |
Insert() |
Realiza una operación de inserción mediante la cadena SQL InsertCommand SQL y cualquier parámetro que esté en la colección InsertParameters. |
IsLiteralContent() |
Determina si el control de servidor alberga únicamente contenido literal. (Heredado de Control) |
LoadControlState(Object) |
Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState(). (Heredado de Control) |
LoadViewState(Object) |
Carga el estado de las propiedades en el control SqlDataSource que deban conservarse. |
MapPathSecure(String) |
Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Heredado de Control) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
OnBubbleEvent(Object, EventArgs) |
Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página. (Heredado de Control) |
OnDataBinding(EventArgs) |
Genera el evento DataBinding. (Heredado de Control) |
OnInit(EventArgs) |
Agrega un controlador de eventos LoadComplete al control Page que contiene el control SqlDataSource. |
OnLoad(EventArgs) |
Genera el evento Load. (Heredado de Control) |
OnPreRender(EventArgs) |
Genera el evento PreRender. (Heredado de Control) |
OnUnload(EventArgs) |
Genera el evento Unload. (Heredado de Control) |
OpenFile(String) |
Obtiene un objeto Stream utilizado para leer un archivo. (Heredado de Control) |
RaiseBubbleEvent(Object, EventArgs) |
Asigna los orígenes del evento y su información al control principal del control. (Heredado de Control) |
RaiseDataSourceChangedEvent(EventArgs) |
Genera el evento DataSourceChanged. (Heredado de DataSourceControl) |
RemovedControl(Control) |
Se llama después de quitar un control secundario de la colección Controls del objeto Control. (Heredado de Control) |
Render(HtmlTextWriter) |
Envía el contenido del control de servidor al objeto HtmlTextWriter proporcionado, que escribe el contenido que se representará en el cliente. (Heredado de Control) |
RenderChildren(HtmlTextWriter) |
Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente. (Heredado de Control) |
RenderControl(HtmlTextWriter) |
Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento. (Heredado de DataSourceControl) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado. (Heredado de Control) |
ResolveAdapter() |
Obtiene el adaptador de controles que se encarga de representar el control especificado. (Heredado de Control) |
ResolveClientUrl(String) |
Obtiene una dirección URL que el explorador puede utilizar. (Heredado de Control) |
ResolveUrl(String) |
Convierte una dirección URL en una que el cliente solicitante pueda utilizar. (Heredado de Control) |
SaveControlState() |
Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor. (Heredado de Control) |
SaveViewState() |
Guarda el estado de vista actual del control SqlDataSource. |
Select(DataSourceSelectArguments) |
Recupera los datos de la base de datos subyacente utilizando la cadena SQL SelectCommand y cualquier parámetro que esté en la colección SelectParameters. |
SetDesignModeState(IDictionary) |
Establece los datos en tiempo de diseño para un control. (Heredado de Control) |
SetRenderMethodDelegate(RenderMethod) |
Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal. (Heredado de Control) |
SetTraceData(Object, Object) |
Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento. (Heredado de Control) |
SetTraceData(Object, Object, Object) |
Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento. (Heredado de Control) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
TrackViewState() |
Efectúa el seguimiento de los cambios en el estado de vista del control SqlDataSource para poder almacenarlos en el objeto StateBag del control. |
Update() |
Realiza una operación de actualización mediante la cadena SQL UpdateCommand SQL y cualquier parámetro que esté en la colección UpdateParameters. |
Eventos
DataBinding |
Se produce cuando el control de servidor se enlaza a un origen de datos. (Heredado de Control) |
Deleted |
Tiene lugar cuando se termina una operación de eliminación. |
Deleting |
Tiene lugar antes de una operación de eliminación. |
Disposed |
Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET. (Heredado de Control) |
Filtering |
Se produce antes de una operación de filtrado. |
Init |
Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Heredado de Control) |
Inserted |
Tiene lugar cuando se termina una operación de inserción. |
Inserting |
Tiene lugar antes de una operación de inserción. |
Load |
Se produce cuando el control de servidor se carga en el objeto Page. (Heredado de Control) |
PreRender |
Se produce una vez que se carga el objeto Control, pero antes de su representación. (Heredado de Control) |
Selected |
Tiene lugar cuando se termina una operación de recuperación de datos. |
Selecting |
Tiene lugar antes de una operación de recuperación de datos. |
Unload |
Se produce cuando el control de servidor se descarga de la memoria. (Heredado de Control) |
Updated |
Tiene lugar cuando se termina una operación de actualización. |
Updating |
Tiene lugar antes de una operación de actualización. |
Implementaciones de interfaz explícitas
IControlBuilderAccessor.ControlBuilder |
Para obtener una descripción de este miembro, vea ControlBuilder. (Heredado de Control) |
IControlDesignerAccessor.GetDesignModeState() |
Para obtener una descripción de este miembro, vea GetDesignModeState(). (Heredado de Control) |
IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary). (Heredado de Control) |
IControlDesignerAccessor.SetOwnerControl(Control) |
Para obtener una descripción de este miembro, vea SetOwnerControl(Control). (Heredado de Control) |
IControlDesignerAccessor.UserData |
Para obtener una descripción de este miembro, vea UserData. (Heredado de Control) |
IDataBindingsAccessor.DataBindings |
Para obtener una descripción de este miembro, vea DataBindings. (Heredado de Control) |
IDataBindingsAccessor.HasDataBindings |
Para obtener una descripción de este miembro, vea HasDataBindings. (Heredado de Control) |
IDataSource.DataSourceChanged |
Se produce cuando un control de origen de datos ha cambiado de modo que afecta a los controles enlazados a datos. (Heredado de DataSourceControl) |
IDataSource.GetView(String) |
Obtiene el objeto DataSourceView con nombre asociado al control DataSourceControl. Ciertos controles de origen de datos sólo admiten una vista, mientras que otros admiten más de una. (Heredado de DataSourceControl) |
IDataSource.GetViewNames() |
Obtiene una colección de nombres, que representa la lista de objetos DataSourceView asociados al control DataSourceControl. (Heredado de DataSourceControl) |
IExpressionsAccessor.Expressions |
Para obtener una descripción de este miembro, vea Expressions. (Heredado de Control) |
IExpressionsAccessor.HasExpressions |
Para obtener una descripción de este miembro, vea HasExpressions. (Heredado de Control) |
IListSource.ContainsListCollection |
Indica si el control de origen de datos está asociado a una o varias listas de datos. (Heredado de DataSourceControl) |
IListSource.GetList() |
Obtiene una lista de controles de origen de datos que pueden utilizarse como orígenes de listas de datos. (Heredado de DataSourceControl) |
IParserAccessor.AddParsedSubObject(Object) |
Para obtener una descripción de este miembro, vea AddParsedSubObject(Object). (Heredado de Control) |
Métodos de extensión
FindDataSourceControl(Control) |
Devuelve el origen de datos que está asociado al control de datos del control especificado. |
FindFieldTemplate(Control, String) |
Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado. |
FindMetaTable(Control) |
Devuelve el objeto de metatabla para el control de datos contenedor. |
GetDefaultValues(IDataSource) |
Obtiene la colección de los valores predeterminados para el origen de datos especificado. |
GetMetaTable(IDataSource) |
Obtiene los metadatos para una tabla en el objeto de origen de datos especificado. |
TryGetMetaTable(IDataSource, MetaTable) |
Determina si están disponibles los metadatos de la tabla. |