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 當它沒有在指定類型或成員上執行反映的許可權時，就會失敗。 如需詳細資訊，請參閱 系結來源概觀中的許可權需求。

建立物件做為系結來源的方式有很多種。 例如，您可以在 Extensible Application Markup Language (XAML) 頁面的資源區段中建立物件，也可以在程式碼中建立物件，並將其設定為 DataContext 視窗的 。

ObjectDataProvider 可讓您在 XAML 中建立物件，並使它成為系結來源。 它提供下列屬性，可讓您在物件上執行查詢，並系結至結果。

• ConstructorParameters使用 屬性將參數傳遞至物件的建構函式。

• MethodName使用 屬性來呼叫 方法，並使用 MethodParameters 屬性將參數傳遞至 方法。 然後，您可以系結至 方法的結果。

您也可以使用 IsAsynchronous 屬性來指定是否要在背景工作執行緒或作用中內容中執行物件建立。

當您想要將目前的系結來源物件取代為另一個物件，並更新所有相關聯的系結時，這個類別也很有用。

ObjectDataProvider 提供方便的方式，可在 XAML 中建立和使用物件作為系結來源物件，但不會取代現有的資料模型。

如果您要實作自己的物件來進行資料系結，請參閱系結 來源概觀 以取得資訊和建議。

建構函式

ObjectDataProvider()

初始化 ObjectDataProvider 類別的新執行個體。

屬性

ConstructorParameters	取得要傳遞至建構函式的參數清單。
Data	取得基礎資料物件。 (繼承來源 DataSourceProvider)
Dispatcher	取得或設定要使用的 UI 執行緒目前的 Dispatcher 物件。 (繼承來源 DataSourceProvider)
Error	取得上次查詢作業的錯誤。 (繼承來源 DataSourceProvider)
IsAsynchronous	取得或設定值，指出要在背景工作執行緒 (Worker Thread) 或主動式內容中執行物件建立。
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