SqlDataSourceView Classe

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Dá suporte ao SqlDataSource controle e fornece uma interface para controles associados a dados para executar operações de dados SQL em bancos de dados relacionais.

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

Herança

Object

DataSourceView

SqlDataSourceView

Derivado

System.Web.UI.WebControls.AccessDataSourceView

Implementações

IStateManager

Comentários

A SqlDataSourceView classe destina-se principalmente a ser usada por controles associados a dados e não como um objeto programável no código da página.

ASP.NET controles de fonte de dados contêm uma ou mais listas de dados, representadas por objetos de exibição da fonte de dados. A SqlDataSourceView classe estende a DataSourceView classe, define os recursos do SqlDataSource controle ao qual está associado e implementa a funcionalidade básica de dados para o controle da fonte de dados. A SqlDataSourceView classe implementa a funcionalidade de dados para o SqlDataSource controle, incluindo o Select, Update, Inserte Delete operações, classificação, filtragem e gerenciamento de configurações que são mantidas no estado de exibição.

Embora o SqlDataSourceView objeto não seja exposto diretamente aos desenvolvedores de páginas pelo SqlDataSource controle, muitas de suas propriedades são. A operação mais básica que uma exibição de fonte de dados executa é a recuperação de dados do banco de dados subjacente usando o Select método, que recupera uma IEnumerable coleção de itens de dados. A SqlDataSourceView classe implementa a recuperação de dados de bancos de dados relacionais usando consultas SQL. As consultas SQL podem ser parametrizadas para maior flexibilidade e segurança. Os seguintes métodos, propriedades e eventos de recuperação de dados são implementados e SqlDataSourceView expostos diretamente por seu SqlDataSource controle para desenvolvedores de páginas e outros chamadores:

• A propriedade SelectCommand

• A propriedade SelectParameters

• O Selecting evento

• O Selected evento

O SqlDataSourceView objeto dá suporte à atualização de dados em um banco de dados relacional usando comandos SQL. Os comandos SQL podem ser parametrizados para maior flexibilidade e segurança. Controles associados a dados, como o GridView e DetailsView, podem ser configurados para executar atualizações automaticamente usando o SqlDataSourceView, enquanto outros controles não podem. Os seguintes métodos de atualização, propriedades e eventos são implementados e SqlDataSourceView expostos diretamente por seu SqlDataSource controle para desenvolvedores de páginas e outros chamadores:

• A propriedade UpdateCommand

• A propriedade UpdateParameters

• O Updating evento

• O Updated evento

O SqlDataSourceView suporte à inserção de novas linhas de dados em um banco de dados relacional. Os comandos SQL especificados na InsertCommand propriedade podem ser parametrizados para maior flexibilidade e segurança. Controles associados a dados, como o GridView e DetailsView, podem ser configurados para executar inserções automaticamente usando o SqlDataSourceView, enquanto outros controles não podem. Os seguintes métodos de inserção, propriedades e eventos são implementados e SqlDataSourceView expostos diretamente por seu SqlDataSource controle para desenvolvedores de páginas e outros chamadores:

• A propriedade InsertCommand

• A propriedade InsertParameters

• O Inserting evento

• O Inserted evento

O SqlDataSourceView objeto também dá suporte à exclusão de dados de um banco de dados relacional. Assim como acontece com outros comandos, os comandos SQL especificados na DeleteCommand propriedade podem ser parametrizados para maior flexibilidade e segurança. Controles associados a dados, como o GridView e DetailsView, podem ser configurados para executar exclusões automaticamente usando o SqlDataSourceView, enquanto outros controles não podem. Os seguintes métodos, propriedades e eventos de exclusão são implementados e SqlDataSourceView expostos diretamente por seu SqlDataSource controle para desenvolvedores de páginas e outros chamadores:

• A propriedade DeleteCommand

• A propriedade DeleteParameters

• O Deleting evento

• O Deleted evento

A recuperação de dados é mais eficiente quando a cláusula usada para filtrar os dados durante a recuperação de dados é dinâmica. Em outras palavras, uma consulta SQL com uma cláusula WHERE estática não é tão flexível e poderosa quanto uma consulta SQL em que os valores na cláusula WHERE são associados a valores que podem ser alterados, como valores exibidos em controles em uma página dos Web Forms. Em vez de recriar uma consulta SQL e definir a SelectCommand propriedade em cada carga de página, você pode usar as propriedades e FilterParameters as FilterExpression propriedades para aplicar a filtragem dinâmica à recuperação de dados. Essas propriedades são implementadas e SqlDataSourceView expostas diretamente por seu SqlDataSource controle a controles associados a dados e outros chamadores.

Você pode classificar os dados recuperados com o SqlDataSource controle adicionando uma cláusula ORDER BY, que faz com que o banco de dados execute a ordenação para você ao recuperar dados ou ordenando os dados na memória depois que eles forem recuperados. Você pode fornecer uma expressão de classificação para a SqlDataSourceView configuração SortExpression da propriedade do DataSourceSelectArguments objeto que é passada para o Select método. A sintaxe da SortExpression propriedade é a mesma que a sintaxe de uma DataView.Sort propriedade. Se você usar um procedimento armazenado para recuperar dados, também poderá usar a SortParameterName propriedade para especificar um parâmetro usado especificamente para classificar os resultados de uma chamada de procedimento armazenado.

Quando mais de um usuário pode alterar o banco de dados simultaneamente, há o potencial de conflito de simultaneidade. O SqlDataSource controle tem simultaneidade de controles por meio da SqlDataSource.ConflictDetection propriedade. A funcionalidade é implementada na SqlDataSourceView.ConflictDetection propriedade.

Como muitos outros controles de servidor Web, o SqlDataSourceView implementa a interface e usa o IStateManager estado de exibição para acompanhar seu estado entre solicitações de página. Implementações da IsTrackingViewState propriedade e do LoadViewState, SaveViewStatee TrackViewState métodos são fornecidos para habilitar o controle de estado de exibição. Para obter mais informações, consulte ASP.NET Visão geral do Gerenciamento de Estado.

Construtores

Nome	Description
SqlDataSourceView(SqlDataSource, String, HttpContext)	Inicializa uma nova instância da SqlDataSourceView classe que define o controle especificado SqlDataSource como o proprietário do modo de exibição atual.

Propriedades

Nome	Description
CancelSelectOnNullParameter	Obtém ou define um valor que indica se uma operação de recuperação de dados é cancelada quando qualquer parâmetro contido na SelectParameters coleção é avaliado como null.
CanDelete	Obtém um valor que indica se o SqlDataSourceView objeto associado ao controle atual SqlDataSource dá suporte à operação de exclusão.
CanInsert	Obtém um valor que indica se o SqlDataSourceView objeto associado ao controle atual SqlDataSource dá suporte à operação de inserção.
CanPage	Obtém um valor que indica se o SqlDataSourceView objeto associado ao controle atual SqlDataSource dá suporte à paginação de dados recuperados.
CanRetrieveTotalRowCount	Obtém um valor que indica se o SqlDataSourceView objeto associado ao controle atual SqlDataSource dá suporte à recuperação do número total de linhas de dados, além do conjunto de dados.
CanSort	Obtém um valor que indica se o SqlDataSourceView objeto associado ao controle atual SqlDataSource dá suporte a uma exibição classificada nos dados recuperados.
CanUpdate	Obtém um valor que indica se o SqlDataSourceView objeto associado ao controle atual SqlDataSource dá suporte à operação de atualização.
ConflictDetection	Obtém ou define o valor que indica como o SqlDataSource controle executa atualizações e exclusões quando os dados em uma linha no banco de dados subjacente são alterados durante o tempo da operação.
DeleteCommand	Obtém ou define a cadeia de caracteres SQL usada SqlDataSourceView para excluir dados do banco de dados subjacente.
DeleteCommandType	Obtém ou define um valor que indica se o texto na DeleteCommand propriedade é uma instrução SQL ou o nome de um procedimento armazenado.
DeleteParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pela DeleteCommand propriedade.
Events	Obtém uma lista de representantes do manipulador de eventos para a exibição da fonte de dados. (Herdado de DataSourceView)
FilterExpression	Obtém ou define uma expressão de filtragem que é aplicada quando o Select método é chamado.
FilterParameters	Obtém uma coleção de parâmetros associados a quaisquer espaços reservados de parâmetro na FilterExpression cadeia de caracteres.
InsertCommand	Obtém ou define a cadeia de caracteres SQL que o SqlDataSourceView objeto usa para inserir dados no banco de dados subjacente.
InsertCommandType	Obtém ou define um valor que indica se o texto na InsertCommand propriedade é uma instrução SQL ou o nome de um procedimento armazenado.
InsertParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pela InsertCommand propriedade.
IsTrackingViewState	Obtém um valor que indica se o SqlDataSourceView objeto está salvando alterações em seu estado de exibição.
Name	Obtém o nome da exibição da fonte de dados. (Herdado de DataSourceView)
OldValuesParameterFormatString	Obtém ou define uma cadeia de caracteres de formato a ser aplicada aos nomes de todos os parâmetros que são passados para o método ou Update para o Delete método.
ParameterPrefix	Obtém a cadeia de caracteres usada para prefixar um espaço reservado de parâmetro em uma consulta SQL parametrizada.
SelectCommand	Obtém ou define a cadeia de caracteres SQL que o SqlDataSourceView objeto usa para recuperar dados do banco de dados subjacente.
SelectCommandType	Obtém ou define um valor que indica se o texto na SelectCommand propriedade é uma consulta SQL ou o nome de um procedimento armazenado.
SelectParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pela SelectCommand propriedade.
SortParameterName	Obtém ou define o nome de um parâmetro de procedimento armazenado usado para classificar dados recuperados quando a recuperação de dados é executada usando um procedimento armazenado.
UpdateCommand	Obtém ou define a cadeia de caracteres SQL que o SqlDataSourceView objeto usa para atualizar dados no banco de dados subjacente.
UpdateCommandType	Obtém ou define um valor que indica se o texto na UpdateCommand propriedade é uma instrução SQL ou o nome de um procedimento armazenado.
UpdateParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pela UpdateCommand propriedade.

Métodos

Nome	Description
CanExecute(String)	Determina se o comando especificado pode ser executado. (Herdado de DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Executa uma operação de exclusão assíncrona na lista de dados que o DataSourceView objeto representa. (Herdado de DataSourceView)
Delete(IDictionary, IDictionary)	Executa uma operação de exclusão usando a DeleteCommand cadeia de caracteres SQL, todos os parâmetros especificados na DeleteParameters coleção e os valores especificados keys e oldValues coleções.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Executa o comando especificado. (Herdado de DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Executa o comando especificado. (Herdado de DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Executa uma operação de exclusão usando a DeleteCommand cadeia de caracteres SQL, todos os parâmetros especificados na DeleteParameters coleção e os valores especificados keys e oldValues coleções.
ExecuteInsert(IDictionary)	Executa uma operação de inserção usando a InsertCommand cadeia de caracteres SQL, todos os parâmetros especificados na InsertParameters coleção e os valores que estão na coleção especificada values .
ExecuteSelect(DataSourceSelectArguments)	Recupera dados do banco de dados subjacente usando a SelectCommand cadeia de caracteres SQL e todos os parâmetros que estão na SelectParameters coleção.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Executa uma operação de atualização usando a UpdateCommand cadeia de caracteres SQL, todos os UpdateParameters parâmetros que estão na coleção e os valores especificados keyse valuesoldValues coleções.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Executa uma operação de inserção assíncrona na lista de dados que o DataSourceView objeto representa. (Herdado de DataSourceView)
Insert(IDictionary)	Executa uma operação de inserção usando a InsertCommand cadeia de caracteres SQL, todos os parâmetros especificados na InsertParameters coleção e os valores que estão na coleção especificada values .
LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente para a exibição da fonte de dados.
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnDataSourceViewChanged(EventArgs)	Aciona o evento DataSourceViewChanged. (Herdado de DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)	Aciona o Deleted evento depois que o SqlDataSource controle conclui uma operação de exclusão.
OnDeleting(SqlDataSourceCommandEventArgs)	Aciona o Deleting evento antes que o SqlDataSource controle tente uma operação de exclusão.
OnFiltering(SqlDataSourceFilteringEventArgs)	Aciona o Filtering evento antes que o SqlDataSource controle filtre os resultados de uma operação de seleção.
OnInserted(SqlDataSourceStatusEventArgs)	Aciona o Inserted evento após o SqlDataSource controle concluir uma operação de inserção.
OnInserting(SqlDataSourceCommandEventArgs)	Aciona o Inserting evento antes que o SqlDataSource controle tente uma operação de inserção.
OnSelected(SqlDataSourceStatusEventArgs)	Aciona o Selected evento depois que o SqlDataSource controle conclui uma operação de recuperação de dados.
OnSelecting(SqlDataSourceSelectingEventArgs)	Aciona o Selecting evento antes que o SqlDataSource controle tente uma operação de recuperação de dados.
OnUpdated(SqlDataSourceStatusEventArgs)	Aciona o Updated evento depois que o SqlDataSource controle conclui uma operação de atualização.
OnUpdating(SqlDataSourceCommandEventArgs)	Aciona o Updating evento antes que o SqlDataSource controle tente uma operação de atualização.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Compara os recursos solicitados para uma ExecuteSelect(DataSourceSelectArguments) operação em relação àqueles aos quais a exibição dá suporte e é chamada pelo RaiseUnsupportedCapabilitiesError(DataSourceView) método.
SaveViewState()	Salva as alterações no estado de exibição do SqlDataSourceView controle desde o momento em que a página foi postada novamente no servidor.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Obtém uma lista de dados de forma assíncrona do armazenamento de dados subjacente. (Herdado de DataSourceView)
Select(DataSourceSelectArguments)	Recupera dados do banco de dados subjacente usando a SelectCommand cadeia de caracteres SQL e todos os parâmetros que estão na SelectParameters coleção.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz com que o SqlDataSourceView objeto acompanhe as alterações em seu estado de exibição para que as alterações possam ser armazenadas no StateBag objeto para o controle e mantidas entre solicitações para a mesma página.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Executa uma operação de atualização assíncrona na lista de dados que o DataSourceView objeto representa. (Herdado de DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Executa uma operação de atualização usando a UpdateCommand cadeia de caracteres SQL, todos os UpdateParameters parâmetros que estão na coleção e os valores especificados keyse valuesoldValues coleções.

Eventos

Nome	Description
DataSourceViewChanged	Ocorre quando a exibição da fonte de dados é alterada. (Herdado de DataSourceView)
Deleted	Ocorre quando uma operação de exclusão é concluída.
Deleting	Ocorre antes de uma operação de exclusão.
Filtering	Ocorre antes de uma operação de filtro.
Inserted	Ocorre quando uma operação de inserção é concluída.
Inserting	Ocorre antes de uma operação de inserção.
Selected	Ocorre quando uma operação de recuperação de dados é concluída.
Selecting	Ocorre antes de uma operação de recuperação de dados.
Updated	Ocorre quando uma operação de atualização é concluída.
Updating	Ocorre antes de uma operação de atualização.

Implantações explícitas de interface

Nome	Description
IStateManager.IsTrackingViewState	Para obter uma descrição deste membro, consulte IsTrackingViewState.
IStateManager.LoadViewState(Object)	Para obter uma descrição deste membro, consulte LoadViewState(Object).
IStateManager.SaveViewState()	Para obter uma descrição deste membro, consulte SaveViewState().
IStateManager.TrackViewState()	Para obter uma descrição deste membro, consulte TrackViewState().

Confira também

• SqlDataSource
• DataSourceView
• AccessDataSourceView