Compartir a través de


SqlDataSourceView Clase

Definición

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
SqlDataSourceView
Derivado
Implementaciones

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:

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 GridViewDetailsView, 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:

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 GridViewDetailsView, 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:

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 GridViewDetailsView, 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 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

Consulte también