Compartilhar via

ObjectDataSourceView Classe

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dá suporte ao ObjectDataSource controle e fornece uma interface para controles associados a dados para executar operações de dados com objetos de dados e comerciais.

public ref class ObjectDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager
public class ObjectDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager
type ObjectDataSourceView = class
    inherit DataSourceView
    interface IStateManager
Public Class ObjectDataSourceView
Inherits DataSourceView
Implements IStateManager
Herança
Object
DataSourceView
ObjectDataSourceView
Implementações
IStateManager

Comentários

A ObjectDataSourceView 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.

A ObjectDataSourceView classe implementa a funcionalidade de dados para o ObjectDataSource controle, incluindo o Select, Update, Deletee Insert operações, classificação, filtragem e gerenciamento de configurações mantidas no estado de exibição.

Um ObjectDataSourceView objeto é criado para cada instância da ObjectDataSource classe em tempo de execução. As chamadas para operações de dados da instância da ObjectDataSource classe são tratadas pela instância do ObjectDataSourceView objeto. Os desenvolvedores de páginas não acessam diretamente a instância da ObjectDataSourceView classe. Os desenvolvedores de controle podem criar controles de dados personalizados estendendo as classes e ObjectDataSourceView as ObjectDataSource classes.

A ObjectDataSourceView classe executa operações de dados chamando métodos em objetos de dados ou comerciais usando reflexão. Em tempo de execução, o ObjectDataSource controle cria uma instância do tipo que é identificado pela TypeName propriedade e, em seguida, chama o método apropriado para a operação de dados. O objeto instanciado não é armazenado em cache na memória pelo ObjectDataSourceView. O objeto é criado e destruído para cada chamada de método de dados. Se o método for static (Shared no Visual Basic), uma instância não será criada, mas o método de operação de dados ainda será chamado.

O ObjectDataSourceView controle não é exposto diretamente aos desenvolvedores ObjectDataSource de páginas. Em vez disso, as propriedades e os ObjectDataSourceView métodos são acessados por meio do ObjectDataSource. Por exemplo, a DeleteMethod propriedade é ObjectDataSourceView definida definindo a DeleteMethod propriedade do ObjectDataSource.

Recuperando dados

A operação mais básica que uma exibição de fonte de dados executa é a recuperação de dados do armazenamento de dados subjacente usando o Select método, que recupera uma IEnumerable coleção de itens de dados. Os seguintes métodos, propriedades e eventos de recuperação de dados são implementados pelo ObjectDataSourceView objeto e expostos diretamente por seu ObjectDataSource controle para desenvolvedores de páginas e outros chamadores:

Atualizando dados

O ObjectDataSourceView objeto dá suporte a atualizações de dados chamando um método de objeto comercial ou de dados identificado pela UpdateMethod propriedade. Controles associados a dados que executam automaticamente atualizações, como o e os GridView controles, passam seus parâmetros em uma IOrderedDictionary interface para o ObjectDataSourceView objeto de exibição mescla esses parâmetros com todos os parâmetros encontrados na UpdateParameters coleção.DetailsView

Os seguintes métodos de atualização, propriedades e eventos são implementados e ObjectDataSourceView expostos diretamente por seu ObjectDataSource controle para desenvolvedores de páginas e outros chamadores:

Inserindo dados

O ObjectDataSourceView objeto dá suporte à inserção de novas linhas de dados chamando um método de objeto comercial ou de dados identificado pela InsertMethod propriedade. Controles associados a dados que executam automaticamente inserções, como e GridViewDetailsView, passam seus parâmetros em uma IOrderedDictionary interface para o ObjectDataSourceView objeto de exibição mescla esses parâmetros com todos os parâmetros encontrados na InsertParameters coleção.

Os seguintes métodos de inserção, propriedades e eventos são implementados e ObjectDataSourceView expostos diretamente por seu ObjectDataSource controle para desenvolvedores de páginas e outros chamadores:

Excluindo dados

O ObjectDataSourceView objeto dá suporte à exclusão de dados chamando um método de objeto comercial ou de dados identificado pela DeleteMethod propriedade. Controles associados a dados que executam automaticamente exclusões, como e GridViewDetailsView, passam seus parâmetros em uma IOrderedDictionary interface para o ObjectDataSourceView objeto de exibição mescla esses parâmetros com todos os parâmetros encontrados na DeleteParameters coleção. Os seguintes métodos, propriedades e eventos de exclusão são implementados e ObjectDataSourceView expostos diretamente por seu ObjectDataSource controle para desenvolvedores de páginas e outros chamadores:

Filtrando e classificando dados

A recuperação de dados é mais eficiente quando você pode filtrar os dados dinamicamente. A filtragem só terá suporte no ObjectDataSource controle se o Select método retornar um objeto ou DataSet um DataTable objeto. Você pode usar as propriedades e FilterParameters para FilterExpression aplicar a filtragem dinâmica à recuperação de dados. Essas propriedades são implementadas pelo ObjectDataSourceView objeto e expostas diretamente por seu ObjectDataSource controle a controles associados a dados e outros chamadores.

Você pode classificar os dados que você recupera com o ObjectDataSource ordenando os dados na memória depois que eles são recuperados. A classificação só terá suporte pelo ObjectDataSource controle se o Select método retornar um DataTable ou DataSet. A CanSort propriedade sempre retorna true, porque não ObjectDataSourceView é possível determinar qual tipo é retornado pelo Select método sem chamar o método. A SortExpression sintaxe da propriedade é a mesma de uma DataView.Sort propriedade.

Estado do modo de exibição de acompanhamento

A ObjectDataSourceView implementa a interface e usa o IStateManager estado de exibição para acompanhar seu estado entre solicitações de página. A implementação do , SaveViewStatee TrackViewState métodos LoadViewStatesã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
ObjectDataSourceView(ObjectDataSource, String, HttpContext)

Inicializa uma nova instância da classe ObjectDataSourceView.

Propriedades

Nome Description
CanDelete

Obtém um valor que indica se o ObjectDataSourceView objeto associado ao controle atual ObjectDataSource dá suporte à operação de exclusão.
CanInsert

Obtém um valor que indica se o ObjectDataSourceView objeto associado ao controle atual ObjectDataSource dá suporte à operação de inserção.
CanPage

Obtém um valor que indica se o ObjectDataSourceView objeto associado ao controle atual ObjectDataSource dá suporte à paginação por meio dos dados recuperados.
CanRetrieveTotalRowCount

Obtém um valor que indica se o ObjectDataSourceView objeto associado ao controle atual ObjectDataSource 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 ObjectDataSourceView objeto associado ao controle atual ObjectDataSource dá suporte a uma exibição classificada na fonte de dados subjacente.
CanUpdate

Obtém um valor que indica se o ObjectDataSourceView objeto associado ao controle atual ObjectDataSource dá suporte à operação de atualização.
ConflictDetection

Obtém ou define um valor que determina como o ObjectDataSource controle executa atualizações e exclusões quando os dados em uma linha no armazenamento de dados subjacente são alterados durante o tempo da operação.
ConvertNullToDBNull

Obtém ou define um valor que indica se Parameter os valores passados para uma operação de atualização, inserção ou exclusão são convertidos automaticamente no nullValue valor.
DataObjectTypeName

Obtém ou define o nome de uma classe que o ObjectDataSource controle usa para um parâmetro em uma operação de dados. O ObjectDataSource controle usa a classe especificada em vez dos Parameter objetos que estão nas várias coleções de parâmetros.
DeleteMethod

Obtém ou define o nome do método ou função que o ObjectDataSourceView objeto invoca para excluir dados.
DeleteParameters

Obtém a coleção de parâmetros que contém os parâmetros usados pelo DeleteMethod método.
EnablePaging

Obtém ou define um valor que indica se o controle da fonte de dados dá suporte à paginação por meio do conjunto de dados que ele recupera.
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 método de objeto de negócios identificado pela SelectMethod propriedade é chamado.
FilterParameters

Obtém uma coleção de parâmetros associados a quaisquer espaços reservados de parâmetro que estejam na FilterExpression cadeia de caracteres.
InsertMethod

Obtém ou define o nome do método ou função que o ObjectDataSourceView objeto invoca para inserir dados.
InsertParameters

Obtém a coleção de parâmetros que contém os parâmetros usados pelo InsertMethod método.
IsTrackingViewState

Obtém um valor que indica se o ObjectDataSourceView objeto está salvando alterações em seu estado de exibição.
MaximumRowsParameterName

Obtém ou define o nome do parâmetro do método de recuperação de dados que é usado para indicar o número de registros a serem recuperados para o suporte à paginação da fonte de dados.
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 dos parâmetros para valores originais que são passados para os Delete métodos ou Update .
ParsingCulture

Obtém ou define um valor que indica quais informações de cultura são usadas ao converter valores de cadeia de caracteres em tipos de propriedade reais para construir um objeto do tipo indicado por DataObjectTypeName.
SelectCountMethod

Obtém ou define o nome do método ou função que o ObjectDataSourceView controle invoca para recuperar uma contagem de linhas.
SelectMethod

Obtém ou define o nome do método ou função que o ObjectDataSourceView controle invoca para recuperar dados.
SelectParameters

Obtém a coleção de parâmetros que contém os parâmetros usados pelo SelectMethod método.
SortParameterName

Obtém ou define o nome do parâmetro do método de recuperação de dados que é usado para especificar uma expressão de classificação para o suporte à classificação da fonte de dados.
StartRowIndexParameterName

Obtém ou define o nome do parâmetro do método de recuperação de dados que é usado para indicar o índice inteiro do primeiro registro a ser recuperado do conjunto de resultados para o suporte à paginação da fonte de dados.
TypeName

Obtém ou define o nome da classe que o ObjectDataSource controle representa.
UpdateMethod

Obtém ou define o nome do método ou função que o ObjectDataSourceView objeto invoca para atualizar dados.
UpdateParameters

Obtém a coleção de parâmetros que contém os parâmetros usados pelo UpdateMethod método.

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 chamando o método de objeto empresarial que é identificado pela DeleteMethod propriedade usando as coleções e oldValues especificadaskeys.
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 o DeleteMethod método e a coleção especificadakeys.oldValues
ExecuteInsert(IDictionary)

Executa uma operação de inserção chamando o método de objeto empresarial identificado pela InsertMethod propriedade usando a coleção especificada values .
ExecuteSelect(DataSourceSelectArguments)

Recupera dados do objeto identificado pela TypeName propriedade chamando o método identificado pela SelectMethod propriedade e passando todos os valores na SelectParameters coleção.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)

Executa uma operação de atualização chamando o método identificado pela propriedade e usando todos os UpdateMethod parâmetros fornecidos nas keysvaluescoleções.oldValues
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 chamando o método de objeto empresarial identificado pela InsertMethod propriedade usando a 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(ObjectDataSourceStatusEventArgs)

Aciona o Deleted evento depois que o ObjectDataSourceView objeto conclui uma operação de exclusão.
OnDeleting(ObjectDataSourceMethodEventArgs)

Aciona o Deleting evento antes que o ObjectDataSourceView objeto tente uma operação de exclusão.
OnFiltering(ObjectDataSourceFilteringEventArgs)

Aciona o Filtering evento antes que o ObjectDataSourceView objeto tente uma operação de filtragem.
OnInserted(ObjectDataSourceStatusEventArgs)

Aciona o Inserted evento depois que o ObjectDataSourceView objeto conclui uma operação de inserção.
OnInserting(ObjectDataSourceMethodEventArgs)

Aciona o Inserting evento antes que o ObjectDataSourceView objeto tente uma operação de inserção.
OnObjectCreated(ObjectDataSourceEventArgs)

Aciona o ObjectCreated evento após a ObjectDataSourceView criação de uma instância do objeto que é identificada pela TypeName propriedade.
OnObjectCreating(ObjectDataSourceEventArgs)

Aciona o ObjectCreating evento antes que o ObjectDataSourceView objeto crie uma instância de um objeto de negócios para executar uma operação de dados.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)

Aciona o ObjectDisposing evento antes que o ObjectDataSourceView objeto descarte um tipo instanciado.
OnSelected(ObjectDataSourceStatusEventArgs)

Aciona o Selected evento após o ObjectDataSourceView objeto concluir uma operação de recuperação de dados.
OnSelecting(ObjectDataSourceSelectingEventArgs)

Aciona o Selecting evento antes que o ObjectDataSourceView objeto tente uma operação de recuperação de dados.
OnUpdated(ObjectDataSourceStatusEventArgs)

Aciona o Updated evento depois que o ObjectDataSourceView objeto conclui uma operação de atualização.
OnUpdating(ObjectDataSourceMethodEventArgs)

Aciona o Updating evento antes que o ObjectDataSourceView objeto tente uma operação de atualização.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)

Chamado pelo RaiseUnsupportedCapabilitiesError(DataSourceView) método para comparar as funcionalidades solicitadas para uma ExecuteSelect(DataSourceSelectArguments) operação com as que a exibição dá suporte.

(Herdado de DataSourceView)
SaveViewState()

Salva as alterações no estado de exibição do ObjectDataSourceView objeto desde o momento em que a página foi postada de volta 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 objeto identificado pela TypeName propriedade chamando o método identificado pela SelectMethod propriedade e passando todos os valores na SelectParameters coleção.
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Faz com que o ObjectDataSourceView objeto acompanhe as alterações em seu estado de exibição para que as alterações possam ser armazenadas no ViewState 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 chamando o método identificado pela propriedade e usando todos os UpdateMethod parâmetros fornecidos nas keysvaluescoleções.oldValues

Eventos

Nome Description
DataSourceViewChanged

Ocorre quando a exibição da fonte de dados é alterada.

(Herdado de DataSourceView)
Deleted

Ocorre quando uma Delete operação é concluída.
Deleting

Ocorre antes de uma Delete operação.
Filtering

Ocorre antes de uma operação de filtro.
Inserted

Ocorre quando uma Insert operação é concluída.
Inserting

Ocorre antes de uma Insert operação.
ObjectCreated

Ocorre depois que o ObjectDataSourceView objeto cria uma instância do tipo que é identificado pela TypeName propriedade.
ObjectCreating

Ocorre antes que o ObjectDataSourceView objeto crie uma instância do tipo que é identificado pela TypeName propriedade.
ObjectDisposing

Ocorre quando o ObjectDataSourceView objeto descarta uma instância de um objeto que ele criou.
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 Update operação é concluída.
Updating

Ocorre antes de uma Update operaçã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().

Aplica-se a

Confira também