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

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

Namespace:  System.Data.Services.Client
Assembly:  Microsoft.Data.Services.Client (in Microsoft.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) _
)
'Usage
Dim items As IEnumerable(Of T)
Dim trackingMode As TrackingMode 
Dim entitySetName As String 
Dim entityChangedCallback As Func(Of EntityChangedParams, Boolean)
Dim collectionChangedCallback As Func(Of EntityCollectionChangedParams, Boolean)

Dim instance As New DataServiceCollection(items, trackingMode, _
    entitySetName, entityChangedCallback, _
    collectionChangedCallback)
public DataServiceCollection(
    IEnumerable<T> items,
    TrackingMode trackingMode,
    string entitySetName,
    Func<EntityChangedParams, bool> entityChangedCallback,
    Func<EntityCollectionChangedParams, bool> collectionChangedCallback
)
public:
DataServiceCollection(
    IEnumerable<T>^ items, 
    TrackingMode trackingMode, 
    String^ entitySetName, 
    Func<EntityChangedParams^, bool>^ entityChangedCallback, 
    Func<EntityCollectionChangedParams^, bool>^ collectionChangedCallback
)
new : 
        items:IEnumerable<'T> * 
        trackingMode:TrackingMode * 
        entitySetName:string * 
        entityChangedCallback:Func<EntityChangedParams, bool> * 
        collectionChangedCallback:Func<EntityCollectionChangedParams, bool> -> DataServiceCollection
public function DataServiceCollection(
    items : IEnumerable<T>, 
    trackingMode : TrackingMode, 
    entitySetName : String, 
    entityChangedCallback : Func<EntityChangedParams, boolean>, 
    collectionChangedCallback : Func<EntityCollectionChangedParams, boolean>
)

Parameters

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

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 raise events to manually report changes to the DataServiceContext.

See Also

Reference

DataServiceCollection<T> Class

DataServiceCollection<T> Overload

System.Data.Services.Client Namespace