Compartilhar via


SqlDataSourceView Classe

Definição

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
SqlDataSourceView
Derivado
Implementações

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:

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

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

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

Confira também