DataServiceCollection<T> Constructeurs

Définition

Espace de noms:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Crée une instance de la classe DataServiceCollection<T>.

Surcharges

DataServiceCollection<T>()	Crée une instance de la classe DataServiceCollection<T>.
DataServiceCollection<T>(IEnumerable<T>)	Crée une instance de la classe DataServiceCollection<T> en fonction de l'exécution de la requête.
DataServiceCollection<T>(DataServiceContext)	Crée une instance de la classe DataServiceCollection<T> qui utilise le DataServiceContext spécifié.
DataServiceCollection<T>(IEnumerable<T>, TrackingMode)	Crée une instance de la classe DataServiceCollection<T> en fonction de l'exécution de la requête et avec le mode de suivi spécifié.
DataServiceCollection<T>(DataServiceContext, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)	Crée une instance de la classe DataServiceCollection<T> avec les délégués de la méthode de modification fournis et utilisant le DataServiceContext spécifié.
DataServiceCollection<T>(IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)	Crée une instance de la classe DataServiceCollection<T> en fonction de l'exécution de la requête et avec les délégués de la méthode de modification fournis.
DataServiceCollection<T>(DataServiceContext, IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams, Boolean>)	Crée une instance de la classe DataServiceCollection<T> en fonction de l'exécution de la requête, avec les délégués de la méthode de modification fournis et utilisant le DataServiceContext fourni.

DataServiceCollection<T>()

Crée une instance de la classe DataServiceCollection<T>.

public:
 DataServiceCollection();

public DataServiceCollection ();

Public Sub New ()

Remarques

Par défaut, le suivi automatique des modifications est activé pour DataServiceCollection<T>. Vous pouvez créer une instance DataServiceCollection<T> qui utilise le suivi manuel des modifications lorsque vous créez une instance à l'aide d'un constructeur qui vous permet de fournir une valeur None pour TrackingMode. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements déclenchés pour enregistrer manuellement les modifications apportées à DataServiceContext.

Le suivi automatique des modifications commence après que les éléments sont chargés dans la collection.

DataServiceCollection<T>(IEnumerable<T>)

Crée une instance de la classe DataServiceCollection<T> en fonction de l'exécution de la requête.

public:
 DataServiceCollection(System::Collections::Generic::IEnumerable<T> ^ items);

public DataServiceCollection (System.Collections.Generic.IEnumerable<T> items);

new System.Data.Services.Client.DataServiceCollection<'T> : seq<'T> -> System.Data.Services.Client.DataServiceCollection<'T>

Public Sub New (items As IEnumerable(Of T))

Paramètres

items

IEnumerable<T>

Requête DataServiceQuery<TElement> ou LINQ qui retourne une collection IEnumerable<T> d'objets utilisés pour initialiser la collection.

Remarques

La collection d’objets IEnumerable<T> fournie pour items est habituellement une requête qui retourne les éléments de la collection. Toutefois, toute collection IEnumerable<T> du type correct peut être fournie.

Par défaut, le suivi automatique des modifications est activé pour DataServiceCollection<T>. Vous pouvez créer une instance DataServiceCollection<T> qui utilise le suivi manuel des modifications lorsque vous créez une instance à l'aide d'un constructeur qui vous permet de fournir une valeur None pour TrackingMode. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements déclenchés pour enregistrer manuellement les modifications apportées à DataServiceContext.

DataServiceCollection<T>(DataServiceContext)

Crée une instance de la classe DataServiceCollection<T> qui utilise le DataServiceContext spécifié.

public:
 DataServiceCollection(System::Data::Services::Client::DataServiceContext ^ context);

public DataServiceCollection (System.Data.Services.Client.DataServiceContext context);

new System.Data.Services.Client.DataServiceCollection<'T> : System.Data.Services.Client.DataServiceContext -> System.Data.Services.Client.DataServiceCollection<'T>

Public Sub New (context As DataServiceContext)

Paramètres

context

DataServiceContext

DataServiceContext utilisé pour suivre les modifications apportées aux objets de la collection.

Remarques

Utilisez ce constructeur pour créer une DataServiceCollection<T> vide à laquelle les objets d'entité peuvent être ajoutés sans exécuter de requête sur le service ou lorsque IEnumerable<T> n'est pas disponible.

Par défaut, le suivi automatique des modifications est activé pour DataServiceCollection<T>. Vous pouvez créer une instance DataServiceCollection<T> qui utilise le suivi manuel des modifications lorsque vous créez une instance à l'aide d'un constructeur qui vous permet de fournir une valeur None pour TrackingMode. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements déclenchés pour enregistrer manuellement les modifications apportées à DataServiceContext.

DataServiceCollection<T>(IEnumerable<T>, TrackingMode)

Crée une instance de la classe DataServiceCollection<T> en fonction de l'exécution de la requête et avec le mode de suivi spécifié.

public:
 DataServiceCollection(System::Collections::Generic::IEnumerable<T> ^ items, System::Data::Services::Client::TrackingMode trackingMode);

public DataServiceCollection (System.Collections.Generic.IEnumerable<T> items, System.Data.Services.Client.TrackingMode trackingMode);

new System.Data.Services.Client.DataServiceCollection<'T> : seq<'T> * System.Data.Services.Client.TrackingMode -> System.Data.Services.Client.DataServiceCollection<'T>

Public Sub New (items As IEnumerable(Of T), trackingMode As TrackingMode)

Paramètres

items

IEnumerable<T>

Requête DataServiceQuery<TElement> ou LINQ qui retourne une collection IEnumerable<T> d'objets utilisés pour initialiser la collection.

trackingMode

TrackingMode

Valeur TrackingMode qui indique si les modifications apportées aux éléments de la collection sont automatiquement suivies ou non.

Remarques

Par défaut, le suivi automatique des modifications est activé pour DataServiceCollection<T>. Utilisez ce constructeur de classe et fournissez une valeur None pour trackingMode pour créer une instance DataServiceCollection<T> qui utilise le suivi des modifications manuel. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements déclenchés pour enregistrer manuellement les modifications apportées à DataServiceContext.

La collection d’objets IEnumerable<T> fournie pour items est habituellement une requête qui retourne les éléments de la collection. Toutefois, toute collection IEnumerable<T> du type correct peut être fournie.

DataServiceCollection<T>(DataServiceContext, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)

Crée une instance de la classe DataServiceCollection<T> avec les délégués de la méthode de modification fournis et utilisant le DataServiceContext spécifié.

public:
 DataServiceCollection(System::Data::Services::Client::DataServiceContext ^ context, System::String ^ entitySetName, Func<System::Data::Services::Client::EntityChangedParams ^, bool> ^ entityChangedCallback, Func<System::Data::Services::Client::EntityCollectionChangedParams ^, bool> ^ collectionChangedCallback);

public DataServiceCollection (System.Data.Services.Client.DataServiceContext context, string entitySetName, Func<System.Data.Services.Client.EntityChangedParams,bool> entityChangedCallback, Func<System.Data.Services.Client.EntityCollectionChangedParams,bool> collectionChangedCallback);

new System.Data.Services.Client.DataServiceCollection<'T> : System.Data.Services.Client.DataServiceContext * string * Func<System.Data.Services.Client.EntityChangedParams, bool> * Func<System.Data.Services.Client.EntityCollectionChangedParams, bool> -> System.Data.Services.Client.DataServiceCollection<'T>

Public Sub New (context As DataServiceContext, entitySetName As String, entityChangedCallback As Func(Of EntityChangedParams, Boolean), collectionChangedCallback As Func(Of EntityCollectionChangedParams, Boolean))

Paramètres

context

DataServiceContext

DataServiceContext utilisé pour le suivi des éléments de la collection.

entitySetName

String

Jeu d'entités des objets dans la collection.

entityChangedCallback

Func<EntityChangedParams,Boolean>

Délégué qui encapsule une méthode qui est appelée lorsqu'une entité change.

collectionChangedCallback

Func<EntityCollectionChangedParams,Boolean>

Délégué qui encapsule une méthode qui est appelée lorsque la collection d’entités change.

Remarques

Utilisez ce constructeur pour créer une DataServiceCollection<T> vide à laquelle les objets d'entité peuvent être ajoutés sans exécuter de requête sur le service ou lorsque IEnumerable<T> n'est pas disponible.

Par défaut, le suivi automatique des modifications est activé pour DataServiceCollection<T>. Vous pouvez créer une instance DataServiceCollection<T> qui utilise le suivi manuel des modifications lorsque vous créez une instance à l'aide d'un constructeur qui vous permet de fournir une valeur None pour TrackingMode. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements déclenchés pour enregistrer manuellement les modifications apportées à DataServiceContext.

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

Crée une instance de la classe DataServiceCollection<T> en fonction de l'exécution de la requête et avec les délégués de la méthode de modification fournis.

public:
 DataServiceCollection(System::Collections::Generic::IEnumerable<T> ^ items, System::Data::Services::Client::TrackingMode trackingMode, System::String ^ entitySetName, Func<System::Data::Services::Client::EntityChangedParams ^, bool> ^ entityChangedCallback, Func<System::Data::Services::Client::EntityCollectionChangedParams ^, bool> ^ collectionChangedCallback);

public DataServiceCollection (System.Collections.Generic.IEnumerable<T> items, System.Data.Services.Client.TrackingMode trackingMode, string entitySetName, Func<System.Data.Services.Client.EntityChangedParams,bool> entityChangedCallback, Func<System.Data.Services.Client.EntityCollectionChangedParams,bool> collectionChangedCallback);

new System.Data.Services.Client.DataServiceCollection<'T> : seq<'T> * System.Data.Services.Client.TrackingMode * string * Func<System.Data.Services.Client.EntityChangedParams, bool> * Func<System.Data.Services.Client.EntityCollectionChangedParams, bool> -> System.Data.Services.Client.DataServiceCollection<'T>

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))

Paramètres

items

IEnumerable<T>

Requête DataServiceQuery<TElement> ou LINQ qui retourne une collection IEnumerable<T> d'objets utilisés pour initialiser la collection.

trackingMode

TrackingMode

Valeur TrackingMode qui indique si les modifications apportées aux éléments de la collection sont automatiquement suivies ou non.

entitySetName

String

Jeu d'entités des objets dans la collection.

entityChangedCallback

Func<EntityChangedParams,Boolean>

Délégué qui encapsule une méthode qui est appelée lorsqu'une entité change.

collectionChangedCallback

Func<EntityCollectionChangedParams,Boolean>

Délégué qui encapsule une méthode qui est appelée lorsque la collection d’entités change.

Remarques

Les fonctions entityChanged et collectionChanged sont appelées respectivement par les événements PropertyChanged et CollectionChanged. La méthode entityChanged accepte une valeur EntityCollectionChangedParams et la méthode collectionChanged accepte une valeur EntityChangedParams. Les deux méthodes doivent retourner une valeur booléenne qui indique si l'événement a été géré par la fonction. Lorsque la méthode retourne true, le comportement par défaut se produit toujours.

Par défaut, le suivi automatique des modifications est activé pour DataServiceCollection<T>. Vous pouvez créer une instance DataServiceCollection<T> qui utilise le suivi manuel des modifications lorsque vous créez une instance à l'aide d'un constructeur qui vous permet de fournir une valeur None pour TrackingMode. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements déclenchés pour enregistrer manuellement les modifications apportées à DataServiceContext.

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

Crée une instance de la classe DataServiceCollection<T> en fonction de l'exécution de la requête, avec les délégués de la méthode de modification fournis et utilisant le DataServiceContext fourni.

public:
 DataServiceCollection(System::Data::Services::Client::DataServiceContext ^ context, System::Collections::Generic::IEnumerable<T> ^ items, System::Data::Services::Client::TrackingMode trackingMode, System::String ^ entitySetName, Func<System::Data::Services::Client::EntityChangedParams ^, bool> ^ entityChangedCallback, Func<System::Data::Services::Client::EntityCollectionChangedParams ^, bool> ^ collectionChangedCallback);

public DataServiceCollection (System.Data.Services.Client.DataServiceContext context, System.Collections.Generic.IEnumerable<T> items, System.Data.Services.Client.TrackingMode trackingMode, string entitySetName, Func<System.Data.Services.Client.EntityChangedParams,bool> entityChangedCallback, Func<System.Data.Services.Client.EntityCollectionChangedParams,bool> collectionChangedCallback);

new System.Data.Services.Client.DataServiceCollection<'T> : System.Data.Services.Client.DataServiceContext * seq<'T> * System.Data.Services.Client.TrackingMode * string * Func<System.Data.Services.Client.EntityChangedParams, bool> * Func<System.Data.Services.Client.EntityCollectionChangedParams, bool> -> System.Data.Services.Client.DataServiceCollection<'T>

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

Paramètres

context

DataServiceContext

DataServiceContext utilisé pour le suivi des éléments de la collection.

items

IEnumerable<T>

Requête DataServiceQuery<TElement> ou LINQ qui retourne une collection IEnumerable<T> d'objets utilisés pour initialiser la collection.

trackingMode

TrackingMode

Valeur TrackingMode qui indique si les modifications apportées aux éléments de la collection sont automatiquement suivies ou non.

entitySetName

String

Jeu d'entités des objets dans la collection.

entityChangedCallback

Func<EntityChangedParams,Boolean>

Délégué qui encapsule une méthode qui est appelée lorsqu'une entité change.

collectionChangedCallback

Func<EntityCollectionChangedParams,Boolean>

Délégué qui encapsule une méthode qui est appelée lorsque la collection d’entités change.

Remarques

Par défaut, le suivi automatique des modifications est activé pour DataServiceCollection<T>. Utilisez ce constructeur de classe pour fournir une valeur None pour trackingMode pour créer une instance DataServiceCollection<T> qui utilise le suivi des modifications manuel. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements déclenchés pour enregistrer manuellement les modifications apportées à DataServiceContext.

DataServiceContext doit être fourni lorsque items n'est pas DataServiceQuery<TElement> ou une QueryOperationResponse<T> qui fait référence à une instance DataServiceContext.

Les fonctions entityChanged et collectionChanged sont appelées respectivement par les événements PropertyChanged et CollectionChanged. La méthode entityChanged accepte une valeur EntityCollectionChangedParams et la méthode collectionChanged accepte une valeur EntityChangedParams. Les deux méthodes doivent retourner une valeur booléenne qui indique si l'événement a été géré par la fonction. Lorsque la méthode retourne true, le comportement par défaut se produit toujours.