ObjectDataProvider Class

 

Wraps and creates an object that you can use as a binding source.

Namespace:   System.Windows.Data
Assembly:  PresentationFramework (in PresentationFramework.dll)

System.Object
  System.Windows.Data.DataSourceProvider
    System.Windows.Data.ObjectDataProvider

[LocalizabilityAttribute(LocalizationCategory.NeverLocalize)]
public class ObjectDataProvider : DataSourceProvider

NameDescription
System_CAPS_pubmethodObjectDataProvider()

Initializes a new instance of the ObjectDataProvider class.

NameDescription
System_CAPS_pubpropertyConstructorParameters

Gets the list of parameters to pass to the constructor.

System_CAPS_pubpropertyData

Gets the underlying data object.(Inherited from DataSourceProvider.)

System_CAPS_protpropertyDispatcher

Gets or sets the current Dispatcher object to the UI thread to use.(Inherited from DataSourceProvider.)

System_CAPS_pubpropertyError

Gets the error of the last query operation.(Inherited from DataSourceProvider.)

System_CAPS_pubpropertyIsAsynchronous

Gets or sets a value that indicates whether to perform object creation in a worker thread or in the active context.

System_CAPS_pubpropertyIsInitialLoadEnabled

Gets or sets a value that indicates whether to prevent or delay the automatic loading of data.(Inherited from DataSourceProvider.)

System_CAPS_protpropertyIsRefreshDeferred

Gets a value that indicates whether there is an outstanding DeferRefresh in use.(Inherited from DataSourceProvider.)

System_CAPS_pubpropertyMethodName

Gets or sets the name of the method to call.

System_CAPS_pubpropertyMethodParameters

Gets the list of parameters to pass to the method.

System_CAPS_pubpropertyObjectInstance

Gets or sets the object used as the binding source.

System_CAPS_pubpropertyObjectType

Gets or sets the type of object to create an instance of.

NameDescription
System_CAPS_protmethodBeginInit()

Indicates that initialization of this object is about to begin; no implicit Refresh occurs until the matched EndInit method is called.(Inherited from DataSourceProvider.)

System_CAPS_protmethodBeginQuery()

Starts to create the requested object, either immediately or on a background thread, based on the value of the IsAsynchronous property.(Overrides DataSourceProvider.BeginQuery().)

System_CAPS_pubmethodDeferRefresh()

Enters a defer cycle that you can use to change properties of the provider and delay automatic refresh.(Inherited from DataSourceProvider.)

System_CAPS_protmethodEndInit()

Indicates that the initialization of this object has completed; this causes a Refresh if no other DeferRefresh is outstanding.(Inherited from DataSourceProvider.)

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodInitialLoad()

Starts the initial query to the underlying data model. The result is returned on the Data property.(Inherited from DataSourceProvider.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_protmethodOnPropertyChanged(PropertyChangedEventArgs)

Raises the PropertyChanged event with the provided arguments.(Inherited from DataSourceProvider.)

System_CAPS_protmethodOnQueryFinished(Object)

Derived classes call this method to indicate that a query has finished.(Inherited from DataSourceProvider.)

System_CAPS_protmethodOnQueryFinished(Object, Exception, DispatcherOperationCallback, Object)

Derived classes call this method to indicate that a query has finished.(Inherited from DataSourceProvider.)

System_CAPS_pubmethodRefresh()

Initiates a refresh operation to the underlying data model. The result is returned on the Data property.(Inherited from DataSourceProvider.)

System_CAPS_pubmethodShouldSerializeConstructorParameters()

Indicates whether the ConstructorParameters property should be persisted.

System_CAPS_pubmethodShouldSerializeMethodParameters()

Indicates whether the MethodParameters property should be persisted.

System_CAPS_pubmethodShouldSerializeObjectInstance()

Indicates whether the ObjectInstance property should be persisted.

System_CAPS_pubmethodShouldSerializeObjectType()

Indicates whether the ObjectType property should be persisted.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

NameDescription
System_CAPS_pubeventDataChanged

Occurs when the Data property has a new value.(Inherited from DataSourceProvider.)

System_CAPS_proteventPropertyChanged

Occurs when a property value changes.(Inherited from DataSourceProvider.)

NameDescription
System_CAPS_pubinterfaceSystem_CAPS_priveventINotifyPropertyChanged.PropertyChanged

Occurs when a property value changes.(Inherited from DataSourceProvider.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodISupportInitialize.BeginInit()

This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.(Inherited from DataSourceProvider.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodISupportInitialize.EndInit()

This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.(Inherited from DataSourceProvider.)

System_CAPS_security Security Note

ObjectDataProvider fails when it does not have permissions to perform reflection on the given type or member. For more information, see Permissions Requirements in Binding Sources Overview.

There are many ways to create an object to use as a binding source. For example, you can create your object in the resources section of your Extensible Application Markup Language (XAML) page, or you can create your object in code and set it as the DataContext of your window.

ObjectDataProvider enables you to create your object in XAML and make it available as a binding source. It provides the following properties that enable you to execute a query on your object and bind to the results.

  • Use the ConstructorParameters property to pass parameters to the constructor of your object.

  • Use the MethodName property to call a method and use the MethodParameters property to pass parameters to the method. You can then bind to the results of the method.

You can also use the IsAsynchronous property to specify whether to perform object creation in a worker thread or in the active context.

This class is also useful when you want to replace your current binding source object with another object and have all the associated bindings updated.

ObjectDataProvider provides a convenient way to create and use objects as binding source objects in XAML, but it does not replace existing data models.

If you are implementing your own objects for data binding, see Binding Sources Overview for information and recommendations.

.NET Framework
Available since 3.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: