ObjectDataProvider 类

定义

命名空间:

System.Windows.Data

程序集:

PresentationFramework.dll

包装并创建一个可以用作绑定源的对象。

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

继承

Object

DataSourceProvider

ObjectDataProvider

属性

LocalizabilityAttribute

注解

重要

ObjectDataProvider 当它无权对给定类型或成员执行反射时失败。 有关详细信息，请参阅 绑定源中的权限要求概述。

创建用作绑定源的对象有多种方法。 例如，可以在可扩展应用程序标记语言（XAML）页的资源部分创建对象，也可以在代码中创建对象并将其设置为 DataContext 窗口。

ObjectDataProvider 使你能够在 XAML 中创建对象，并将其作为绑定源提供。 它提供以下属性，使你能够对对象执行查询并绑定到结果。

• 使用属性将 ConstructorParameters 参数传递给对象的构造函数。

• 使用 MethodName 属性调用方法，并使用 MethodParameters 属性将参数传递给方法。 然后，可以绑定到方法的结果。

还可以使用该 IsAsynchronous 属性指定是在工作线程还是活动上下文中执行对象创建。

如果要将当前绑定源对象替换为另一个对象并更新所有关联的绑定，此类也很有用。

ObjectDataProvider 提供了一种在 XAML 中创建和使用对象作为绑定源对象的便捷方法，但它不会替换现有数据模型。

如果要实现自己的数据绑定对象，请参阅 “绑定源概述 ”以获取信息和建议。

构造函数

名称	说明
ObjectDataProvider()	初始化 ObjectDataProvider 类的新实例。

属性

名称	说明
ConstructorParameters	获取要传递给构造函数的参数列表。
Data	获取基础数据对象。 (继承自 DataSourceProvider)
Dispatcher	获取或设置要使用的 UI 线程的当前 Dispatcher 对象。 (继承自 DataSourceProvider)
Error	获取上一个查询操作的错误。 (继承自 DataSourceProvider)
IsAsynchronous	获取或设置一个值，该值指示是在工作线程还是活动上下文中执行对象创建。
IsInitialLoadEnabled	获取或设置一个值，该值指示是阻止还是延迟自动加载数据。 (继承自 DataSourceProvider)
IsRefreshDeferred	获取一个值，该值指示是否存在未使用的未完成 DeferRefresh() 项。 (继承自 DataSourceProvider)
MethodName	获取或设置要调用的方法的名称。
MethodParameters	获取要传递给方法的参数列表。
ObjectInstance	获取或设置用作绑定源的对象。
ObjectType	获取或设置要创建其实例的对象类型。

方法

名称	说明
BeginInit()	指示此对象的初始化即将开始;在调用匹配EndInit()的方法之前，不会发生隐式Refresh()操作。 (继承自 DataSourceProvider)
BeginQuery()	开始根据属性的值 IsAsynchronous 立即或后台线程创建请求的对象。
DeferRefresh()	输入可用于更改提供程序属性并延迟自动刷新的延迟周期。 (继承自 DataSourceProvider)
EndInit()	指示此对象的初始化已完成;这会导致 Refresh() 没有其他 DeferRefresh() 项未完成。 (继承自 DataSourceProvider)
InitialLoad()	启动对基础数据模型的初始查询。 结果在属性上 Data 返回。 (继承自 DataSourceProvider)
OnPropertyChanged(PropertyChangedEventArgs)	PropertyChanged使用提供的参数引发事件。 (继承自 DataSourceProvider)
OnQueryFinished(Object, Exception, DispatcherOperationCallback, Object)	派生类调用此方法以指示查询已完成。 (继承自 DataSourceProvider)
OnQueryFinished(Object)	派生类调用此方法以指示查询已完成。 (继承自 DataSourceProvider)
Refresh()	启动基础数据模型的刷新操作。 结果在属性上 Data 返回。 (继承自 DataSourceProvider)
ShouldSerializeConstructorParameters()	指示是否 ConstructorParameters 应保留该属性。
ShouldSerializeMethodParameters()	指示是否 MethodParameters 应保留该属性。
ShouldSerializeObjectInstance()	指示是否 ObjectInstance 应保留该属性。
ShouldSerializeObjectType()	指示是否 ObjectType 应保留该属性。

活动

名称	说明
DataChanged	当 Data 属性具有新值时发生。 (继承自 DataSourceProvider)
PropertyChanged	在属性值更改时发生。 (继承自 DataSourceProvider)

显式接口实现

名称	说明
INotifyPropertyChanged.PropertyChanged	在属性值更改时发生。 (继承自 DataSourceProvider)
ISupportInitialize.BeginInit()	此成员支持 Windows Presentation Foundation （WPF） 基础结构，不应直接从代码使用。 (继承自 DataSourceProvider)
ISupportInitialize.EndInit()	此成员支持 Windows Presentation Foundation （WPF） 基础结构，不应直接从代码使用。 (继承自 DataSourceProvider)

另请参阅

• XmlDataProvider