SqlDataSourceView Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Dá suporte ao controle SqlDataSource e fornece uma interface para controles associados a dados para executar operações de dados SQL em relação a 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á associada 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 as Selectoperações , Update, Inserte Delete , classificação, filtragem e gerenciamento de configurações 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 pelo SqlDataSourceView e expostos diretamente por seu SqlDataSource controle para desenvolvedores de páginas e outros chamadores:

A propriedade SelectCommand
A propriedade SelectParameters
O evento Selecting
O evento Selected

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 e GridView 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 pelo SqlDataSourceView e expostos diretamente por seu SqlDataSource controle para desenvolvedores de páginas e outros chamadores:

A propriedade UpdateCommand
A propriedade UpdateParameters
O evento Updating
O evento Updated

O SqlDataSourceView dá 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 e GridView 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 pelo SqlDataSourceView e expostos diretamente por seu SqlDataSource controle para desenvolvedores de páginas e outros chamadores:

A propriedade InsertCommand
A propriedade InsertParameters
O evento Inserting
O evento Inserted

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 e GridView 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 pelo SqlDataSourceView e expostos diretamente por seu SqlDataSource controle para desenvolvedores de páginas e outros chamadores:

A propriedade DeleteCommand
A propriedade DeleteParameters
O evento Deleting
O evento Deleted

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 eficiente 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 do Web Forms. Em vez de recriar uma consulta SQL e definir a SelectCommand propriedade em cada carregamento de página, você pode usar as FilterExpression propriedades e FilterParameters para aplicar a filtragem dinâmica à recuperação de dados. Essas propriedades são implementadas pelo SqlDataSourceView e expostas diretamente por seu SqlDataSource controle a controles associados a dados e outros chamadores.

Você pode classificar os dados recuperados com o controle adicionando SqlDataSource uma cláusula ORDER BY, o 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 são recuperados. Você pode fornecer uma expressão de classificação para o SqlDataSourceView definindo a SortExpression propriedade do DataSourceSelectArguments objeto que é passado 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 controles de simultaneidade 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. As implementações da IsTrackingViewState propriedade e e dos LoadViewStatemétodos , SaveViewStatee TrackViewState são fornecidas para habilitar o controle de estado de exibição. Para obter mais informações, consulte Visão geral do Gerenciamento de Estado do ASP.NET.

Construtores

SqlDataSourceView(SqlDataSource, String, HttpContext)

Inicializa uma nova instância da classe SqlDataSourceView definindo o controle SqlDataSource especificado como o proprietário da exibição atual.

Propriedades

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 coleção SelectParameters é avaliado como `null`.
CanDelete	Obtém um valor que indica se o objeto SqlDataSourceView associado ao controle SqlDataSource atual é compatível com a operação de exclusão.
CanInsert	Obtém um valor que indica se o objeto SqlDataSourceView associado ao controle SqlDataSource atual é compatível com a operação de inserção.
CanPage	Obtém um valor que indica se o objeto SqlDataSourceView associado ao controle SqlDataSource atual dá suporte à paginação dos dados recuperados.
CanRetrieveTotalRowCount	Obtém um valor que indica se o objeto SqlDataSourceView associado ao controle SqlDataSource atual é compatível com a 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 objeto SqlDataSourceView associado ao controle SqlDataSource atual dá suporte a uma exibição classificada dos dados recuperados.
CanUpdate	Obtém um valor que indica se o objeto SqlDataSourceView associado ao controle SqlDataSource atual é compatível com a operação de atualização.
ConflictDetection	Obtém ou define o valor que indica como o controle SqlDataSource executa atualizações e exclusões quando os dados em uma linha do banco de dados subjacente são alterados durante o período da operação.
DeleteCommand	Obtém ou define a cadeia de caracteres SQL usada pelo SqlDataSourceView para excluir dados do banco de dados subjacente.
DeleteCommandType	Obtém ou define um valor que indica se o texto da propriedade DeleteCommand é 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 propriedade DeleteCommand.
Events	Obtém uma lista de delegados de 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 método Select é chamado.
FilterParameters	Obtém uma coleção de parâmetros associados a espaços reservados para parâmetros na cadeia de caracteres FilterExpression.
InsertCommand	Obtém ou define a cadeia de caracteres SQL que o objeto SqlDataSourceView usa para inserir dados do banco de dados subjacente.
InsertCommandType	Obtém ou define um valor que indica se o texto da propriedade InsertCommand é 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 propriedade InsertCommand.
IsTrackingViewState	Obtém um valor que indica se o objeto SqlDataSourceView está salvando alterações no 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 para ser aplicada aos nomes dos parâmetros que são passados para o método Delete ou Update.
ParameterPrefix	Obtém a cadeia de caracteres que é 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 objeto SqlDataSourceView usa para recuperar dados do banco de dados subjacente.
SelectCommandType	Obtém ou define um valor que indica se o texto da propriedade SelectCommand é 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 propriedade SelectCommand.
SortParameterName	Obtém ou define o nome de um parâmetro de procedimento armazenado que é usado para classificar os 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 objeto SqlDataSourceView usa para atualizar dados do banco de dados subjacente.
UpdateCommandType	Obtém ou define um valor que indica se o texto da propriedade UpdateCommand é 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 propriedade UpdateCommand.

Métodos

CanExecute(String)	Determina se o comando especificado pode ser executado. (Herdado de DataSourceView)
Delete(IDictionary, IDictionary)	Executa uma operação de exclusão usando a cadeia de caracteres SQL DeleteCommand, quaisquer parâmetros que estão especificados na coleção DeleteParameters e os valores que estão nas coleções `keys` e `oldValues` especificadas.
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Executa uma operação de exclusão assíncrona na lista de dados que o objeto DataSourceView representa. (Herdado de DataSourceView)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExecuteCommand(String, IDictionary, IDictionary)	Executa o comando especificado. (Herdado de DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Executa o comando especificado. (Herdado de DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Executa uma operação de exclusão usando a cadeia de caracteres SQL DeleteCommand, quaisquer parâmetros que estão especificados na coleção DeleteParameters e os valores que estão nas coleções `keys` e `oldValues` especificadas.
ExecuteInsert(IDictionary)	Executa uma operação de inserção usando a cadeia de caracteres SQL InsertCommand, quaisquer parâmetros que estão especificados na coleção InsertParameters e os valores que estão na coleção `values` especificada.
ExecuteSelect(DataSourceSelectArguments)	Recupera dados do banco de dados subjacente usando a cadeia de caracteres SQL SelectCommand e os parâmetros na coleção SelectParameters.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Executa uma operação de atualização usando a cadeia de caracteres SQL UpdateCommand, quaisquer parâmetros que estão na coleção UpdateParameters e os valores que estão nas coleções `keys`, `values` e `oldValues` especificadas.
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)	Executa uma operação de inserção usando a cadeia de caracteres SQL InsertCommand, quaisquer parâmetros que estão especificados na coleção InsertParameters e os valores que estão na coleção `values` especificada.
Insert(IDictionary, DataSourceViewOperationCallback)	Executa uma operação de inserção assíncrona na lista de dados que o objeto DataSourceView representa. (Herdado de DataSourceView)
LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDataSourceViewChanged(EventArgs)	Aciona o evento DataSourceViewChanged. (Herdado de DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)	Gera o evento Deleted após o controle SqlDataSource ter concluído uma operação de exclusão.
OnDeleting(SqlDataSourceCommandEventArgs)	Gera o evento Deleting antes de o controle SqlDataSource tentar realizar uma operação de exclusão.
OnFiltering(SqlDataSourceFilteringEventArgs)	Gera o evento Filtering antes de o controle SqlDataSource filtrar os resultados de uma operação de seleção.
OnInserted(SqlDataSourceStatusEventArgs)	Gera o evento Inserted após o controle SqlDataSource ter concluído uma operação de inserção.
OnInserting(SqlDataSourceCommandEventArgs)	Gera o evento Inserting antes de o controle SqlDataSource tentar realizar uma operação de inserção.
OnSelected(SqlDataSourceStatusEventArgs)	Gera o evento Selected após o controle SqlDataSource ter concluído uma operação de recuperação de dados.
OnSelecting(SqlDataSourceSelectingEventArgs)	Gera o evento Selecting antes do controle SqlDataSource tentar uma operação de recuperação de dados.
OnUpdated(SqlDataSourceStatusEventArgs)	Gera o evento Updated após o controle SqlDataSource ter concluído uma operação de atualização.
OnUpdating(SqlDataSourceCommandEventArgs)	Gera o evento Updating antes de o controle SqlDataSource tentar realizar uma operação de atualização.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Compara as funcionalidades que são solicitadas para uma operação ExecuteSelect(DataSourceSelectArguments) em relação àquelas que a exibição dá suporte e são chamadas pelo método RaiseUnsupportedCapabilitiesError(DataSourceView).
SaveViewState()	Salva as alterações no estado de exibição do SqlDataSourceView controle desde o momento em que a página foi postada de volta no servidor.
Select(DataSourceSelectArguments)	Recupera dados do banco de dados subjacente usando a cadeia de caracteres SQL SelectCommand e os parâmetros na coleção SelectParameters.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Obtém uma lista de dados de forma assíncrona do armazenamento de dados subjacente. (Herdado de DataSourceView)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz o objeto SqlDataSourceView acompanhar as alterações em seu estado de exibição para que elas possam ser armazenadas no objeto StateBag para o controle e persistente entre as solicitações para a mesma página.
Update(IDictionary, IDictionary, IDictionary)	Executa uma operação de atualização usando a cadeia de caracteres SQL UpdateCommand, quaisquer parâmetros que estão na coleção UpdateParameters e os valores que estão nas coleções `keys`, `values` e `oldValues` especificadas.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Executa uma operação de atualização assíncrona na lista de dados que o objeto DataSourceView representa. (Herdado de DataSourceView)

Eventos

DataSourceViewChanged	Ocorre quando a exibição da fonte de dados foi alterada. (Herdado de DataSourceView)
Deleted	Ocorre após a conclusão de uma operação de exclusão.
Deleting	Ocorre antes de uma operação de exclusão.
Filtering	Ocorre antes de uma operação de filtragem.
Inserted	Ocorre quando uma operação de inserção foi concluída.
Inserting	Ocorre antes de uma operação de inserção.
Selected	Ocorre quando uma operação de recuperação de dados for concluída.
Selecting	Ocorre antes de uma operação de recuperação de dados.
Updated	Ocorre quando uma operação de atualização foi concluída.
Updating	Ocorre antes de uma operação de atualização.

Implantações explícitas de interface

IStateManager.IsTrackingViewState	Para obter uma descrição desse membro, confira IsTrackingViewState.
IStateManager.LoadViewState(Object)	Para obter uma descrição desse membro, confira LoadViewState(Object).
IStateManager.SaveViewState()	Para obter uma descrição desse membro, confira SaveViewState().
IStateManager.TrackViewState()	Para obter uma descrição desse membro, confira TrackViewState().

Aplica-se a

Compartilhar via