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()	指示即将开始初始化此对象；在调用匹配的 Refresh() 方法前不要进行隐式 EndInit()。 (继承自 DataSourceProvider)
BeginQuery()	根据 IsAsynchronous 属性的值，立即开始创建请求的对象，或在后台线程上开始创建。
DeferRefresh()	进入延迟循环，该循环可用于更改提供程序的属性并延迟自动刷新。 (继承自 DataSourceProvider)
EndInit()	表示此对象的初始化已完成；如果没有其他未完成的 Refresh()，则这会导致 DeferRefresh()。 (继承自 DataSourceProvider)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
InitialLoad()	启动对基础数据模型的初始查询。 结果返回到 Data 属性。 (继承自 DataSourceProvider)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnPropertyChanged(PropertyChangedEventArgs)	通过提供的参数引发 PropertyChanged 事件。 (继承自 DataSourceProvider)
OnQueryFinished(Object)	派生类调用此方法以指示查询已完成。 (继承自 DataSourceProvider)
OnQueryFinished(Object, Exception, DispatcherOperationCallback, Object)	派生类调用此方法以指示查询已完成。 (继承自 DataSourceProvider)
Refresh()	启动对基础数据模型的刷新操作。 结果返回到 Data 属性。 (继承自 DataSourceProvider)
ShouldSerializeConstructorParameters()	指示是否应使 ConstructorParameters 属性持久化。
ShouldSerializeMethodParameters()	指示是否应使 MethodParameters 属性持久化。
ShouldSerializeObjectInstance()	指示是否应使 ObjectInstance 属性持久化。
ShouldSerializeObjectType()	指示是否应使 ObjectType 属性持久化。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

事件

DataChanged	在 Data 属性具有一个新值时发生。 (继承自 DataSourceProvider)
PropertyChanged	在属性值更改时发生。 (继承自 DataSourceProvider)

显式接口实现

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

另请参阅

• XmlDataProvider