Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe ObjectDataSourceView

Oferece suporte a ObjectDataSource de controle e fornece uma interface para controles ligados a dados executar operações de dados com objetos de negócios e dados.

System.Object
  System.Web.UI.DataSourceView
    System.Web.UI.WebControls.ObjectDataSourceView

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

public class ObjectDataSourceView : DataSourceView, 
	IStateManager

O tipo ObjectDataSourceView expõe os membros a seguir.

  NomeDescrição
Método públicoObjectDataSourceViewInicializa uma nova instância da classe ObjectDataSourceView.
Superior

  NomeDescrição
Propriedade públicaCanDeleteObtém um valor indicando se a ObjectDataSourceView o objeto que está associado com o atual ObjectDataSource controle suporta a operação de exclusão. (Substitui DataSourceView.CanDelete.)
Propriedade públicaCanInsertObtém um valor indicando se a ObjectDataSourceView o objeto que está associado com o atual ObjectDataSource controle suporta a operação de inserção. (Substitui DataSourceView.CanInsert.)
Propriedade públicaCanPageObtém um valor indicando se a ObjectDataSourceView o objeto que está associado com o atual ObjectDataSource controle suporta paginação de dados recuperados. (Substitui DataSourceView.CanPage.)
Propriedade públicaCanRetrieveTotalRowCountObtém um valor indicando se a ObjectDataSourceView o objeto que está associado com o atual ObjectDataSource controle suporta a recuperar o número total de linhas de dados, com o conjunto de dados. (Substitui DataSourceView.CanRetrieveTotalRowCount.)
Propriedade públicaCanSortObtém um valor indicando se a ObjectDataSourceView o objeto que está associado com o atual ObjectDataSource controle suporta uma exibição classificada na fonte de dados subjacente. (Substitui DataSourceView.CanSort.)
Propriedade públicaCanUpdateObtém um valor indicando se a ObjectDataSourceView o objeto que está associado com o atual ObjectDataSource controle suporta a operação de atualização. (Substitui DataSourceView.CanUpdate.)
Propriedade públicaConflictDetectionObtém ou define um valor que determina como o ObjectDataSource controle executa atualizações e exclusões quando dados em uma linha no armazenamento de dados subjacentes forem alterados durante o tempo da operação.
Propriedade públicaConvertNullToDBNullObtém ou define um valor indicando se Parameter valores que são passados para uma atualização, inserção ou operação de exclusão são automaticamente convertidas de null para o Value valor.
Propriedade públicaDataObjectTypeNameObtém ou define o nome de uma classe que o ObjectDataSource controle usa um parâmetro em uma operação de dados. O ObjectDataSource controle usa a classe especificada em vez da Parameter os objetos que estão em várias coleções de parâmetros.
Propriedade públicaDeleteMethodObtém ou define o nome do método ou função que o ObjectDataSourceView objeto invoca para excluir dados.
Propriedade públicaDeleteParametersObtém a coleção de parâmetros que contém os parâmetros que são usados pela DeleteMethod método.
Propriedade públicaEnablePagingObtém ou define um valor indicando se o controle da fonte de dados oferece suporte à paginação por meio do conjunto de dados que recupera.
Propriedade protegidaEventsObtém uma lista de delegados manipuladores de eventos para o modo de exibição de fonte de dados. (Herdado de DataSourceView.)
Propriedade públicaFilterExpressionObtém ou define uma expressão de filtragem é aplicada quando o método do objeto de negócios que é identificado pelo SelectMethod é chamada de propriedade.
Propriedade públicaFilterParametersObtém uma coleção de parâmetros que estão associados com espaços reservados de parâmetro que estão na FilterExpression seqüência de caracteres.
Propriedade públicaInsertMethodObtém ou define o nome do método ou função que o ObjectDataSourceView objeto invoca para inserir dados.
Propriedade públicaInsertParametersObtém a coleção de parâmetros que contém os parâmetros que são usados pela InsertMethod método.
Propriedade protegidaIsTrackingViewStateObtém um valor indicando se a ObjectDataSourceView objeto está salvando as alterações ao seu estado de exibição.
Propriedade públicaMaximumRowsParameterNameObtém ou define o nome do parâmetro de método de recuperação de dados que é usado para indicar o número de registros a recuperar para suporte de paginação de fonte de dados.
Propriedade públicaNameObtém o nome de exibição da fonte de dados. (Herdado de DataSourceView.)
Propriedade públicaOldValuesParameterFormatStringObtém ou define uma seqüência de caracteres de formato para aplicar os nomes dos parâmetros para valores originais que são passados para o Delete ou Update métodos.
Propriedade públicaParsingCultureObtém um ou define um valor que indica quais informações de cultura são usadas quando a conversão de valores de seqüência de caracteres para os tipos de propriedade real para construir um objeto do tipo indicado por DataObjectTypeName.
Propriedade públicaSelectCountMethodObtém ou define o nome do método ou função que o ObjectDataSourceView controle invoca para recuperar uma contagem de linhas.
Propriedade públicaSelectMethodObtém ou define o nome do método ou função que o ObjectDataSourceView controle invoca para recuperar dados.
Propriedade públicaSelectParametersObtém a coleção de parâmetros que contém os parâmetros que são usados pela SelectMethod método.
Propriedade públicaSortParameterNameObtém ou define o nome do parâmetro de método de recuperação dados que é usado para especificar uma expressão de classificação para a classificação de suporte de fonte de dados.
Propriedade públicaStartRowIndexParameterNameObtém ou define o nome do parâmetro de método de recuperação dados que é usado para indicar o índice inteiro do primeiro registro para recuperar-se dos resultados definido para o suporte de paginação de fonte de dados.
Propriedade públicaTypeNameObtém ou define o nome da classe que o ObjectDataSource controlar representa.
Propriedade públicaUpdateMethodObtém ou define o nome do método ou função que o ObjectDataSourceView objeto invoca para atualizar dados.
Propriedade públicaUpdateParametersObtém a coleção de parâmetros que contém os parâmetros que são usados pela UpdateMethod método.
Superior

  NomeDescrição
Método públicoCanExecuteDetermina se o comando especificado pode ser executado. (Herdado de DataSourceView.)
Método públicoDelete(IDictionary, IDictionary)Executa uma operação de exclusão, chamando o método de objeto de negócios que é identificado pelo DeleteMethod propriedade usando o especificado keys e oldValues coleções.
Método públicoDelete(IDictionary, IDictionary, DataSourceViewOperationCallback)Executa uma operação assíncrona de exclusão na lista de dados que o DataSourceView de objeto representa. (Herdado de DataSourceView.)
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoExecuteCommand(String, IDictionary, IDictionary)Executa o comando especificado. (Herdado de DataSourceView.)
Método públicoExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)Executa o comando especificado. (Herdado de DataSourceView.)
Método protegidoExecuteDeleteExecuta uma operação de exclusão usando o DeleteMethod método e especificado keys e oldValues coleção. (Substitui DataSourceView.ExecuteDelete(IDictionary, IDictionary).)
Método protegidoExecuteInsertExecuta uma operação de inserção, chamando o método de objeto de negócios que é identificado pelo InsertMethod propriedade usando o especificado values coleção. (Substitui DataSourceView.ExecuteInsert(IDictionary).)
Método protegidoExecuteSelectRecupera dados de objeto que é identificado pelo TypeName propriedade chamando o método que é identificada pela SelectMethod de propriedade e passando qualquer valor na SelectParameters coleção. (Substitui DataSourceView.ExecuteSelect(DataSourceSelectArguments).)
Método protegidoExecuteUpdateExecuta uma operação de atualização chamando o método que é identificado pelo UpdateMethod propriedade e o uso de parâmetros que são fornecidos na keys, values, ou oldValues coleções. (Substitui DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary).)
Método protegidoFinalize Permite um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoInsert(IDictionary)Executa uma operação de inserção, chamando o método de objeto de negócios que é identificado pelo InsertMethod propriedade usando o especificado values coleção.
Método públicoInsert(IDictionary, DataSourceViewOperationCallback)Executa uma operação de inserção assíncrona na lista de dados que o DataSourceView de objeto representa. (Herdado de DataSourceView.)
Método protegidoLoadViewStateRestaurações anteriormente salvo o estado de exibição para o modo de exibição de fonte de dados.
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método protegidoOnDataSourceViewChangedGera o evento DataSourceViewChanged. (Herdado de DataSourceView.)
Método protegidoOnDeletedEleva o Deleted evento após o ObjectDataSourceView objeto concluiu uma operação de exclusão.
Método protegidoOnDeletingEleva o Deleting evento antes de ObjectDataSourceView objeto tenta uma operação de exclusão.
Método protegidoOnFilteringEleva o Filtering evento antes de ObjectDataSourceView objeto tenta uma operação de filtragem.
Método protegidoOnInsertedEleva o Inserted evento após o ObjectDataSourceView objeto concluiu uma operação de inserção.
Método protegidoOnInsertingEleva o Inserting evento antes de ObjectDataSourceView objeto tenta uma operação de inserção.
Método protegidoOnObjectCreatedEleva o ObjectCreated evento após o ObjectDataSourceView cria uma instância do objeto que é identificado pelo TypeName propriedade.
Método protegidoOnObjectCreatingEleva o ObjectCreating evento antes de ObjectDataSourceView objeto cria uma instância de um objeto de negócios para realizar uma operação de dados.
Método protegidoOnObjectDisposingEleva o ObjectDisposing evento antes de ObjectDataSourceView descartes de objetos de um tipo instanciado.
Método protegidoOnSelectedEleva o Selected evento após o ObjectDataSourceView objeto concluiu uma operação de recuperação de dados.
Método protegidoOnSelectingEleva o Selecting evento antes de ObjectDataSourceView objeto tenta uma operação de recuperação de dados.
Método protegidoOnUpdatedEleva o Updated evento após o ObjectDataSourceView objeto concluiu uma operação de atualização.
Método protegidoOnUpdatingEleva o Updating evento antes de ObjectDataSourceView objeto tenta executar uma operação de atualização.
Método protegidoRaiseUnsupportedCapabilityErrorChamado pelo RaiseUnsupportedCapabilitiesError método para comparar os recursos solicitados para um ExecuteSelect operação contra aqueles que oferece suporte para o modo de exibição. (Herdado de DataSourceView.)
Método protegidoSaveViewStateSalva as alterações para o estado de exibição para o ObjectDataSourceView objeto desde o momento em que a página foi lançada para o servidor.
Método públicoSelect(DataSourceSelectArguments)Recupera dados de objeto que é identificado pelo TypeName propriedade chamando o método que é identificada pela SelectMethod de propriedade e passando qualquer valor na SelectParameters coleção.
Método públicoSelect(DataSourceSelectArguments, DataSourceViewSelectCallback)Obtém uma lista de dados de forma assíncrona do armazenamento de dados subjacente. (Herdado de DataSourceView.)
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Método protegidoTrackViewStateFaz com que o ObjectDataSourceView o objeto para controlar alterações ao seu estado de exibição para que as alterações podem ser armazenadas na ViewState objeto para o controle e persistentes entre as solicitações para a mesma página.
Método públicoUpdate(IDictionary, IDictionary, IDictionary)Executa uma operação de atualização chamando o método que é identificado pelo UpdateMethod propriedade e o uso de parâmetros que são fornecidos na keys, values, ou oldValues coleções.
Método públicoUpdate(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)Executa uma operação de atualização assíncrona na lista de dados que o DataSourceView de objeto representa. (Herdado de DataSourceView.)
Superior

  NomeDescrição
Evento públicoDataSourceViewChangedOcorre quando o modo de exibição de fonte de dados foi alterado. (Herdado de DataSourceView.)
Evento públicoDeletedOcorre quando um Delete operação foi concluída.
Evento públicoDeletingOcorre antes de um Delete operação.
Evento públicoFilteringOcorre antes de uma operação de filtro.
Evento públicoInsertedOcorre quando um Insert operação foi concluída.
Evento públicoInsertingOcorre antes de um Insert operação.
Evento públicoObjectCreatedOcorre após a ObjectDataSourceView objeto cria uma instância do tipo que está identificado o TypeName propriedade.
Evento públicoObjectCreatingOcorre antes do ObjectDataSourceView objeto cria uma instância do tipo que está identificado o TypeName propriedade.
Evento públicoObjectDisposingOcorre quando o ObjectDataSourceView object descarta uma instância de um objeto que ele criou.
Evento públicoSelectedOcorre quando uma operação de recuperação de dados foi concluída.
Evento públicoSelectingOcorre antes de uma operação de recuperação de dados.
Evento públicoUpdatedOcorre quando um Update operação foi concluída.
Evento públicoUpdatingOcorre antes de um Update operação.
Superior

  NomeDescrição
Implementação explícita da interfacePropriedade particularIStateManager.IsTrackingViewStatePara obter uma descrição desse membro, consulte IsTrackingViewState.
Implementação explícita da interfaceMétodo particularIStateManager.LoadViewStateInfraestrutura. Para obter uma descrição desse membro, consulte IStateManager.LoadViewState.
Implementação explícita da interfaceMétodo particularIStateManager.SaveViewStateInfraestrutura. Para obter uma descrição desse membro, consulte IStateManager.SaveViewState.
Implementação explícita da interfaceMétodo particularIStateManager.TrackViewStateInfraestrutura. Para obter uma descrição desse membro, consulte IStateManager.TrackViewState.
Superior

O ObjectDataSourceView classe destina-se principalmente a ser usado por controles ligados a dados e não como um objeto programável no código da página.

O ObjectDataSourceView classe implementa a funcionalidade de dados para o ObjectDataSource controle, inclusive o Select, Update, Delete, e Insert operações, classificação, filtragem e gerenciamento de configurações mantidos no modo de exibição estado.

A ObjectDataSourceView objeto é criado para cada instância de ObjectDataSource classe em tempo de execução. Chamadas para operações de dados da instância da ObjectDataSource classe são manipulados pela instância da ObjectDataSourceView objeto. Os desenvolvedores de páginas não acessar a instância da ObjectDataSourceView de classe diretamente. Os desenvolvedores de controle podem criar controles de dados personalizados, estendendo a ObjectDataSource e ObjectDataSourceView classes.

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

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

Recuperando dados

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

Atualização de dados

O ObjectDataSourceView objeto oferece suporte a atualizações de dados, chamando um método de objeto comercial ou dados que é identificado pelo UpdateMethod propriedade. Controles ligados a dados que executam automaticamente as atualizações, como o GridView e DetailsView controles, passar os parâmetros em um IOrderedDictionary de interface para o ObjectDataSourceView e o objeto view mescla esses parâmetros com os parâmetros que são encontrados na UpdateParameters coleção.

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

Inserindo dados

O ObjectDataSourceView objeto oferece suporte inserir novas linhas de dados, chamando um método de objeto comercial ou dados que é identificado pelo InsertMethod propriedade. Controles ligados a dados que executam automaticamente inserções, como o GridView e DetailsView, passar os parâmetros em um IOrderedDictionary de interface para o ObjectDataSourceView e o objeto view mescla esses parâmetros com os parâmetros que são encontrados na InsertParameters coleção.

O seguinte insere métodos, propriedades, e eventos são implementados pela ObjectDataSourceView e expostos diretamente pelo seu ObjectDataSource controle para os desenvolvedores de páginas e outros chamadores:

A exclusão de dados

O ObjectDataSourceView objeto oferece suporte a exclusão de dados, chamando um método de objeto comercial ou dados que é identificado pelo DeleteMethod propriedade. Controles ligados a dados que executam automaticamente as exclusões, como o GridView e DetailsView, passar os parâmetros em um IOrderedDictionary de interface para o ObjectDataSourceView e o objeto view mescla esses parâmetros com os parâmetros que são encontrados na DeleteParameters coleção. O seguinte excluir métodos, propriedades, e eventos são implementados pela ObjectDataSourceView e expostos diretamente pelo seu ObjectDataSource controle para os desenvolvedores de páginas e outros chamadores:

Filtrando e classificando dados

Recuperação de dados é mais poderosa quando você pode filtrar os dados dinamicamente. A filtragem é suportada somente pelo ObjectDataSource de controle se o Select método retorna um DataTable ou DataSet objeto. Você pode usar o FilterExpression e FilterParameters propriedades para aplicar a filtragem dinâmica para recuperação de dados. Essas propriedades são implementadas pela ObjectDataSourceView de objeto e expostos diretamente pelo seu ObjectDataSource controle para controles ligados a dados e outros chamadores.

Você pode classificar os dados recuperados com o ObjectDataSource , encomendando os dados na memória depois que ela é recuperada. Classificação é suportada somente pelo ObjectDataSource de controle se o Select método retorna um DataTable ou DataSet. O CanSort propriedade sempre retorna true, porque o ObjectDataSourceView não é possível determinar o tipo retornado pelo Select método sem chamar o método. O SortExpression sintaxe de propriedade é o mesmo para uma DataView.Sort propriedade.

Estado de exibição do controle

O ObjectDataSourceView implementa o IStateManager interface e usos exibir estado para controlar seu estado em solicitações de página. Implementação da LoadViewState, SaveViewState, e TrackViewState métodos são fornecidos para habilitar o rastreamento de estado de exibição para o controle. Para obter mais informações, consulte Visão Geral sobre o Gerenciamento de Estado do ASP.NET.

.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft