DataSourceProvider Class

Reference

Definition

Namespace:: System.Windows.Data

Assembly:: WindowsBase.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Common base class and contract for DataSourceProvider objects, which are factories that execute some queries to produce a single object or a list of objects that you can use as binding source objects.

public ref class DataSourceProvider abstract : System::ComponentModel::INotifyPropertyChanged, System::ComponentModel::ISupportInitialize

public abstract class DataSourceProvider : System.ComponentModel.INotifyPropertyChanged, System.ComponentModel.ISupportInitialize

type DataSourceProvider = class
    interface INotifyPropertyChanged
    interface ISupportInitialize

Public MustInherit Class DataSourceProvider
Implements INotifyPropertyChanged, ISupportInitialize

Inheritance: Object
DataSourceProvider

Derived: System.Windows.Data.ObjectDataProvider

System.Windows.Data.XmlDataProvider

Implements: INotifyPropertyChanged ISupportInitialize

Remarks

DataSourceProvider is a convenience wrapper around an existing data model; it does not replace any data model. A data provider does not attempt to condense the complexity and versatility of a data model such as ADO into one single object with a few properties.

DataSourceProvider is an abstract class. Use one of the derived classes, which are XmlDataProvider and ObjectDataProvider. The DataSourceProvider is aware of the Windows Presentation Foundation (WPF) threading and dispatcher model. It assumes the thread at creation time to be the UI thread. Events will get marshaled from a worker thread to the UI thread of the application.

Constructors

DataSourceProvider()

Initializes a new instance of the DataSourceProvider class. This is a protected constructor.

Properties

Data	Gets the underlying data object.
Dispatcher	Gets or sets the current Dispatcher object to the UI thread to use.
Error	Gets the error of the last query operation.
IsInitialLoadEnabled	Gets or sets a value that indicates whether to prevent or delay the automatic loading of data.
IsRefreshDeferred	Gets a value that indicates whether there is an outstanding DeferRefresh() in use.

Methods

BeginInit()	Indicates that initialization of this object is about to begin; no implicit Refresh() occurs until the matched EndInit() method is called.
BeginQuery()	When overridden in a derived class, this base class calls this method when InitialLoad() or Refresh() has been called. The base class delays the call if refresh is deferred or initial load is disabled.
DeferRefresh()	Enters a defer cycle that you can use to change properties of the provider and delay automatic refresh.
EndInit()	Indicates that the initialization of this object has completed; this causes a Refresh() if no other DeferRefresh() is outstanding.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
InitialLoad()	Starts the initial query to the underlying data model. The result is returned on the Data property.
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
OnPropertyChanged(PropertyChangedEventArgs)	Raises the PropertyChanged event with the provided arguments.
OnQueryFinished(Object, Exception, DispatcherOperationCallback, Object)	Derived classes call this method to indicate that a query has finished.
OnQueryFinished(Object)	Derived classes call this method to indicate that a query has finished.
Refresh()	Initiates a refresh operation to the underlying data model. The result is returned on the Data property.
ToString()	Returns a string that represents the current object. (Inherited from Object)

Events

DataChanged	Occurs when the Data property has a new value.
PropertyChanged	Occurs when a property value changes.

Explicit Interface Implementations

INotifyPropertyChanged.PropertyChanged	Occurs when a property value changes.
ISupportInitialize.BeginInit()	This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.
ISupportInitialize.EndInit()	This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

Applies to

Share via