Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe ObjectDataSourceView

 

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

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

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

public class ObjectDataSourceView : DataSourceView, IStateManager

NomeDescrição
System_CAPS_pubmethodObjectDataSourceView(ObjectDataSource, String, HttpContext)

Inicializa uma nova instância da classe ObjectDataSourceView.

NomeDescrição
System_CAPS_pubpropertyCanDelete

Obtém um valor que indica se o ObjectDataSourceView objeto associado atual ObjectDataSource controle oferece suporte para a operação de exclusão.(Substitui o DataSourceView.CanDelete.)

System_CAPS_pubpropertyCanInsert

Obtém um valor que indica se o ObjectDataSourceView objeto associado atual ObjectDataSource controle oferece suporte para a operação de inserção.(Substitui o DataSourceView.CanInsert.)

System_CAPS_pubpropertyCanPage

Obtém um valor que indica se o ObjectDataSourceView objeto associado atual ObjectDataSource controle dá suporte à paginação de dados recuperados.(Substitui o DataSourceView.CanPage.)

System_CAPS_pubpropertyCanRetrieveTotalRowCount

Obtém um valor que indica se o ObjectDataSourceView objeto associado atual ObjectDataSource controle oferece suporte para recuperar o número total de linhas de dados, além do conjunto de dados.(Substitui o DataSourceView.CanRetrieveTotalRowCount.)

System_CAPS_pubpropertyCanSort

Obtém um valor que indica se o ObjectDataSourceView objeto associado atual ObjectDataSource controle oferece suporte a uma exibição classificada na fonte de dados subjacente.(Substitui o DataSourceView.CanSort.)

System_CAPS_pubpropertyCanUpdate

Obtém um valor que indica se o ObjectDataSourceView objeto associado atual ObjectDataSource controle oferece suporte para a operação de atualização.(Substitui o DataSourceView.CanUpdate.)

System_CAPS_pubpropertyConflictDetection

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

System_CAPS_pubpropertyConvertNullToDBNull

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

System_CAPS_pubpropertyDataObjectTypeName

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

System_CAPS_pubpropertyDeleteMethod

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

System_CAPS_pubpropertyDeleteParameters

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

System_CAPS_pubpropertyEnablePaging

Obtém ou define um valor que indica se o controle da fonte de dados oferece suporte à paginação por meio do conjunto de dados que ela recupera.

System_CAPS_protpropertyEvents

Obtém uma lista dos representantes do manipulador de eventos para o modo de exibição de fonte de dados.(Herdado de DataSourceView.)

System_CAPS_pubpropertyFilterExpression

Obtém ou define uma expressão de filtragem é aplicada quando o método de objeto comercial que é identificado pelo SelectMethod propriedade é chamada.

System_CAPS_pubpropertyFilterParameters

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

System_CAPS_pubpropertyInsertMethod

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

System_CAPS_pubpropertyInsertParameters

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

System_CAPS_protpropertyIsTrackingViewState

Obtém um valor que indica se o ObjectDataSourceView objeto é salvar alterações no estado de exibição.

System_CAPS_pubpropertyMaximumRowsParameterName

Obtém ou define o nome do parâmetro do método recuperação de dados que é usado para indicar o número de registros a serem recuperados para suporte à paginação de fonte de dados.

System_CAPS_pubpropertyName

Obtém o nome da exibição da fonte de dados.(Herdado de DataSourceView.)

System_CAPS_pubpropertyOldValuesParameterFormatString

Obtém ou define uma cadeia de caracteres de formato para aplicar aos nomes dos parâmetros para os valores originais são passados para o Delete ou Update métodos.

System_CAPS_pubpropertyParsingCulture

Obtém um ou define um valor que indica quais informações de cultura são usadas quando a conversão de valores de cadeia de caracteres em tipos de propriedade real para construir um objeto do tipo indicado pelo DataObjectTypeName.

System_CAPS_pubpropertySelectCountMethod

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

System_CAPS_pubpropertySelectMethod

Obtém ou define o nome do método ou da função invocada pelo controle ObjectDataSourceView para recuperar dados.

System_CAPS_pubpropertySelectParameters

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

System_CAPS_pubpropertySortParameterName

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

System_CAPS_pubpropertyStartRowIndexParameterName

Obtém ou define o nome do parâmetro do método recuperação de dados que é usado para indicar o índice inteiro do primeiro registro para recuperar os resultados definido para suporte à paginação de fonte de dados.

System_CAPS_pubpropertyTypeName

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

System_CAPS_pubpropertyUpdateMethod

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

System_CAPS_pubpropertyUpdateParameters

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

NomeDescrição
System_CAPS_pubmethodCanExecute(String)

Determina se o comando especificado pode ser executado.(Herdado de DataSourceView.)

System_CAPS_pubmethodDelete(IDictionary, IDictionary)

Executa uma operação de exclusão, chamando o método de objeto comercial que é identificado pelo DeleteMethod propriedade usando especificado keys e oldValues coleções.

System_CAPS_pubmethodDelete(IDictionary, IDictionary, DataSourceViewOperationCallback)

Executa uma operação de exclusão assíncrona na lista de dados que o DataSourceView objeto representa.(Herdado de DataSourceView.)

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodExecuteCommand(String, IDictionary, IDictionary)

Executa o comando especificado.(Herdado de DataSourceView.)

System_CAPS_pubmethodExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

Executa o comando especificado.(Herdado de DataSourceView.)

System_CAPS_protmethodExecuteDelete(IDictionary, IDictionary)

Executa uma operação de exclusão usando o DeleteMethod especificado e método keys e oldValues coleção.(Substitui o DataSourceView.ExecuteDelete(IDictionary, IDictionary).)

System_CAPS_protmethodExecuteInsert(IDictionary)

Executa uma operação de inserção, chamando o método de objeto comercial que é identificado pelo InsertMethod propriedade usando especificado values coleção.(Substitui o DataSourceView.ExecuteInsert(IDictionary).)

System_CAPS_protmethodExecuteSelect(DataSourceSelectArguments)

Recupera dados do objeto que é identificado pelo TypeName propriedade chamando o método que é identificada pelo SelectMethod propriedade e passar os valores no SelectParameters coleção.(Substitui o DataSourceView.ExecuteSelect(DataSourceSelectArguments).)

System_CAPS_protmethodExecuteUpdate(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 no keys, values, ou oldValues coleções.(Substitui o DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary).)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodInsert(IDictionary)

Executa uma operação de inserção, chamando o método de objeto comercial que é identificado pelo InsertMethod propriedade usando especificado values coleção.

System_CAPS_pubmethodInsert(IDictionary, DataSourceViewOperationCallback)

Executa uma operação de inserção assíncrona na lista de dados que o DataSourceView objeto representa.(Herdado de DataSourceView.)

System_CAPS_protmethodLoadViewState(Object)

Restaurações salvou o estado de exibição para o modo de exibição de fonte de dados.

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_protmethodOnDataSourceViewChanged(EventArgs)

Gera o DataSourceViewChanged evento.(Herdado de DataSourceView.)

System_CAPS_protmethodOnDeleted(ObjectDataSourceStatusEventArgs)

Gera o Deleted evento após o ObjectDataSourceView objeto concluiu uma operação de exclusão.

System_CAPS_protmethodOnDeleting(ObjectDataSourceMethodEventArgs)

Gera o Deleting evento antes do ObjectDataSourceView objeto tenta uma operação de exclusão.

System_CAPS_protmethodOnFiltering(ObjectDataSourceFilteringEventArgs)

Gera o Filtering evento antes do ObjectDataSourceView objeto tenta uma operação de filtragem.

System_CAPS_protmethodOnInserted(ObjectDataSourceStatusEventArgs)

Gera o Inserted evento após o ObjectDataSourceView objeto concluiu uma operação de inserção.

System_CAPS_protmethodOnInserting(ObjectDataSourceMethodEventArgs)

Gera o Inserting evento antes do ObjectDataSourceView objeto tenta uma operação de inserção.

System_CAPS_protmethodOnObjectCreated(ObjectDataSourceEventArgs)

Gera o ObjectCreated evento após o ObjectDataSourceView cria uma instância do objeto que é identificado pelo TypeName propriedade.

System_CAPS_protmethodOnObjectCreating(ObjectDataSourceEventArgs)

Gera o ObjectCreating evento antes do ObjectDataSourceView objeto cria uma instância de um objeto comercial para executar uma operação de dados.

System_CAPS_protmethodOnObjectDisposing(ObjectDataSourceDisposingEventArgs)

Gera o ObjectDisposing evento antes do ObjectDataSourceView object descarta um tipo instanciado.

System_CAPS_protmethodOnSelected(ObjectDataSourceStatusEventArgs)

Gera o Selected evento após o ObjectDataSourceView objeto concluiu uma operação de recuperação de dados.

System_CAPS_protmethodOnSelecting(ObjectDataSourceSelectingEventArgs)

Gera o Selecting evento antes do ObjectDataSourceView objeto tenta uma operação de recuperação de dados.

System_CAPS_protmethodOnUpdated(ObjectDataSourceStatusEventArgs)

Gera o Updated evento após o ObjectDataSourceView objeto concluiu uma operação de atualização.

System_CAPS_protmethodOnUpdating(ObjectDataSourceMethodEventArgs)

Gera o Updating evento antes do ObjectDataSourceView objeto tenta uma operação de atualização.

System_CAPS_protmethodRaiseUnsupportedCapabilityError(DataSourceCapabilities)

Chamado pelo RaiseUnsupportedCapabilitiesError método para comparar os recursos solicitados para um ExecuteSelect operação contra aqueles que oferece suporte ao modo de exibição.(Herdado de DataSourceView.)

System_CAPS_protmethodSaveViewState()

Salva as alterações para o estado de exibição para o ObjectDataSourceView objeto desde a hora em que a página foi lançada para o servidor.

System_CAPS_pubmethodSelect(DataSourceSelectArguments)

Recupera dados do objeto que é identificado pelo TypeName propriedade chamando o método que é identificada pelo SelectMethod propriedade e passar os valores no SelectParameters coleção.

System_CAPS_pubmethodSelect(DataSourceSelectArguments, DataSourceViewSelectCallback)

Obtém uma lista de dados de forma assíncrona do armazenamento de dados subjacente.(Herdado de DataSourceView.)

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

System_CAPS_protmethodTrackViewState()

Faz com que o ObjectDataSourceView objeto para controlar alterações em seu estado de exibição para que as alterações podem ser armazenadas no ViewState objeto para o controle e persistentes entre solicitações para a mesma página.

System_CAPS_pubmethodUpdate(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 no keys, values, ou oldValues coleções.

System_CAPS_pubmethodUpdate(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.)

NomeDescrição
System_CAPS_pubeventDataSourceViewChanged

Ocorre quando o modo de exibição de fonte de dados foi alterado.(Herdado de DataSourceView.)

System_CAPS_pubeventDeleted

Ocorre quando um Delete operação foi concluída.

System_CAPS_pubeventDeleting

Ocorre antes de uma Delete operação.

System_CAPS_pubeventFiltering

Ocorre antes de uma operação de filtro.

System_CAPS_pubeventInserted

Ocorre quando um Insert operação foi concluída.

System_CAPS_pubeventInserting

Ocorre antes de uma Insert operação.

System_CAPS_pubeventObjectCreated

Ocorre após o ObjectDataSourceView objeto cria uma instância do tipo que é identificado pelo TypeName propriedade.

System_CAPS_pubeventObjectCreating

Ocorre antes do ObjectDataSourceView objeto cria uma instância do tipo que é identificado pelo TypeName propriedade.

System_CAPS_pubeventObjectDisposing

Ocorre quando o ObjectDataSourceView object descarta uma instância de um objeto que foi criada.

System_CAPS_pubeventSelected

Ocorre quando uma operação de recuperação de dados é concluída.

System_CAPS_pubeventSelecting

Ocorre antes de uma operação de recuperação de dados.

System_CAPS_pubeventUpdated

Ocorre quando um Update operação foi concluída.

System_CAPS_pubeventUpdating

Ocorre antes de uma Update operação.

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Para obter uma descrição desse membro, consulte IStateManager.LoadViewState.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Para obter uma descrição desse membro, consulte IStateManager.SaveViewState.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Para obter uma descrição desse membro, consulte IStateManager.TrackViewState.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Para obter uma descrição desse membro, consulte IsTrackingViewState.

O ObjectDataSourceView classe é destinada principalmente para ser usado pelos 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 controlar, incluindo o Select, Update, Delete, e Insert operações, classificação, filtragem e gerenciamento das configurações de mantivessem na exibição estado.

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

O ObjectDataSourceView classe executa operações de dados chamando os métodos em objetos de negócios ou dados usando reflexão. Em tempo de execução, o ObjectDataSource controle cria uma instância do tipo que é identificado pelo 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, o 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), não é possível criar uma instância, mas ainda é chamado de método de operação de dados.

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

A operação mais básica que executa 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 coleção de itens de dados. Os seguintes métodos de recuperação de dados, propriedades e eventos são implementados pelo ObjectDataSourceView do objeto e expostos diretamente por seu ObjectDataSource controle para os desenvolvedores de páginas e outros chamadores:

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 atualizações, como o GridView e DetailsView controles, passar os parâmetros em um IOrderedDictionary de interface para o ObjectDataSourceView e o objeto de exibição mescla esses parâmetros com os parâmetros que são encontrados no 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 os desenvolvedores de páginas e outros chamadores:

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

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

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 exclui, como o GridView e DetailsView, passar os parâmetros em um IOrderedDictionary de interface para o ObjectDataSourceView e o objeto de exibição mescla esses parâmetros com os parâmetros que são encontrados no DeleteParameters coleção. O seguinte excluir métodos, propriedades e eventos são implementados pelo ObjectDataSourceView e expostos diretamente por seu ObjectDataSource controle para os desenvolvedores de páginas e outros chamadores:

Recuperação de dados é mais eficiente quando você pode filtrar os dados dinamicamente. A filtragem é suportada somente pelo ObjectDataSource controlar 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 à recuperação de dados. Essas propriedades são implementadas pelo ObjectDataSourceView do objeto e expostos diretamente por seu ObjectDataSource controle para controles ligados a dados e outros chamadores.

Você pode classificar os dados recuperados com o ObjectDataSource ordenando os dados na memória depois de recuperados. A classificação é suportada somente pelo ObjectDataSource controlar 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 é a mesma usada para um DataView.Sort propriedade.

O ObjectDataSourceView implementa o IStateManager interface e usa estado de exibição para controlar o estado entre solicitações de página. Implementação de 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 ASP.NET State Management Overview.

.NET Framework
Disponível desde 2.0

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

Retornar ao início
Mostrar: