SqlDataSourceView Classe

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Suporta o SqlDataSource controlo e fornece uma interface para controlos encadernados por dados para realizar operações SQL contra bases 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
Implementações
IStateManager

Observações

A SqlDataSourceView classe destina-se principalmente a ser usada por controlos encadernados por dados, e não como um objeto programável em código de página.

Os controlos de fonte de dados ASP.NET contêm uma ou mais listas de dados, representadas por objetos de vista de fonte de dados. A SqlDataSourceView classe estende a DataSourceView classe, define as capacidades do SqlDataSource controlo com que está associada e implementa a funcionalidade básica de dados para o controlo de fonte de dados. A SqlDataSourceView classe implementa a funcionalidade de dados do SqlDataSource controlo, incluindo , SelectUpdate, Insert, e Delete operações, ordenação, filtragem e gestão de definições que são mantidas no estado de visualização.

Embora o SqlDataSourceView objeto não seja diretamente exposto aos programadores de páginas pelo SqlDataSource controlo, muitas das suas propriedades são. A operação mais básica que uma vista de fonte de dados realiza é a recuperação de dados da base 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 a partir de bases 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 pelo seu SqlDataSource controlo aos programadores de páginas e outros chamadores:

O SqlDataSourceView objeto suporta a atualização de dados numa base de dados relacional usando comandos SQL. Os comandos SQL podem ser parametrizados para maior flexibilidade e segurança. Controlos limitados por dados, como o GridView e DetailsView, podem ser configurados para realizar atualizações automaticamente usando o SqlDataSourceView, enquanto outros controlos não podem. Os seguintes métodos, propriedades e eventos de atualização são implementados pelo SqlDataSourceView e expostos diretamente pelo seu SqlDataSource controlo aos programadores de páginas e outros chamadores:

Suporta SqlDataSourceView a inserção de novas linhas de dados numa base de dados relacional. Os comandos SQL especificados na InsertCommand propriedade podem ser parametrizados para maior flexibilidade e segurança. Controlos com dados limitados, como os GridView e DetailsView, podem ser configurados para realizar inserções automaticamente usando o SqlDataSourceView, enquanto outros controlos não podem. Os seguintes métodos, propriedades e eventos de inserção são implementados pelo SqlDataSourceView e expostos diretamente pelo seu SqlDataSource controlo aos programadores de páginas e outros chamadores:

O SqlDataSourceView objeto também suporta a eliminação de dados de uma base de dados relacional. Tal como com outros comandos, os comandos SQL especificados na DeleteCommand propriedade podem ser parametrizados para maior flexibilidade e segurança. Controlos ligados a dados, como o GridView e DetailsView, podem ser configurados para realizar eliminações automaticamente usando o SqlDataSourceView, enquanto outros controlos não podem. Os seguintes métodos, propriedades e eventos de eliminação são implementados pelo SqlDataSourceView e expostos diretamente pelo seu SqlDataSource controlo aos programadores de páginas e outros chamadores:

A recuperação de dados é mais poderosa quando a cláusula usada para filtrar os dados durante a recuperação é dinâmica. Por outras palavras, uma consulta SQL com uma cláusula WHERE estática não é tão flexível e poderosa como uma consulta SQL, onde os valores na cláusula WHERE estão ligados a valores que podem mudar, como os valores que são exibidos em controlos numa página Web Forms. Em vez de reconstruir uma consulta SQL e definir a SelectCommand propriedade em cada carregamento de página, pode usar as FilterExpression propriedades e FilterParameters para aplicar filtragem dinâmica à recuperação de dados. Estas propriedades são implementadas pelo SqlDataSourceView e expostas diretamente pelo seu SqlDataSource controlo aos controlos de dados vinculados e a outros chamadores.

Pode ordenar os dados que recupera com o SqlDataSource controlo adicionando uma cláusula ORDER BY, que faz com que a base de dados execute a ordenação por si quando recupera os dados ou ordenando os dados na memória depois de recuperados. Pode fornecer uma expressão de ordenação para o SqlDataSourceView definindo a SortExpression propriedade do DataSourceSelectArguments objeto que é passada ao Select método. A sintaxe da SortExpression propriedade é a mesma que a sintaxe de uma DataView.Sort propriedade. Se usar um procedimento armazenado para recuperar dados, também pode usar a SortParameterName propriedade para especificar um parâmetro usado especificamente para ordenar os resultados de uma chamada de procedimento armazenado.

Quando mais do que um utilizador pode alterar a base de dados em simultâneo, existe o potencial de conflito de concorrência. O SqlDataSource controlo controla a concorrência através da SqlDataSource.ConflictDetection propriedade. A funcionalidade é implementada na SqlDataSourceView.ConflictDetection propriedade.

Como muitos outros controlos de servidor Web, implementa SqlDataSourceView a IStateManager interface e utiliza o estado de visualização para acompanhar o seu estado através dos pedidos de página. São fornecidas implementações da IsTrackingViewState propriedade LoadViewStatee dos métodos , SaveViewState, e TrackViewState para permitir o rastreio do estado da vista para o controlo. Para mais informações, consulte ASP.NET Visão Geral da Gestão do Estado.

Construtores

Name Description
SqlDataSourceView(SqlDataSource, String, HttpContext)

Inicializa uma nova instância da SqlDataSourceView classe que define o controlo especificado SqlDataSource como proprietário da vista atual.

Propriedades

Name 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 avalia para null.
CanDelete

Recebe um valor que indica se o SqlDataSourceView objeto associado ao controlo atual SqlDataSource suporta a operação de eliminação.
CanInsert

Recebe um valor que indica se o SqlDataSourceView objeto associado ao controlo atual SqlDataSource suporta a operação de inserção.
CanPage

Recebe um valor que indica se o SqlDataSourceView objeto associado ao controlo atual SqlDataSource suporta a paginação dos dados recuperados.
CanRetrieveTotalRowCount

Recebe um valor que indica se o SqlDataSourceView objeto associado ao controlo atual SqlDataSource suporta 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 SqlDataSourceView objeto associado ao controlo atual SqlDataSource suporta uma visão ordenada sobre os dados recuperados.
CanUpdate

Recebe um valor que indica se o SqlDataSourceView objeto associado ao controlo atual SqlDataSource suporta a operação de atualização.
ConflictDetection

Recebe ou define o valor que indica como o controlo SqlDataSource realiza atualizações e eliminações quando dados numa linha na base de dados subjacente mudam durante o tempo da operação.
DeleteCommand

Obtém ou define a string SQL que usa SqlDataSourceView para apagar dados da base de dados subjacente.
DeleteCommandType

Recebe 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 delegados handler de eventos para a vista da fonte de dados.

(Herdado de DataSourceView)
FilterExpression

Recebe 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 marcadores de parâmetros na FilterExpression cadeia.
InsertCommand

Obtém ou define a string SQL que o SqlDataSourceView objeto usa para inserir dados na base de dados subjacente.
InsertCommandType

Recebe 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

Recebe um valor que indica se o SqlDataSourceView objeto está a guardar alterações ao seu estado de visualização.
Name

Obtém o nome da vista da fonte de dados.

(Herdado de DataSourceView)
OldValuesParameterFormatString

Obtém ou define uma cadeia de formatos para aplicar aos nomes de quaisquer parâmetros que sejam passados ao Delete método ou.Update
ParameterPrefix

Obtém a string que é usada para prefixar um marcador de parâmetros numa consulta SQL parametrizada.
SelectCommand

Obtém ou define a string SQL que o SqlDataSourceView objeto usa para recuperar dados da base de dados subjacente.
SelectCommandType

Recebe 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

Recebe ou define o nome de um parâmetro de procedimento armazenado que é usado para ordenar os dados recuperados quando a recuperação de dados é realizada usando um procedimento armazenado.
UpdateCommand

Obtém ou define a string SQL que o SqlDataSourceView objeto usa para atualizar dados na base de dados subjacente.
UpdateCommandType

Recebe 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

Name Description
CanExecute(String)

Determina se o comando especificado pode ser executado.

(Herdado de DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)

Realiza uma operação de eliminação assíncrona na lista de dados que o DataSourceView objeto representa.

(Herdado de DataSourceView)
Delete(IDictionary, IDictionary)

Realiza uma operação de eliminação usando a DeleteCommand string SQL, quaisquer parâmetros especificados na DeleteParameters coleção e os valores que estejam nas colecções e oldValues especificadoskeys.
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)

Realiza uma operação de eliminação usando a DeleteCommand string SQL, quaisquer parâmetros especificados na DeleteParameters coleção e os valores que estejam nas colecções e oldValues especificadoskeys.
ExecuteInsert(IDictionary)

Realiza uma operação de inserção usando a InsertCommand string SQL, quaisquer parâmetros especificados na InsertParameters coleção e os valores que estejam na coleção especificada values .
ExecuteSelect(DataSourceSelectArguments)

Recupera dados da base de dados subjacente usando a SelectCommand string SQL e quaisquer parâmetros que estejam na SelectParameters coleção.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)

Executa uma operação de atualização usando a UpdateCommand string SQL, quaisquer parâmetros que estejam na UpdateParameters coleção e os valores que estejam nas colecções especificadas keys, values, e oldValues .
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Insert(IDictionary, DataSourceViewOperationCallback)

Realiza uma operação de inserção assíncrona na lista de dados que o DataSourceView objeto representa.

(Herdado de DataSourceView)
Insert(IDictionary)

Realiza uma operação de inserção usando a InsertCommand string SQL, quaisquer parâmetros especificados na InsertParameters coleção e os valores que estejam na coleção especificada values .
LoadViewState(Object)

Restaura o estado da visualização previamente guardada para a vista da fonte de dados.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnDataSourceViewChanged(EventArgs)

Eleva o DataSourceViewChanged evento.

(Herdado de DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)

Levanta o Deleted evento depois de o SqlDataSource controlo ter concluído uma operação de eliminação.
OnDeleting(SqlDataSourceCommandEventArgs)

Levanta o Deleting evento antes de o SqlDataSource controlo tentar uma operação de eliminação.
OnFiltering(SqlDataSourceFilteringEventArgs)

Eleva o Filtering evento antes do SqlDataSource controlo filtrar os resultados de uma operação de seleção.
OnInserted(SqlDataSourceStatusEventArgs)

Aumenta o Inserted evento depois de o SqlDataSource controlo ter concluído uma operação de inserção.
OnInserting(SqlDataSourceCommandEventArgs)

Levanta o Inserting evento antes de o SqlDataSource controlo tentar uma operação de inserção.
OnSelected(SqlDataSourceStatusEventArgs)

Levanta o Selected evento após o SqlDataSource controlo ter concluído uma operação de recuperação de dados.
OnSelecting(SqlDataSourceSelectingEventArgs)

Levanta o Selecting evento antes de o SqlDataSource controlo tentar uma operação de recuperação de dados.
OnUpdated(SqlDataSourceStatusEventArgs)

Levanta o Updated evento depois de o SqlDataSource controlo ter concluído uma operação de atualização.
OnUpdating(SqlDataSourceCommandEventArgs)

Levanta o Updating evento antes de o SqlDataSource controlo tentar uma operação de atualização.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)

Compara as capacidades solicitadas para uma ExecuteSelect(DataSourceSelectArguments) operação com aquelas que a vista suporta e é chamada pelo RaiseUnsupportedCapabilitiesError(DataSourceView) método.
SaveViewState()

Guarda as alterações ao estado da visualização para o SqlDataSourceView controlo desde o momento em que a página foi publicada de volta no servidor.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)

Obtém uma lista de dados assíncrona a partir do armazenamento subjacente.

(Herdado de DataSourceView)
Select(DataSourceSelectArguments)

Recupera dados da base de dados subjacente usando a SelectCommand string SQL e quaisquer parâmetros que estejam na SelectParameters coleção.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Faz com que o SqlDataSourceView objeto acompanhe alterações ao seu estado de visualização para que as alterações possam ser armazenadas no StateBag objeto para o controlo e persistir entre pedidos para a mesma página.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)

Realiza 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 string SQL, quaisquer parâmetros que estejam na UpdateParameters coleção e os valores que estejam nas colecções especificadas keys, values, e oldValues .

evento

Name Description
DataSourceViewChanged

Ocorre quando a vista da fonte de dados mudou.

(Herdado de DataSourceView)
Deleted

Ocorre quando uma operação de eliminação foi concluída.
Deleting

Ocorre antes de uma operação de eliminaçã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 foi 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.

Implementações de Interface Explícita

Name Description
IStateManager.IsTrackingViewState

Para uma descrição deste elemento, veja IsTrackingViewState.
IStateManager.LoadViewState(Object)

Para uma descrição deste elemento, veja LoadViewState(Object).
IStateManager.SaveViewState()

Para uma descrição deste elemento, veja SaveViewState().
IStateManager.TrackViewState()

Para uma descrição deste elemento, veja TrackViewState().

Aplica-se a

Ver também