ObjectDataSourceView Classe

Definição

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

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:

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:

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

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

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

Confira também