DataServiceCollection<T> Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt eine neue Instanz der DataServiceCollection<T> Klasse.
Überlädt
DataServiceCollection<T>()
Erstellt eine neue Instanz der DataServiceCollection<T> Klasse.
public:
DataServiceCollection();public DataServiceCollection();Public Sub New ()Hinweise
Standardmäßig ist die automatische Änderungsnachverfolgung für ein DataServiceCollection<T>. Sie können eine Instanz erstellen, die DataServiceCollection<T> die manuelle Änderungsnachverfolgung verwendet, wenn Sie eine Instanz mit einem Konstruktor erstellen, mit dem Sie einen Wert für NoneTrackingMode. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie die Auslösen-Ereignisse implementieren INotifyPropertyChanged und INotifyCollectionChanged behandeln, um Änderungen manuell an der DataServiceContextMeldeliste zu melden.
Die automatische Änderungsnachverfolgung beginnt, nachdem Elemente in die Sammlung geladen wurden.
Gilt für:
DataServiceCollection<T>(IEnumerable<T>)
Erstellt eine neue Instanz der DataServiceCollection<T> Klasse basierend auf der Abfrageausführung.
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))Parameter
- items
- IEnumerable<T>
Eine oder LINQ-Abfrage DataServiceQuery<TElement> , die eine IEnumerable<T> Auflistung von Objekten zurückgibt, die zum Initialisieren der Auflistung verwendet werden.
Hinweise
Die IEnumerable<T> Auflistung der bereitgestellten items Objekte ist in der Regel eine Abfrage, die die Elemente in der Auflistung zurückgibt. Es kann jedoch jede IEnumerable<T> Sammlung des richtigen Typs angegeben werden.
Standardmäßig ist die automatische Änderungsnachverfolgung für ein DataServiceCollection<T>. Sie können eine Instanz erstellen, die DataServiceCollection<T> die manuelle Änderungsnachverfolgung verwendet, wenn Sie eine Instanz mit einem Konstruktor erstellen, mit dem Sie einen Wert für NoneTrackingMode. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie die Auslösen-Ereignisse implementieren INotifyPropertyChanged und INotifyCollectionChanged behandeln, um Änderungen manuell an der DataServiceContextMeldeliste zu melden.
Gilt für:
DataServiceCollection<T>(DataServiceContext)
Erstellt eine neue Instanz der DataServiceCollection<T> Klasse, die die angegebene DataServiceContextKlasse verwendet.
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)Parameter
- context
- DataServiceContext
Wird DataServiceContext verwendet, um Änderungen an Objekten in der Auflistung nachzuverfolgen.
Hinweise
Verwenden Sie diesen Konstruktor, um ein leeres DataServiceCollection<T> Objekt zu erstellen, dem Entitätsobjekte hinzugefügt werden können, ohne eine Abfrage für den Dienst auszuführen oder wenn ein IEnumerable<T> Objekt nicht verfügbar ist.
Standardmäßig ist die automatische Änderungsnachverfolgung für ein DataServiceCollection<T>. Sie können eine Instanz erstellen, die DataServiceCollection<T> die manuelle Änderungsnachverfolgung verwendet, wenn Sie eine Instanz mit einem Konstruktor erstellen, mit dem Sie einen Wert für NoneTrackingMode. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie die Auslösen-Ereignisse implementieren INotifyPropertyChanged und INotifyCollectionChanged behandeln, um Änderungen manuell an der DataServiceContextMeldeliste zu melden.
Gilt für:
DataServiceCollection<T>(IEnumerable<T>, TrackingMode)
Erstellt eine neue Instanz der DataServiceCollection<T> Klasse basierend auf der Abfrageausführung und mit dem angegebenen Nachverfolgungsmodus.
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)Parameter
- items
- IEnumerable<T>
Eine oder LINQ-Abfrage DataServiceQuery<TElement> , die eine IEnumerable<T> Auflistung von Objekten zurückgibt, die zum Initialisieren der Auflistung verwendet werden.
- trackingMode
- TrackingMode
Ein TrackingMode Wert, der angibt, ob Änderungen an Elementen in der Auflistung automatisch nachverfolgt werden.
Hinweise
Standardmäßig ist die automatische Änderungsnachverfolgung für ein DataServiceCollection<T>. Verwenden Sie diesen Klassenkonstruktor, und geben Sie einen Wert None für trackingMode das Erstellen einer Instanz dieser Klasse an, die DataServiceCollection<T> die manuelle Änderungsnachverfolgung verwendet. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie die Auslösen-Ereignisse implementieren INotifyPropertyChanged und INotifyCollectionChanged behandeln, um Änderungen manuell an der DataServiceContextMeldeliste zu melden.
Die IEnumerable<T> Auflistung der bereitgestellten items Objekte ist in der Regel eine Abfrage, die die Elemente in der Auflistung zurückgibt. Es kann jedoch jede IEnumerable<T> Sammlung des richtigen Typs angegeben werden.
Gilt für:
DataServiceCollection<T>(DataServiceContext, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)
Erstellt eine neue Instanz der DataServiceCollection<T> Klasse mit den angegebenen Änderungsmethodedelegatten und verwendet die angegebene DataServiceContext.
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))Parameter
- context
- DataServiceContext
Wird DataServiceContext zum Nachverfolgen von Elementen in der Auflistung verwendet.
- entitySetName
- String
Der Entitätssatz der Objekte in der Auflistung.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die aufgerufen wird, wenn eine Entität geändert wird.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die aufgerufen wird, wenn sich die Auflistung von Entitäten ändert.
Hinweise
Verwenden Sie diesen Konstruktor, um ein leeres DataServiceCollection<T> Objekt zu erstellen, dem Entitätsobjekte hinzugefügt werden können, ohne eine Abfrage für den Dienst auszuführen oder wenn ein IEnumerable<T> Objekt nicht verfügbar ist.
Standardmäßig ist die automatische Änderungsnachverfolgung für ein DataServiceCollection<T>. Sie können eine Instanz erstellen, die DataServiceCollection<T> die manuelle Änderungsnachverfolgung verwendet, wenn Sie eine Instanz mit einem Konstruktor erstellen, mit dem Sie einen Wert für NoneTrackingMode. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie die Auslösen-Ereignisse implementieren INotifyPropertyChanged und INotifyCollectionChanged behandeln, um Änderungen manuell an der DataServiceContextMeldeliste zu melden.
Gilt für:
DataServiceCollection<T>(IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)
Erstellt eine neue Instanz der DataServiceCollection<T> Klasse basierend auf der Abfrageausführung und mit den bereitgestellten Änderungsmethodedelegatten.
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))Parameter
- items
- IEnumerable<T>
Eine oder LINQ-Abfrage DataServiceQuery<TElement> , die eine IEnumerable<T> Auflistung von Objekten zurückgibt, die zum Initialisieren der Auflistung verwendet werden.
- trackingMode
- TrackingMode
Ein TrackingMode Wert, der angibt, ob Änderungen an Elementen in der Auflistung automatisch nachverfolgt werden.
- entitySetName
- String
Der Entitätssatz der Objekte in der Auflistung.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die aufgerufen wird, wenn eine Entität geändert wird.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die aufgerufen wird, wenn sich die Auflistung von Entitäten ändert.
Hinweise
Die entityChanged Funktionen collectionChanged werden von den PropertyChanged jeweiligen CollectionChanged Ereignissen bzw. Ereignissen aufgerufen. Die entityChanged Methode verwendet einen EntityCollectionChangedParams Wert, und die collectionChanged Methode akzeptiert einen EntityChangedParams Wert. Beide Methoden müssen einen booleschen Wert zurückgeben, der angibt, ob das Ereignis von der Funktion behandelt wurde. Wenn die Methode zurückgegeben wird true, tritt das Standardverhalten weiterhin auf.
Standardmäßig ist die automatische Änderungsnachverfolgung für ein DataServiceCollection<T>. Sie können eine Instanz erstellen, die DataServiceCollection<T> die manuelle Änderungsnachverfolgung verwendet, wenn Sie eine Instanz mit einem Konstruktor erstellen, mit dem Sie einen Wert für NoneTrackingMode. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie die Auslösen-Ereignisse implementieren INotifyPropertyChanged und INotifyCollectionChanged behandeln, um Änderungen manuell an der DataServiceContextMeldeliste zu melden.
Gilt für:
DataServiceCollection<T>(DataServiceContext, IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams, Boolean>)
Erstellt eine neue Instanz der DataServiceCollection<T> Klasse basierend auf der Abfrageausführung mit den bereitgestellten Änderungsmethodedelegatten und verwendet die bereitgestellten DataServiceContext.
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))Parameter
- context
- DataServiceContext
Wird DataServiceContext zum Nachverfolgen von Elementen in der Auflistung verwendet.
- items
- IEnumerable<T>
Eine oder LINQ-Abfrage DataServiceQuery<TElement> , die eine IEnumerable<T> Auflistung von Objekten zurückgibt, die zum Initialisieren der Auflistung verwendet werden.
- trackingMode
- TrackingMode
Ein TrackingMode Wert, der angibt, ob Änderungen an Elementen in der Auflistung automatisch nachverfolgt werden.
- entitySetName
- String
Der Entitätssatz der Objekte in der Auflistung.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die aufgerufen wird, wenn eine Entität geändert wird.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die aufgerufen wird, wenn sich die Auflistung von Entitäten ändert.
Hinweise
Standardmäßig ist die automatische Änderungsnachverfolgung für ein DataServiceCollection<T>. Verwenden Sie diesen Klassenkonstruktor, um einen Wert None für trackingMode die Erstellung einer Instanz dieser DataServiceCollection<T> Klasse mit manueller Änderungsnachverfolgung zu erstellen. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie die Auslösen-Ereignisse implementieren INotifyPropertyChanged und INotifyCollectionChanged behandeln, um Änderungen manuell an der DataServiceContextMeldeliste zu melden.
Der DataServiceContext Wert muss angegeben werden, wenn items es sich nicht um einen DataServiceQuery<TElement>QueryOperationResponse<T> Verweis auf eine DataServiceContext Instanz handelt.
Die entityChanged Funktionen collectionChanged werden von den PropertyChanged jeweiligen CollectionChanged Ereignissen bzw. Ereignissen aufgerufen. Die entityChanged Methode verwendet einen EntityCollectionChangedParams Wert, und die collectionChanged Methode akzeptiert einen EntityChangedParams Wert. Beide Methoden müssen einen booleschen Wert zurückgeben, der angibt, ob das Ereignis von der Funktion behandelt wurde. Wenn die Methode zurückgegeben truewird, tritt das Standardverhalten weiterhin auf.
