ObjectDataSourceView Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Suporta o ObjectDataSource controlo e fornece uma interface para controlos ligados a dados realizarem operações de dados com objetos de negócio 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

Observações

A ObjectDataSourceView classe destina-se principalmente a ser usada por controlos encadernados por dados, e não como um objeto programável em código de página.

A ObjectDataSourceView classe implementa a funcionalidade de dados para o ObjectDataSource controlo, incluindo , Select Update, Delete, e Insert operações, ordenação, filtragem e gestão das definições mantidas no estado de visualização.

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

A ObjectDataSourceView classe realiza operações de dados chamando métodos em objetos de negócio ou dados através de reflexão. Em tempo de execução, o controlo ObjectDataSource cria uma instância do tipo identificada pela TypeName propriedade e depois 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 em Visual Basic), uma instância não é criada, mas o método de operação de dados continua a ser chamado.

Não ObjectDataSourceView é diretamente exposto aos programadores de páginas pelo ObjectDataSource controlo. Em vez disso, as propriedades e métodos do ObjectDataSourceView são acedidos através do ObjectDataSource. Por exemplo, a DeleteMethod propriedade de ObjectDataSourceView é definida definindo a DeleteMethod propriedade de .ObjectDataSource

Recuperando dados

A operação mais básica que uma vista de fonte de dados realiza é a recuperação de dados do armazenamento 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 pelo seu ObjectDataSource controlo aos programadores de páginas e outros chamadores:

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

Atualização de dados

O ObjectDataSourceView objeto suporta atualizações de dados ao chamar um negócio ou método de objeto de dados identificado pela UpdateMethod propriedade. Controlos data-bound que realizam automaticamente atualizações, como os GridView controlos e, DetailsView passam os seus parâmetros numa IOrderedDictionary interface para o ObjectDataSourceView e o objeto view funde esses parâmetros com quaisquer parâmetros encontrados na UpdateParameters coleção.

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

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

Inserção de Dados

O ObjectDataSourceView objeto suporta a inserção de novas linhas de dados chamando um negócio ou método de objeto de dados identificado pela InsertMethod propriedade. Controlos data-bound que realizam automaticamente inserções, como o GridView e DetailsView, passam os seus parâmetros numa IOrderedDictionary interface para o ObjectDataSourceView e o objeto view funde estes parâmetros com quaisquer parâmetros encontrados na InsertParameters coleção.

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

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

Apagando dados

O ObjectDataSourceView objeto suporta a eliminação de dados chamando um método de negócio ou de objeto de dados identificado pela DeleteMethod propriedade. Os controlos data-bound que executam automaticamente eliminações, como o GridView e , passam os seus parâmetros numa IOrderedDictionary interface para o ObjectDataSourceView e o objeto view funde esses parâmetros com quaisquer parâmetros encontrados na DeleteParameters coleçãoDetailsView. Os seguintes métodos, propriedades e eventos de eliminação são implementados pelo ObjectDataSourceView e expostos diretamente pelo seu ObjectDataSource controlo aos programadores de páginas e outros chamadores:

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

Filtragem e Ordenação de Dados

A recuperação de dados é mais poderosa quando se pode filtrar os dados dinamicamente. A filtragem é suportada apenas pelo ObjectDataSource controlo se o Select método devolver um DataTable objeto ou DataSet . Pode usar as FilterExpression propriedades e FilterParameters para aplicar filtragem dinâmica à recuperação de dados. Estas propriedades são implementadas pelo ObjectDataSourceView objeto e expostas diretamente pelo seu ObjectDataSource controlo a controlos vinculados a dados e outros chamadores.

Podes ordenar os dados que ObjectDataSource recuperas ordenando os dados na memória depois de recuperados. A ordenação é suportada apenas pelo ObjectDataSource controlo se o Select método devolver um DataTable ou DataSet. A CanSort propriedade devolve truesempre , porque o ObjectDataSourceView não pode determinar que tipo é devolvido pelo Select método sem chamar o método. A SortExpression sintaxe da propriedade é a mesma que para uma DataView.Sort propriedade.

Estado da Visualização de Rastreio

Implementa ObjectDataSourceView a IStateManager interface e utiliza o estado de visualização para acompanhar o seu estado através dos pedidos de página. A implementação dos LoadViewStatemétodos , SaveViewState, e TrackViewState é fornecida para permitir o rastreio do estado da vista para o controlo. Para mais informações, consulte ASP.NET Visão Geral da Gestão do Estado.

Construtores

Name	Description
ObjectDataSourceView(ObjectDataSource, String, HttpContext)	Inicializa uma nova instância da ObjectDataSourceView classe.

Propriedades

Name	Description
CanDelete	Recebe um valor que indica se o ObjectDataSourceView objeto associado ao controlo atual ObjectDataSource suporta a operação de eliminação.
CanInsert	Recebe um valor que indica se o ObjectDataSourceView objeto associado ao controlo atual ObjectDataSource suporta a operação de inserção.
CanPage	Obtém um valor que indica se o ObjectDataSourceView objeto associado ao controlo atual ObjectDataSource suporta a paginação através dos dados recuperados.
CanRetrieveTotalRowCount	Recebe um valor que indica se o ObjectDataSourceView objeto associado ao controlo atual ObjectDataSource suporta 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 ObjectDataSourceView objeto associado ao controlo atual ObjectDataSource suporta uma visão ordenada na fonte de dados subjacente.
CanUpdate	Recebe um valor que indica se o ObjectDataSourceView objeto associado ao controlo atual ObjectDataSource suporta a operação de atualização.
ConflictDetection	Recebe ou define um valor que determina como o ObjectDataSource controlo realiza atualizações e eliminações quando dados numa linha no armazenamento subjacente mudam durante o tempo da operação.
ConvertNullToDBNull	Recebe ou define um valor que indica se Parameter os valores que são passados para uma operação de atualização, inserção ou eliminação são automaticamente convertidos para `null` o Value valor.
DataObjectTypeName	Obtém ou define o nome de uma classe que o ObjectDataSource controlo usa para um parâmetro numa operação de dados. O ObjectDataSource controlo utiliza 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 eliminar dados.
DeleteParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo DeleteMethod método.
EnablePaging	Recebe ou define um valor que indica se o controlo de fonte de dados suporta a paginação através do conjunto de dados que recupera.
Events	Obtém uma lista de delegados handler de eventos para a vista da fonte de dados. (Herdado de DataSourceView)
FilterExpression	Obtém ou define uma expressão de filtragem que é aplicada quando o método do objeto de negócio identificado pela SelectMethod propriedade é chamado.
FilterParameters	Obtém uma coleção de parâmetros associados a quaisquer marcadores de parâmetros que estejam na FilterExpression string.
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	Recebe um valor que indica se o ObjectDataSourceView objeto está a guardar alterações ao seu estado de visualizaçã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 registos a recuperar para suporte à paginação da fonte de dados.
Name	Obtém o nome da vista da fonte de dados. (Herdado de DataSourceView)
OldValuesParameterFormatString	Obtém ou define uma cadeia de formatos para aplicar aos nomes dos parâmetros dos valores originais que são passados para os `Delete` métodos ou `Update` .
ParsingCulture	Obtém um ou define um valor que indica que informação de cultura é usada ao converter valores de cadeia 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 controlo invoca para recuperar uma contagem de linhas.
SelectMethod	Obtém ou define o nome do método ou função que o ObjectDataSourceView controlo 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 ordenação para suporte à ordenação de fontes 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 registo a recolher do conjunto de resultados para suporte à paginação da fonte de dados.
TypeName	Recebe ou define o nome da classe que o ObjectDataSource controlo representa.
UpdateMethod	Obtém ou define o nome do método ou função que o ObjectDataSourceView objeto invoca para atualizar os dados.
UpdateParameters	Obtém a coleção de parâmetros que contém os parâmetros usados pelo UpdateMethod método.

Métodos

Name	Description
CanExecute(String)	Determina se o comando especificado pode ser executado. (Herdado de DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Realiza uma operação de eliminação assíncrona na lista de dados que o DataSourceView objeto representa. (Herdado de DataSourceView)
Delete(IDictionary, IDictionary)	Realiza uma operação de eliminação chamando o método do objeto de negócio identificado pela DeleteMethod propriedade usando as colecções `oldValues` e especificados`keys`.
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)	Realiza uma operação de eliminação usando o DeleteMethod método e a coleção e especificado `keysoldValues` .
ExecuteInsert(IDictionary)	Realiza uma operação de inserção chamando o método de objeto de negócio identificado pela InsertMethod propriedade usando a coleção especificada `values` .
ExecuteSelect(DataSourceSelectArguments)	Recupera dados do objeto identificados pela TypeName propriedade chamando o método identificado pela SelectMethod propriedade e passando quaisquer valores na SelectParameters coleção.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Realiza uma operação de atualização chamando o método identificado pela UpdateMethod propriedade e usando quaisquer parâmetros fornecidos nas `keys`coleções, `values`, ou `oldValues` .
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Realiza uma operação de inserção assíncrona na lista de dados que o DataSourceView objeto representa. (Herdado de DataSourceView)
Insert(IDictionary)	Realiza uma operação de inserção chamando o método de objeto de negócio identificado pela InsertMethod propriedade usando a coleção especificada `values` .
LoadViewState(Object)	Restaura o estado da vista previamente guardada para a vista da fonte de dados.
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnDataSourceViewChanged(EventArgs)	Eleva o DataSourceViewChanged evento. (Herdado de DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)	Levanta o Deleted evento depois de o ObjectDataSourceView objeto ter concluído uma operação de eliminação.
OnDeleting(ObjectDataSourceMethodEventArgs)	Levanta o Deleting evento antes do ObjectDataSourceView objeto tentar uma operação de eliminação.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Levanta o Filtering evento antes de o ObjectDataSourceView objeto tentar uma operação de filtragem.
OnInserted(ObjectDataSourceStatusEventArgs)	Levanta o Inserted evento depois de o ObjectDataSourceView objeto ter concluído uma operação de inserção.
OnInserting(ObjectDataSourceMethodEventArgs)	Levanta o Inserting evento antes de o ObjectDataSourceView objeto tentar uma operação de inserção.
OnObjectCreated(ObjectDataSourceEventArgs)	Levanta o ObjectCreated evento depois de ObjectDataSourceView criar uma instância do objeto identificada pela TypeName propriedade.
OnObjectCreating(ObjectDataSourceEventArgs)	Levanta o ObjectCreating evento antes de o ObjectDataSourceView objeto criar uma instância de um objeto de negócio para realizar uma operação de dados.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	Aumenta o ObjectDisposing evento antes de o ObjectDataSourceView objeto descartar um tipo instanciado.
OnSelected(ObjectDataSourceStatusEventArgs)	Levanta o Selected evento após o ObjectDataSourceView objeto ter concluído uma operação de recuperação de dados.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Levanta o Selecting evento antes de o ObjectDataSourceView objeto tentar uma operação de recuperação de dados.
OnUpdated(ObjectDataSourceStatusEventArgs)	Levanta o Updated evento depois de o ObjectDataSourceView objeto ter concluído uma operação de atualização.
OnUpdating(ObjectDataSourceMethodEventArgs)	Levanta o Updating evento antes do ObjectDataSourceView objeto tentar uma operação de atualização.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Chamado pelo RaiseUnsupportedCapabilitiesError(DataSourceView) método para comparar as capacidades solicitadas para uma ExecuteSelect(DataSourceSelectArguments) operação com aquelas que a vista suporta. (Herdado de DataSourceView)
SaveViewState()	Guarda as alterações ao estado de visualização do ObjectDataSourceView objeto desde o momento em que a página foi publicada de volta no servidor.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Obtém uma lista de dados assíncrona a partir do armazenamento subjacente. (Herdado de DataSourceView)
Select(DataSourceSelectArguments)	Recupera dados do objeto identificados pela TypeName propriedade chamando o método identificado pela SelectMethod propriedade e passando quaisquer valores na SelectParameters coleção.
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz com que o ObjectDataSourceView objeto acompanhe alterações ao seu estado de visualização para que as alterações possam ser armazenadas no ViewState objeto para o controlo e persistir entre pedidos para a mesma página.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Realiza uma operação de atualização assíncrona na lista de dados que o DataSourceView objeto representa. (Herdado de DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Realiza uma operação de atualização chamando o método identificado pela UpdateMethod propriedade e usando quaisquer parâmetros fornecidos nas `keys`coleções, `values`, ou `oldValues` .

evento

Name	Description
DataSourceViewChanged	Ocorre quando a vista da fonte de dados mudou. (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 filtragem.
Inserted	Ocorre quando uma Insert operação é concluída.
Inserting	Ocorre antes de uma Insert operação.
ObjectCreated	Ocorre depois de o ObjectDataSourceView objeto criar uma instância do tipo identificada pela TypeName propriedade.
ObjectCreating	Ocorre antes de o ObjectDataSourceView objeto criar uma instância do tipo identificada pela TypeName propriedade.
ObjectDisposing	Ocorre quando o ObjectDataSourceView objeto descarta uma instância de um objeto que criou.
Selected	Ocorre quando uma operação de recuperação de dados foi 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.

Implementações de Interface Explícita

Name	Description
IStateManager.IsTrackingViewState	Para uma descrição deste elemento, veja IsTrackingViewState.
IStateManager.LoadViewState(Object)	Para uma descrição deste elemento, veja LoadViewState(Object).
IStateManager.SaveViewState()	Para uma descrição deste elemento, veja SaveViewState().
IStateManager.TrackViewState()	Para uma descrição deste elemento, veja TrackViewState().

Aplica-se a

Ver também

Comentários

Esta página foi útil?