Articolo
11/18/2011

DataServiceCollection<T> Constructor (IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams, Boolean>, Func<EntityCollectionChangedParams, Boolean>)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Creates a new instance of the DataServiceCollection<T> class a based on query execution and with the supplied change method delegates.

Namespace: System.Data.Services.Client
Assembly: System.Data.Services.Client (in System.Data.Services.Client.dll)

Syntax

'Declaration
Public Sub New ( _
    items As IEnumerable(Of T), _
    trackingMode As TrackingMode, _
    entitySetName As String, _
    entityChangedCallback As Func(Of EntityChangedParams, Boolean), _
    collectionChangedCallback As Func(Of EntityCollectionChangedParams, Boolean) _
)

public DataServiceCollection(
    IEnumerable<T> items,
    TrackingMode trackingMode,
    string entitySetName,
    Func<EntityChangedParams, bool> entityChangedCallback,
    Func<EntityCollectionChangedParams, bool> collectionChangedCallback
)

Parameters

items
Type: System.Collections.Generic.IEnumerable<T>
A DataServiceQuery<TElement> or LINQ query that returns an IEnumerable<T> collection of objects that are used to initialize the collection.

trackingMode
Type: System.Data.Services.Client.TrackingMode
A TrackingMode value that indicated whether or not changes made to items in the collection are automatically tracked.

entitySetName
Type: System.String
The entity set of the objects in the collection.

entityChangedCallback
Type: System.Func<EntityChangedParams, Boolean>
A delegate that encapsulates a method that is called when an entity changes.

collectionChangedCallback
Type: System.Func<EntityCollectionChangedParams, Boolean>
A delegate that encapsulates a method that is called when the collection of entities changes.

Remarks

The entityChanged and collectionChanged functions are invoked by the PropertyChanged and CollectionChanged events, respectively. The entityChanged method takes an EntityCollectionChangedParams value and the collectionChanged method takes a EntityChangedParams value. Both methods must return a Boolean value that indicates whether the event was handled by the function. When the method returns true, the default behavior still occurs.

By default, automatic change tracking is enabled for a DataServiceCollection<T>. You can create an instance of DataServiceCollection<T> that uses manual change tracking when you create an instance using a constructor that enables you to supply a value of None for TrackingMode. When you use manual tracking, you must implement INotifyPropertyChanged and INotifyCollectionChanged and handle the raised events to manually report changes to the DataServiceContext.

Version Information

Silverlight

Supported in: 5, 4

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Condividi tramite