Compartilhar via

ObjectDataProvider Classe

Definição

Namespace:
System.Windows.Data
Assembly:
PresentationFramework.dll

Encapsula e cria um objeto que você pode usar como uma origem de associação.

public ref class ObjectDataProvider : System::Windows::Data::DataSourceProvider
[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public class ObjectDataProvider : System.Windows.Data.DataSourceProvider
[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
type ObjectDataProvider = class
    inherit DataSourceProvider
Public Class ObjectDataProvider
Inherits DataSourceProvider
Herança
Object
DataSourceProvider
ObjectDataProvider
Atributos
LocalizabilityAttribute

Comentários

Importante

ObjectDataProvider falha quando ele não tem permissões para executar reflexão sobre o tipo ou membro fornecido. Para obter mais informações, consulte Os requisitos de permissões na visão geral das fontes de associação.

Há muitas maneiras de criar um objeto a ser usado como uma origem de associação. Por exemplo, você pode criar seu objeto na seção de recursos da página XAML (Extensible Application Markup Language) ou pode criar seu objeto no código e defini-lo como a DataContext da janela.

ObjectDataProvider permite que você crie seu objeto em XAML e disponibilize-o como uma origem de associação. Ele fornece as propriedades a seguir que permitem executar uma consulta em seu objeto e associar-se aos resultados.

  • Use a ConstructorParameters propriedade para passar parâmetros para o construtor do objeto.

  • Use a MethodName propriedade para chamar um método e usar a MethodParameters propriedade para passar parâmetros para o método. Em seguida, você pode associar-se aos resultados do método.

Você também pode usar a IsAsynchronous propriedade para especificar se deseja executar a criação de objeto em um thread de trabalho ou no contexto ativo.

Essa classe também é útil quando você deseja substituir seu objeto de origem de associação atual por outro objeto e ter todas as associações associadas atualizadas.

ObjectDataProvider fornece uma maneira conveniente de criar e usar objetos como objetos de origem de associação no XAML, mas não substitui os modelos de dados existentes.

Se você estiver implementando seus próprios objetos para associação de dados, consulte Visão geral de fontes de associação para obter informações e recomendações.

Construtores

Nome Description
ObjectDataProvider()

Inicializa uma nova instância da classe ObjectDataProvider.

Propriedades

Nome Description
ConstructorParameters

Obtém a lista de parâmetros a serem passados para o construtor.
Data

Obtém o objeto de dados subjacente.

(Herdado de DataSourceProvider)
Dispatcher

Obtém ou define o objeto atual Dispatcher para o thread de interface do usuário a ser usado.

(Herdado de DataSourceProvider)
Error

Obtém o erro da última operação de consulta.

(Herdado de DataSourceProvider)
IsAsynchronous

Obtém ou define um valor que indica se deseja executar a criação de objeto em um thread de trabalho ou no contexto ativo.
IsInitialLoadEnabled

Obtém ou define um valor que indica se o carregamento automático de dados deve ser evitado ou atrasado.

(Herdado de DataSourceProvider)
IsRefreshDeferred

Obtém um valor que indica se há um pendente DeferRefresh() em uso.

(Herdado de DataSourceProvider)
MethodName

Obtém ou define o nome do método a ser chamado.
MethodParameters

Obtém a lista de parâmetros a serem passados para o método.
ObjectInstance

Obtém ou define o objeto usado como a origem da associação.
ObjectType

Obtém ou define o tipo de objeto do qual criar uma instância.

Métodos

Nome Description
BeginInit()

Indica que a inicialização desse objeto está prestes a começar; não ocorrerá implícito Refresh() até que o método correspondente EndInit() seja chamado.

(Herdado de DataSourceProvider)
BeginQuery()

Começa a criar o objeto solicitado, imediatamente ou em um thread em segundo plano, com base no valor da IsAsynchronous propriedade.
DeferRefresh()

Insere um ciclo de adiamento que você pode usar para alterar as propriedades do provedor e atrasar a atualização automática.

(Herdado de DataSourceProvider)
EndInit()

Indica que a inicialização desse objeto foi concluída; isso causa um Refresh() se nenhum outro DeferRefresh() estiver pendente.

(Herdado de DataSourceProvider)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
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)
InitialLoad()

Inicia a consulta inicial para o modelo de dados subjacente. O resultado é retornado na Data propriedade.

(Herdado de DataSourceProvider)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
OnPropertyChanged(PropertyChangedEventArgs)

Gera o PropertyChanged evento com os argumentos fornecidos.

(Herdado de DataSourceProvider)
OnQueryFinished(Object, Exception, DispatcherOperationCallback, Object)

Classes derivadas chamam esse método para indicar que uma consulta foi concluída.

(Herdado de DataSourceProvider)
OnQueryFinished(Object)

Classes derivadas chamam esse método para indicar que uma consulta foi concluída.

(Herdado de DataSourceProvider)
Refresh()

Inicia uma operação de atualização para o modelo de dados subjacente. O resultado é retornado na Data propriedade.

(Herdado de DataSourceProvider)
ShouldSerializeConstructorParameters()

Indica se a ConstructorParameters propriedade deve ser mantida.
ShouldSerializeMethodParameters()

Indica se a MethodParameters propriedade deve ser mantida.
ShouldSerializeObjectInstance()

Indica se a ObjectInstance propriedade deve ser mantida.
ShouldSerializeObjectType()

Indica se a ObjectType propriedade deve ser mantida.
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Eventos

Nome Description
DataChanged

Ocorre quando a Data propriedade tem um novo valor.

(Herdado de DataSourceProvider)
PropertyChanged

Ocorre quando um valor de propriedade é alterado.

(Herdado de DataSourceProvider)

Implantações explícitas de interface

Nome Description
INotifyPropertyChanged.PropertyChanged

Ocorre quando um valor de propriedade é alterado.

(Herdado de DataSourceProvider)
ISupportInitialize.BeginInit()

Esse membro dá suporte à infraestrutura do WPF (Windows Presentation Foundation) e não se destina a ser usado diretamente do seu código.

(Herdado de DataSourceProvider)
ISupportInitialize.EndInit()

Esse membro dá suporte à infraestrutura do WPF (Windows Presentation Foundation) e não se destina a ser usado diretamente do seu código.

(Herdado de DataSourceProvider)

Aplica-se a

Confira também