DataSourceProvider Class

 

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.

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


public abstract class DataSourceProvider : INotifyPropertyChanged, 
	ISupportInitialize

NameDescription
System_CAPS_protmethodDataSourceProvider()

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

NameDescription
System_CAPS_pubpropertyData

Gets the underlying data object.

System_CAPS_protpropertyDispatcher

Gets or sets the current Dispatcher object to the UI thread to use.

System_CAPS_pubpropertyError

Gets the error of the last query operation.

System_CAPS_pubpropertyIsInitialLoadEnabled

Gets or sets a value that indicates whether to prevent or delay the automatic loading of data.

System_CAPS_protpropertyIsRefreshDeferred

Gets a value that indicates whether there is an outstanding DeferRefresh in use.

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.

System_CAPS_protmethodBeginQuery()

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.

System_CAPS_pubmethodDeferRefresh()

Enters a defer cycle that you can use to change properties of the provider and delay automatic refresh.

System_CAPS_protmethodEndInit()

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

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.

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.

System_CAPS_protmethodOnQueryFinished(Object)

Derived classes call this method to indicate that a query has finished.

System_CAPS_protmethodOnQueryFinished(Object, Exception, DispatcherOperationCallback, Object)

Derived classes call this method to indicate that a query has finished.

System_CAPS_pubmethodRefresh()

Initiates a refresh operation to the underlying data model. The result is returned on the Data property.

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.

System_CAPS_proteventPropertyChanged

Occurs when a property value changes.

NameDescription
System_CAPS_pubinterfaceSystem_CAPS_priveventINotifyPropertyChanged.PropertyChanged

Occurs when a property value changes.

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.

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.

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.

.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: