DataServiceCollection<T> Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée une instance de la classe DataServiceCollection<T>.
Surcharges
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 une DataServiceCollection<T>. Vous pouvez créer une instance de 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 de None pour TrackingMode. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements de déclenchement pour signaler manuellement les modifications apportées au DataServiceContext.
Le suivi automatique des modifications commence une fois les éléments chargés dans la collection.
S’applique à
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 IEnumerable<T> d’objets fournis pour items est généralement une requête qui retourne les éléments de la collection. Toutefois, n’importe quelle collection IEnumerable<T> du type correct peut être fournie.
Par défaut, le suivi automatique des modifications est activé pour une DataServiceCollection<T>. Vous pouvez créer une instance de 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 de None pour TrackingMode. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements de déclenchement pour signaler manuellement les modifications apportées au DataServiceContext.
S’applique à
DataServiceCollection<T>(DataServiceContext)
Crée une instance de la classe DataServiceCollection<T> qui utilise la DataServiceContextspécifiée.
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
Le DataServiceContext utilisé pour suivre les modifications apportées aux objets de la collection.
Remarques
Utilisez ce constructeur pour créer un DataServiceCollection<T> vide auquel les objets d’entité peuvent être ajoutés sans exécuter de requête sur le service ou lorsqu’un IEnumerable<T> n’est pas disponible.
Par défaut, le suivi automatique des modifications est activé pour une DataServiceCollection<T>. Vous pouvez créer une instance de 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 de None pour TrackingMode. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements de déclenchement pour signaler manuellement les modifications apportées au DataServiceContext.
S’applique à
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.
Remarques
Par défaut, le suivi automatique des modifications est activé pour une DataServiceCollection<T>. Utilisez ce constructeur de classe et fournissez une valeur de None pour trackingMode pour créer une instance de DataServiceCollection<T> qui utilise le suivi manuel des modifications. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements de déclenchement pour signaler manuellement les modifications apportées au DataServiceContext.
La collection IEnumerable<T> d’objets fournis pour items est généralement une requête qui retourne les éléments de la collection. Toutefois, n’importe quelle collection IEnumerable<T> du type correct peut être fournie.
S’applique à
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 méthode de modification fournis et qui utilise le DataServiceContextspé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
La DataServiceContext utilisée pour suivre les éléments de la collection.
- entitySetName
- String
Jeu d’entités des objets de la collection.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Délégué qui encapsule une méthode appelée lorsqu’une entité change.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Délégué qui encapsule une méthode appelée lorsque la collection d’entités change.
Remarques
Utilisez ce constructeur pour créer un DataServiceCollection<T> vide auquel les objets d’entité peuvent être ajoutés sans exécuter de requête sur le service ou lorsqu’un IEnumerable<T> n’est pas disponible.
Par défaut, le suivi automatique des modifications est activé pour une DataServiceCollection<T>. Vous pouvez créer une instance de 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 de None pour TrackingMode. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements de déclenchement pour signaler manuellement les modifications apportées au DataServiceContext.
S’applique à
DataServiceCollection<T>(IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)
Crée une instance de la classe DataServiceCollection<T> basée sur l’exécution de la requête et avec les délégués de 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.
- entitySetName
- String
Jeu d’entités des objets de la collection.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Délégué qui encapsule une méthode appelée lorsqu’une entité change.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Délégué qui encapsule une méthode 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 prend une valeur EntityCollectionChangedParams et la méthode collectionChanged prend 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 une DataServiceCollection<T>. Vous pouvez créer une instance de 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 de None pour TrackingMode. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements de déclenchement pour signaler manuellement les modifications apportées au DataServiceContext.
S’applique à
DataServiceCollection<T>(DataServiceContext, IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams, Boolean>)
Crée une instance de la classe DataServiceCollection<T> basée sur l’exécution de requête, avec les délégués de méthode de modification fournis et qui utilise le DataServiceContextfourni.
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
La DataServiceContext utilisée pour suivre les é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.
- entitySetName
- String
Jeu d’entités des objets de la collection.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Délégué qui encapsule une méthode appelée lorsqu’une entité change.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Délégué qui encapsule une méthode appelée lorsque la collection d’entités change.
Remarques
Par défaut, le suivi automatique des modifications est activé pour une DataServiceCollection<T>. Utilisez ce constructeur de classe pour fournir une valeur de None pour trackingMode pour créer une instance de DataServiceCollection<T> qui utilise le suivi manuel des modifications. Lorsque vous utilisez le suivi manuel, vous devez implémenter INotifyPropertyChanged et INotifyCollectionChanged et gérer les événements de déclenchement pour signaler manuellement les modifications apportées au DataServiceContext.
Le DataServiceContext doit être fourni lorsque items n’est pas un DataServiceQuery<TElement> ou QueryOperationResponse<T> qui a une référence à une instance de DataServiceContext.
Les fonctions entityChanged et collectionChanged sont appelées respectivement par les événements PropertyChanged et CollectionChanged. La méthode entityChanged prend une valeur EntityCollectionChangedParams et la méthode collectionChanged prend 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.
