ObjectDataSourceView 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 a controle de ObjectDataSource e fornece uma interface para controles ligados a dados executar operações de dados com objetos de negócios e de dados.

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 as Selectoperações , Update, Deletee Insert , 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ágina não acessam a instância da ObjectDataSourceView classe diretamente. Os desenvolvedores de controle podem criar controles de dados personalizados estendendo as ObjectDataSource classes e ObjectDataSourceView .

A ObjectDataSourceView classe executa operações de dados chamando métodos em objetos corporativos ou de dados 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 não é exposto diretamente aos desenvolvedores de página pelo ObjectDataSource controle . Em vez disso, as propriedades e os ObjectDataSourceView métodos do são acessados por meio do ObjectDataSource. Por exemplo, o DeleteMethod da ObjectDataSourceView propriedade é definido 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:

O método Select
A propriedade SelectMethod
A propriedade SelectParameters
O evento Selecting
O evento Selected

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 atualizações automaticamente, como os GridView controles e DetailsView , passam seus parâmetros em uma IOrderedDictionary interface para o ObjectDataSourceView e o objeto de exibição mescla esses parâmetros com quaisquer parâmetros encontrados na UpdateParameters coleção.

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

O método Update
A propriedade UpdateMethod
A propriedade UpdateParameters
O evento Updating
O evento Updated

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 GridView DetailsView, passam seus parâmetros em uma IOrderedDictionary interface para o ObjectDataSourceView e o objeto de exibição mescla esses parâmetros com quaisquer parâmetros encontrados na InsertParameters coleção.

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

O método Insert
A propriedade InsertMethod
A propriedade InsertParameters
O evento Inserting
O evento Inserted

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 GridView DetailsView, passam seus parâmetros em uma IOrderedDictionary interface para o ObjectDataSourceView e o objeto de exibição mescla esses parâmetros com quaisquer parâmetros encontrados na DeleteParameters coleção. Os seguintes métodos, propriedades e eventos de exclusão são implementados pelo ObjectDataSourceView e expostos diretamente por seu ObjectDataSource controle para desenvolvedores de páginas e outros chamadores:

O método Delete
A propriedade DeleteMethod
A propriedade DeleteParameters
O evento Deleting
O evento Deleted

Filtragem e classificação de dados

A recuperação de dados é mais eficiente quando você pode filtrar os dados dinamicamente. A filtragem só terá suporte pelo ObjectDataSource controle se o Select método retornar um DataTable objeto ou DataSet . Você pode usar as FilterExpression propriedades e FilterParameters para 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 recuperados 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 o ObjectDataSourceView não pode 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

O 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 dos LoadViewStatemétodos , SaveViewStatee TrackViewState são fornecidos 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

ObjectDataSourceView(ObjectDataSource, String, HttpContext)

Inicializa uma nova instância da classe ObjectDataSourceView.

Propriedades

CanDelete	Obtém um valor que indica se o objeto ObjectDataSourceView associado ao controle ObjectDataSource atual é compatível com a operação de exclusão.
CanInsert	Obtém um valor que indica se o objeto ObjectDataSourceView associado ao controle ObjectDataSource atual é compatível com a operação de inserção.
CanPage	Obtém um valor que indica se o objeto ObjectDataSourceView associado ao controle ObjectDataSource atual é compatível com a paginação por meio dos dados recuperados.
CanRetrieveTotalRowCount	Obtém um valor que indica se o objeto ObjectDataSourceView associado ao controle ObjectDataSource 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 ObjectDataSourceView associado ao controle ObjectDataSource atual é compatível com uma exibição classificada na fonte de dados subjacente.
CanUpdate	Obtém um valor que indica se o objeto ObjectDataSourceView associado ao controle ObjectDataSource atual é compatível com a operação de atualização.
ConflictDetection	Obtém ou define um valor que determina como o controle ObjectDataSource executa atualizações e exclusões quando os dados em uma linha no armazenamento de dados subjacente é alterado durante a operação.
ConvertNullToDBNull	Obtém ou define um valor que indica se os valores Parameter passados para uma operação de atualização, inserção ou exclusão são automaticamente convertidos de `null` para o valor Value.
DataObjectTypeName	Obtém ou define o nome de uma classe que o controle ObjectDataSource usa para um parâmetro em uma operação de dados. O controle ObjectDataSource usa a classe especificada, em vez dos objetos Parameter que estão nas várias coleções de parâmetros.
DeleteMethod	Obtém ou define o nome do método ou da função invocada pelo objeto ObjectDataSourceView para excluir os dados.
DeleteParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo método DeleteMethod.
EnablePaging	Obtém ou define um valor que indica se o controle de fonte de dados é compatível com paginação no conjunto de dados que recupera.
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 aplicada quando o método de objeto de negócios identificado pela propriedade SelectMethod é chamado.
FilterParameters	Obtém uma coleção de parâmetros associados a quaisquer espaços reservados para parâmetro na cadeia de caracteres FilterExpression.
InsertMethod	Obtém ou define o nome do método ou da função invocada pelo objeto ObjectDataSourceView para inserir os dados.
InsertParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo método InsertMethod.
IsTrackingViewState	Obtém um valor que indica se o objeto ObjectDataSourceView está salvando alterações no estado de exibição.
MaximumRowsParameterName	Obtém ou define o nome do parâmetro de método de recuperação de dados usado para indicar o número de registros a serem recuperados para o suporte à paginação de 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 para aplicar aos nomes dos parâmetros para os valores originais que são passados para os métodos `Delete` 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 invocada pelo controle ObjectDataSourceView para recuperar uma contagem de linhas.
SelectMethod	Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSourceView para recuperar dados.
SelectParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo método SelectMethod.
SortParameterName	Obtém ou define o nome do parâmetro do método de recuperação de dados usado para especificar uma expressão de classificação para suporte à classificação de fonte de dados.
StartRowIndexParameterName	Obtém ou define o nome do parâmetro do método de recuperação de dados usado para indicar o índice do inteiro do primeiro registro a ser recuperado do conjunto de resultados para suporte à paginação de fonte de dados.
TypeName	Obtém ou define o nome da classe que o controle ObjectDataSource representa.
UpdateMethod	Obtém ou define o nome do método ou da função invocada pelo objeto ObjectDataSourceView para atualizar os dados.
UpdateParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo método UpdateMethod.

Métodos

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 objeto DataSourceView representa. (Herdado de DataSourceView)
Delete(IDictionary, IDictionary)	Executa uma operação de exclusão chamando o método de objeto de negócios identificado pela propriedade DeleteMethod usando as coleções `keys` e `oldValues`.
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 método DeleteMethod e a coleção `keys` e `oldValues` especificada.
ExecuteInsert(IDictionary)	Executa uma operação de inserção chamando o método de objeto de negócios identificado pela propriedade InsertMethod usando a coleção `values` especificada.
ExecuteSelect(DataSourceSelectArguments)	Recupera dados do objeto identificado pela propriedade TypeName chamando o método identificado pela propriedade SelectMethod e passando valores na coleção SelectParameters.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Executa uma operação de atualização chamando o método identificado pela propriedade UpdateMethod e usando parâmetros fornecidos nas coleções `keys`, `values` ou `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 objeto DataSourceView representa. (Herdado de DataSourceView)
Insert(IDictionary)	Executa uma operação de inserção chamando o método de objeto de negócios identificado pela propriedade InsertMethod usando a coleção `values` especificada.
LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente para a 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(ObjectDataSourceStatusEventArgs)	Gerará o evento Deleted depois que o objeto ObjectDataSourceView concluir uma operação de exclusão.
OnDeleting(ObjectDataSourceMethodEventArgs)	Gerará o evento Deleting antes de o objeto ObjectDataSourceView tentar uma operação de exclusão.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Gerará o evento Filtering antes de o objeto ObjectDataSourceView tentar uma operação de filtragem.
OnInserted(ObjectDataSourceStatusEventArgs)	Gerará o evento Inserted depois que o objeto ObjectDataSourceView concluir uma operação de inserção.
OnInserting(ObjectDataSourceMethodEventArgs)	Gerará o evento Inserting antes de o objeto ObjectDataSourceView tentar uma operação de inserção.
OnObjectCreated(ObjectDataSourceEventArgs)	Gerará o evento ObjectCreated depois que o ObjectDataSourceView criar uma instância do objeto identificado pela propriedade TypeName.
OnObjectCreating(ObjectDataSourceEventArgs)	Gerará o evento ObjectCreating antes de o objeto ObjectDataSourceView criar uma instância de um objeto de negócios para executar uma operação de dados.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	Gerará o evento ObjectDisposing antes de o objeto ObjectDataSourceView descartar um tipo instanciado.
OnSelected(ObjectDataSourceStatusEventArgs)	Gerará o evento Selected após o objeto ObjectDataSourceView ter concluído uma operação de recuperação de dados.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Gerará o evento Selecting antes de o objeto ObjectDataSourceView tentar uma operação de recuperação de dados.
OnUpdated(ObjectDataSourceStatusEventArgs)	Gerará o evento Updated depois que o objeto ObjectDataSourceView concluir uma operação de atualização.
OnUpdating(ObjectDataSourceMethodEventArgs)	Gera o evento Updating antes de o objeto ObjectDataSourceView tentar realizar uma operação de atualização.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Chamado pelo método RaiseUnsupportedCapabilitiesError(DataSourceView) para comparar as funcionalidades solicitadas para uma operação ExecuteSelect(DataSourceSelectArguments) em relação às que a exibição dá suporte. (Herdado de DataSourceView)
SaveViewState()	Salva as alterações no estado de exibição para o objeto ObjectDataSourceView desde a hora 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 propriedade TypeName chamando o método identificado pela propriedade SelectMethod e passando valores na coleção SelectParameters.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz o objeto ObjectDataSourceView acompanhar as alterações em seu estado de exibição para que elas possam ser armazenadas no objeto ViewState para o controle e persistente entre as 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 objeto DataSourceView representa. (Herdado de DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Executa uma operação de atualização chamando o método identificado pela propriedade UpdateMethod e usando parâmetros fornecidos nas coleções `keys`, `values` ou `oldValues`.

Eventos

DataSourceViewChanged	Ocorre quando a exibição da fonte de dados foi alterada. (Herdado de DataSourceView)
Deleted	Ocorre quando uma operação Delete foi concluída.
Deleting	Ocorre antes de uma operação Delete.
Filtering	Ocorre antes de uma operação de filtragem.
Inserted	Ocorre quando uma operação Insert foi concluída.
Inserting	Ocorre antes de uma operação de Insert.
ObjectCreated	Ocorre após um objeto ObjectDataSourceView criar uma instância do tipo identificado pela propriedade TypeName.
ObjectCreating	Ocorre antes de um objeto ObjectDataSourceView criar uma instância do tipo identificado pela propriedade TypeName.
ObjectDisposing	Ocorre quando o objeto ObjectDataSourceView descarta uma instância de um objeto que ele criou.
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 Update foi concluída.
Updating	Ocorre antes de uma operação de Update.

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