SqlDataSourceView Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

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í.

Admite el control SqlDataSource y proporciona una interfaz para que los controles enlazados a datos realicen operaciones de datos SQL en bases de datos relacionales.

public ref class SqlDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class SqlDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type SqlDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class SqlDataSourceView
Inherits DataSourceView
Implements IStateManager

Herencia: Object

DataSourceView
SqlDataSourceView

Derivado: System.Web.UI.WebControls.AccessDataSourceView

Implementaciones: IStateManager

Comentarios

La SqlDataSourceView clase está pensada principalmente para ser utilizada por controles enlazados a datos y no como un objeto programable en el código de página.

ASP.NET controles de origen de datos contienen una o varias listas de datos, representadas por objetos de vista del origen de datos. La SqlDataSourceView clase extiende la DataSourceView clase , define las funciones del control con el SqlDataSource que está asociado e implementa la funcionalidad de datos básica para el control de origen de datos. La SqlDataSourceView clase implementa la funcionalidad de datos para el SqlDataSource control, incluidas las Selectoperaciones , Update, Insert, y Delete , la ordenación, el filtrado y la administración de la configuración que se mantienen en estado de vista.

Aunque el control no expone directamente el SqlDataSourceView objeto a los desarrolladores SqlDataSource de páginas, muchas de sus propiedades son. La operación más básica que realiza una vista del origen de datos es la recuperación de datos de la base de datos subyacente mediante el Select método , que recupera una IEnumerable colección de elementos de datos. La SqlDataSourceView clase implementa la recuperación de datos de bases de datos relacionales mediante consultas SQL. Las consultas SQL se pueden parametrizar para mayor flexibilidad y seguridad. Los siguientes métodos de recuperación de datos, propiedades y eventos se implementan mediante SqlDataSourceView y se exponen directamente mediante su SqlDataSource control a desarrolladores de páginas y otros autores de llamadas:

La propiedad SelectCommand
La propiedad SelectParameters
Al evento Selecting
Al evento Selected

El SqlDataSourceView objeto admite la actualización de datos en una base de datos relacional mediante comandos SQL. Los comandos SQL se pueden parametrizar para mayor flexibilidad y seguridad. Los controles enlazados a datos, como y GridView DetailsView, se pueden configurar para realizar actualizaciones automáticamente mediante , SqlDataSourceViewmientras que otros controles no pueden. Los siguientes métodos de actualización, propiedades y eventos se implementan mediante y SqlDataSourceView se exponen directamente mediante su SqlDataSource control a los desarrolladores de páginas y a otros autores de llamadas:

La propiedad UpdateCommand
La propiedad UpdateParameters
Al evento Updating
Al evento Updated

SqlDataSourceView admite la inserción de nuevas filas de datos en una base de datos relacional. Los comandos SQL especificados en la InsertCommand propiedad se pueden parametrizar para obtener una mayor flexibilidad y seguridad. Los controles enlazados a datos, como y GridView DetailsView, se pueden configurar para realizar inserciones automáticamente mediante SqlDataSourceView, mientras que otros controles no. Los siguientes métodos de inserción, propiedades y eventos se implementan mediante y SqlDataSourceView se exponen directamente mediante su SqlDataSource control a los desarrolladores de páginas y a otros autores de llamadas:

La propiedad InsertCommand
La propiedad InsertParameters
Al evento Inserting
Al evento Inserted

El SqlDataSourceView objeto también admite la eliminación de datos de una base de datos relacional. Al igual que con otros comandos, los comandos SQL especificados en la DeleteCommand propiedad se pueden parametrizar para mayor flexibilidad y seguridad. Los controles enlazados a datos, como y GridView DetailsView, se pueden configurar para realizar eliminaciones automáticamente mediante SqlDataSourceView, mientras que otros controles no. Los siguientes métodos de eliminación, propiedades y eventos se implementan mediante y SqlDataSourceView se exponen directamente mediante su SqlDataSource control a los desarrolladores de páginas y a otros autores de llamadas:

La propiedad DeleteCommand
La propiedad DeleteParameters
Al evento Deleting
Al evento Deleted

La recuperación de datos es más eficaz cuando la cláusula que se usa para filtrar los datos durante la recuperación de datos es dinámica. Es decir, una consulta SQL con una cláusula WHERE estática no es tan flexible y eficaz como una consulta SQL donde los valores de la cláusula WHERE están enlazados a valores que pueden cambiar, como los valores que se muestran en los controles de una página de formularios Web Forms. En lugar de volver a generar una consulta SQL y establecer la SelectCommand propiedad en cada carga de página, puede usar las FilterExpression propiedades y FilterParameters para aplicar el filtrado dinámico a la recuperación de datos. Estas propiedades se implementan mediante y SqlDataSourceView se exponen directamente mediante su SqlDataSource control a controles enlazados a datos y a otros autores de llamadas.

Puede ordenar los datos que recupera con el SqlDataSource control agregando una cláusula ORDER BY, lo que hace que la base de datos realice el orden para usted cuando recupere datos o ordene los datos en la memoria después de recuperarlos. Puede proporcionar una expresión de ordenación a SqlDataSourceView estableciendo la SortExpression propiedad del DataSourceSelectArguments objeto que se pasa al Select método . La sintaxis de la SortExpression propiedad es la misma que la sintaxis de una DataView.Sort propiedad. Si usa un procedimiento almacenado para recuperar datos, también puede usar la SortParameterName propiedad para especificar un parámetro que se usa específicamente para ordenar los resultados de una llamada a procedimiento almacenado.

Cuando más de un usuario puede cambiar la base de datos simultáneamente, existe la posibilidad de conflictos de simultaneidad. El SqlDataSource control tiene controles de simultaneidad a través de la SqlDataSource.ConflictDetection propiedad . La funcionalidad se implementa en la SqlDataSourceView.ConflictDetection propiedad .

Al igual que muchos otros controles de servidor web, SqlDataSourceView implementa la interfaz y usa el IStateManager estado de vista para realizar un seguimiento de su estado en las solicitudes de página. Se proporcionan implementaciones de la IsTrackingViewState propiedad y , y los LoadViewStatemétodos , SaveViewStatey TrackViewState para habilitar el seguimiento de estado de vista para el control. Para obtener más información, consulte ASP.NET State Management Overview.

Constructores

SqlDataSourceView(SqlDataSource, String, HttpContext)

Inicializa una nueva instancia de la clase SqlDataSourceView configurando el control SqlDataSource especificado como propietario de la vista actual.

Propiedades

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 `null`.
CanDelete	Obtiene un valor que indica si el objeto SqlDataSourceView asociado al control SqlDataSource actual admite la operación de eliminación.
CanInsert	Obtiene un valor que indica si el objeto SqlDataSourceView asociado al control SqlDataSource actual admite la operación de inserción.
CanPage	Obtiene un valor que indica si el objeto SqlDataSourceView asociado al control SqlDataSource actual admite la paginación de los datos recuperados.
CanRetrieveTotalRowCount	Obtiene un valor que indica si el objeto SqlDataSourceView asociado al control SqlDataSource actual admite la recuperación del número total de filas de datos, además del conjunto de datos.
CanSort	Obtiene un valor que indica si el objeto SqlDataSourceView asociado al control SqlDataSource actual admite una vista ordenada de los datos recuperados.
CanUpdate	Obtiene un valor que indica si el objeto SqlDataSourceView asociado al control SqlDataSource actual admite la operación de actualización.
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.
DeleteCommand	Obtiene o establece la cadena SQL que SqlDataSourceView utiliza 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 utiliza la propiedad DeleteCommand.
Events	Obtiene una lista de delegados de controladores de eventos de la vista de origen de datos. (Heredado de DataSourceView)
FilterExpression	Obtiene o establece una expresión de filtrado que se aplica cuando se llama al método Select.
FilterParameters	Obtiene una colección de parámetros asociados a los marcadores de posición de parámetro de la cadena FilterExpression.
InsertCommand	Obtiene o establece la cadena SQL que el objeto SqlDataSourceView utiliza 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 utiliza la propiedad InsertCommand.
IsTrackingViewState	Obtiene un valor que indica si el objeto SqlDataSourceView está guardando los cambios en su estado de vista.
Name	Obtiene el nombre de la vista de datos de origen. (Heredado de DataSourceView)
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.
ParameterPrefix	Obtiene la cadena que se usa como prefijo de un marcador de posición de parámetro en una consulta SQL con parámetros.
SelectCommand	Obtiene o establece la cadena SQL que el objeto SqlDataSourceView utiliza 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 utiliza la propiedad SelectCommand.
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.
UpdateCommand	Obtiene o establece la cadena SQL que el objeto SqlDataSourceView utiliza 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 utiliza la propiedad UpdateCommand.

Métodos

CanExecute(String)	Determina si se puede ejecutar el comando especificado. (Heredado de DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Realiza una operación de eliminación asincrónica en la lista de datos que el objeto DataSourceView representa. (Heredado de DataSourceView)
Delete(IDictionary, IDictionary)	Realiza una operación de eliminación utilizando la cadena SQL DeleteCommand, los parámetros especificados en la colección DeleteParameters y los valores de las colecciones `keys` y `oldValues` especificadas.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Ejecuta el comando especificado. (Heredado de DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Ejecuta el comando especificado. (Heredado de DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Realiza una operación de eliminación utilizando la cadena SQL DeleteCommand, los parámetros especificados en la colección DeleteParameters y los valores de las colecciones `keys` y `oldValues` especificadas.
ExecuteInsert(IDictionary)	Realiza una operación de inserción utilizando la cadena SQL InsertCommand, los parámetros especificados en la colección InsertParameters y los valores de la colección `values` especificada.
ExecuteSelect(DataSourceSelectArguments)	Recupera datos de la base de datos subyacente mediante la cadena SQL SelectCommand y los parámetros de la colección SelectParameters.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Realiza una operación de actualización utilizando la cadena SQL UpdateCommand, los parámetros de la colección UpdateParameters y los valores de las colecciones `keys`, `values` y `oldValues` especificadas.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Realiza una operación de inserción asincrónica en la lista de datos que el objeto DataSourceView representa. (Heredado de DataSourceView)
Insert(IDictionary)	Realiza una operación de inserción utilizando la cadena SQL InsertCommand, los parámetros especificados en la colección InsertParameters y los valores de la colección `values` especificada.
LoadViewState(Object)	Restaura el estado de vista cargado anteriormente de la vista de origen de datos.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnDataSourceViewChanged(EventArgs)	Genera el evento DataSourceViewChanged. (Heredado de DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)	Provoca el evento Deleted una vez que el control SqlDataSource ha terminado una operación de eliminación.
OnDeleting(SqlDataSourceCommandEventArgs)	Provoca el evento Deleting antes de que el control SqlDataSource trate de realizar una operación de eliminación.
OnFiltering(SqlDataSourceFilteringEventArgs)	Provoca el evento Filtering antes de que el control SqlDataSource filtre el resultado de una operación de selección.
OnInserted(SqlDataSourceStatusEventArgs)	Provoca el evento Inserted una vez que el control SqlDataSource ha terminado una operación de inserción.
OnInserting(SqlDataSourceCommandEventArgs)	Provoca el evento Inserting antes de que el control SqlDataSource trate de realizar una operación de inserción.
OnSelected(SqlDataSourceStatusEventArgs)	Provoca el evento Selected una vez que el control SqlDataSource ha terminado una operación de recuperación de datos.
OnSelecting(SqlDataSourceSelectingEventArgs)	Provoca el evento Selecting antes de que el control SqlDataSource trate de realizar una operación de recuperación de datos.
OnUpdated(SqlDataSourceStatusEventArgs)	Provoca el evento Updated una vez que el control SqlDataSource ha terminado una operación de actualización.
OnUpdating(SqlDataSourceCommandEventArgs)	Provoca el evento Updating antes de que el control SqlDataSource trate de realizar una operación de actualización.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Compara las capacidades solicitadas para una operación ExecuteSelect(DataSourceSelectArguments) con las que la vista admite; lo llama el método RaiseUnsupportedCapabilitiesError(DataSourceView).
SaveViewState()	Guarda los cambios en el estado de vista del SqlDataSourceView control desde el momento en que se publicó la página en el servidor.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Obtiene, de forma asincrónica, una lista de datos del espacio de almacenamiento de datos subyacente. (Heredado de DataSourceView)
Select(DataSourceSelectArguments)	Recupera datos de la base de datos subyacente mediante la cadena SQL SelectCommand y los parámetros de la colección SelectParameters.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TrackViewState()	Hace que el objeto SqlDataSourceView realice el seguimiento de los cambios de su estado de vista de forma que dichos cambios se puedan guardar en el objeto StateBag del control y se conserven en distintas solicitudes de la misma página.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Realiza una operación de actualización asincrónica en la lista de datos que el objeto DataSourceView representa. (Heredado de DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Realiza una operación de actualización utilizando la cadena SQL UpdateCommand, los parámetros de la colección UpdateParameters y los valores de las colecciones `keys`, `values` y `oldValues` especificadas.

Eventos

DataSourceViewChanged	Se produce cuando la vista de origen de datos ha cambiado. (Heredado de DataSourceView)
Deleted	Tiene lugar cuando se termina una operación de eliminación.
Deleting	Tiene lugar antes de una operación de eliminación.
Filtering	Se produce antes de una operación de filtrado.
Inserted	Tiene lugar cuando se termina una operación de inserción.
Inserting	Tiene lugar antes de una operación de inserción.
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.
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

IStateManager.IsTrackingViewState	Para obtener una descripción de este miembro, vea IsTrackingViewState.
IStateManager.LoadViewState(Object)	Para obtener una descripción de este miembro, vea LoadViewState(Object).
IStateManager.SaveViewState()	Para obtener una descripción de este miembro, vea SaveViewState().
IStateManager.TrackViewState()	Para obtener una descripción de este miembro, vea TrackViewState().

Se aplica a

Compartir vía