ObjectDataProvider Classe

Definição

Espaço de Nomes:
System.Windows.Data
Assemblagem:
PresentationFramework.dll

Envolve e cria um objeto que podes usar como fonte de ligaçã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

Observações

Importante

ObjectDataProvider falha quando não tem permissões para realizar reflexão sobre o tipo ou membro dado. Para mais informações, consulte Requisitos de Permissões na Visão Geral de Fontes Vinculativas.

Existem muitas formas de criar um objeto para usar como fonte de ligação. Por exemplo, pode criar o seu objeto na secção de recursos da sua página de Extensible Application Markup Language (XAML), ou pode criar o seu objeto em código e defini-lo como o DataContext da sua janela.

ObjectDataProvider permite criar o seu objeto em XAML e torná-lo disponível como fonte de ligação. Fornece as seguintes propriedades que lhe permitem executar uma consulta ao seu objeto e associar aos resultados.

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

  • Use a MethodName propriedade para chamar um método e use a MethodParameters propriedade para passar parâmetros ao método. Depois, pode fazer binding aos resultados do método.

Também pode usar a IsAsynchronous propriedade para especificar se deve realizar a criação de objetos num thread de trabalho ou no contexto ativo.

Esta classe também é útil quando queres substituir o teu objeto fonte de ligação atual por outro objeto e ter todas as ligações associadas atualizadas.

ObjectDataProvider fornece uma forma conveniente de criar e usar objetos como objetos fonte de ligação em XAML, mas não substitui modelos de dados existentes.

Se estiver a implementar os seus próprios objetos para ligação de dados, consulte a Visão Geral de Fontes de Ligação para informações e recomendações.

Construtores

Name Description
ObjectDataProvider()

Inicializa uma nova instância da ObjectDataProvider classe.

Propriedades

Name Description
ConstructorParameters

Obtém a lista de parâmetros para passar ao construtor.
Data

Obtém o objeto de dados subjacente.

(Herdado de DataSourceProvider)
Dispatcher

Recebe ou define o objeto atual Dispatcher para o thread da interface para usar.

(Herdado de DataSourceProvider)
Error

Recebe o erro da última operação de consulta.

(Herdado de DataSourceProvider)
IsAsynchronous

Recebe ou define um valor que indica se deve realizar a criação de objetos num thread de trabalho ou no contexto ativo.
IsInitialLoadEnabled

Recebe ou define um valor que indica se deve impedir ou atrasar o carregamento automático dos dados.

(Herdado de DataSourceProvider)
IsRefreshDeferred

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

(Herdado de DataSourceProvider)
MethodName

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

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

Obtém ou define o objeto usado como fonte de ligação.
ObjectType

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

Métodos

Name Description
BeginInit()

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

(Herdado de DataSourceProvider)
BeginQuery()

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

Entra num ciclo de adiamento que pode usar para alterar as propriedades do fornecedor e atrasar a atualização automática.

(Herdado de DataSourceProvider)
EndInit()

Indica que a inicialização deste objeto foi concluída; Isto causa um Refresh() caso se não houver outro DeferRefresh() pendente.

(Herdado de DataSourceProvider)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitialLoad()

Inicia a consulta inicial ao modelo de dados subjacente. O resultado é devolvido à Data propriedade.

(Herdado de DataSourceProvider)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnPropertyChanged(PropertyChangedEventArgs)

Levanta o PropertyChanged evento com os argumentos apresentados.

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

As classes derivadas chamam este método para indicar que uma consulta terminou.

(Herdado de DataSourceProvider)
OnQueryFinished(Object)

As classes derivadas chamam este método para indicar que uma consulta terminou.

(Herdado de DataSourceProvider)
Refresh()

Inicia uma operação de atualização do modelo de dados subjacente. O resultado é devolvido à 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()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

evento

Name Description
DataChanged

Ocorre quando a Data propriedade ganha um novo valor.

(Herdado de DataSourceProvider)
PropertyChanged

Ocorre quando o valor de uma propriedade muda.

(Herdado de DataSourceProvider)

Implementações de Interface Explícita

Name Description
INotifyPropertyChanged.PropertyChanged

Ocorre quando o valor de uma propriedade muda.

(Herdado de DataSourceProvider)
ISupportInitialize.BeginInit()

Este membro suporta a infraestrutura Windows Presentation Foundation (WPF) e não foi concebido para ser usado diretamente a partir do seu código.

(Herdado de DataSourceProvider)
ISupportInitialize.EndInit()

Este membro suporta a infraestrutura Windows Presentation Foundation (WPF) e não foi concebido para ser usado diretamente a partir do seu código.

(Herdado de DataSourceProvider)

Aplica-se a

Ver também