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 eine DataServiceCollection<T> aktiviert. Sie können eine Instanz von DataServiceCollection<T> erstellen, die die manuelle Änderungsnachverfolgung verwendet, wenn Sie eine Instanz mithilfe eines Konstruktors erstellen, der Ihnen ermöglicht, den Wert None für TrackingMode anzugeben. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie INotifyPropertyChanged und INotifyCollectionChanged implementieren und die Erhöhungsereignisse behandeln, um dem DataServiceContext Änderungen manuell zu melden.
Die automatische Änderungsnachverfolgung beginnt, nachdem Elemente in die Auflistung geladen wurden.
Gilt für:
DataServiceCollection<T>(IEnumerable<T>)
Erstellt auf Grundlage der Abfrageausführung eine neue Instanz der DataServiceCollection<T>-Klasse.
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 DataServiceQuery<TElement> oder eine LINQ-Abfrage, die eine IEnumerable<T>-Auflistung von Objekten zurückgibt, die zum Initialisieren der Auflistung verwendet werden.
Hinweise
Die IEnumerable<T>-Auflistung von Objekten für items ist in der Regel eine Abfrage, die die Elemente in der Auflistung zurückgibt. Es kann jedoch jede IEnumerable<T>-Auflistung des richtigen Typs angegeben werden.
Standardmäßig ist die automatische Änderungsnachverfolgung für eine DataServiceCollection<T> aktiviert. Sie können eine Instanz von DataServiceCollection<T> erstellen, die die manuelle Änderungsnachverfolgung verwendet, wenn Sie eine Instanz mithilfe eines Konstruktors erstellen, der Ihnen ermöglicht, den Wert None für TrackingMode anzugeben. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie INotifyPropertyChanged und INotifyCollectionChanged implementieren und die Erhöhungsereignisse behandeln, um dem DataServiceContext Änderungen manuell zu melden.
Gilt für:
DataServiceCollection<T>(DataServiceContext)
Erstellt eine neue Instanz der DataServiceCollection<T>-Klasse, die den angegebenen DataServiceContext 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
Der DataServiceContext, der verwendet wurde, um Änderungen an Objekten in der Auflistung nachzuverfolgen.
Hinweise
Verwenden Sie diesen Konstruktor, um eine leere DataServiceCollection<T> zu erstellen, der Entitätsobjekte hinzugefügt werden können, ohne eine Abfrage für den Dienst auszuführen, oder wenn kein IEnumerable<T> verfügbar ist.
Standardmäßig ist die automatische Änderungsnachverfolgung für eine DataServiceCollection<T> aktiviert. Sie können eine Instanz von DataServiceCollection<T> erstellen, die die manuelle Änderungsnachverfolgung verwendet, wenn Sie eine Instanz mithilfe eines Konstruktors erstellen, der Ihnen ermöglicht, den Wert None für TrackingMode anzugeben. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie INotifyPropertyChanged und INotifyCollectionChanged implementieren und die Erhöhungsereignisse behandeln, um dem DataServiceContext Änderungen manuell zu melden.
Gilt für:
DataServiceCollection<T>(IEnumerable<T>, TrackingMode)
Erstellt auf Grundlage der Abfrageausführung und mit dem angegebenen Nachverfolgungsmodus eine neue Instanz der DataServiceCollection<T>-Klasse.
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 DataServiceQuery<TElement> oder eine LINQ-Abfrage, die eine IEnumerable<T>-Auflistung von Objekten zurückgibt, die zum Initialisieren der Auflistung verwendet werden.
- trackingMode
- TrackingMode
Ein TrackingMode-Wert, der angegeben hat, ob an Elementen in der Auflistung vorgenommene Änderungen automatisch nachverfolgt werden.
Hinweise
Standardmäßig ist die automatische Änderungsnachverfolgung für eine DataServiceCollection<T> aktiviert. Verwenden Sie diesen Klassenkonstruktor, und geben Sie den Wert None für trackingMode an, um eine Instanz von DataServiceCollection<T> zu erstellen, die die manuelle Änderungsnachverfolgung verwendet. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie INotifyPropertyChanged und INotifyCollectionChanged implementieren und die Erhöhungsereignisse behandeln, um dem DataServiceContext Änderungen manuell zu melden.
Die IEnumerable<T>-Auflistung von Objekten für items ist in der Regel eine Abfrage, die die Elemente in der Auflistung zurückgibt. Es kann jedoch jede IEnumerable<T>-Auflistung 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 Änderungsmethodendelegaten, die den angegebenen DataServiceContext verwendet.
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
Der DataServiceContext zur Verfolgung von Elementen in der Auflistung.
- entitySetName
- String
Die Entitätenmenge der Objekte in der Auflistung.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die bei Änderung einer Entität aufgerufen wird.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die bei Änderung der Entitätenauflistung aufgerufen wird.
Hinweise
Verwenden Sie diesen Konstruktor, um eine leere DataServiceCollection<T> zu erstellen, der Entitätsobjekte hinzugefügt werden können, ohne eine Abfrage für den Dienst auszuführen, oder wenn kein IEnumerable<T> verfügbar ist.
Standardmäßig ist die automatische Änderungsnachverfolgung für eine DataServiceCollection<T> aktiviert. Sie können eine Instanz von DataServiceCollection<T> erstellen, die die manuelle Änderungsnachverfolgung verwendet, wenn Sie eine Instanz mithilfe eines Konstruktors erstellen, der Ihnen ermöglicht, den Wert None für TrackingMode anzugeben. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie INotifyPropertyChanged und INotifyCollectionChanged implementieren und die Erhöhungsereignisse behandeln, um dem DataServiceContext Änderungen manuell 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 auf Grundlage der Abfrageausführung und mit den angegebenen Änderungsmethodendelegaten.
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 DataServiceQuery<TElement> oder eine LINQ-Abfrage, die eine IEnumerable<T>-Auflistung von Objekten zurückgibt, die zum Initialisieren der Auflistung verwendet werden.
- trackingMode
- TrackingMode
Ein TrackingMode-Wert, der angegeben hat, ob an Elementen in der Auflistung vorgenommene Änderungen automatisch nachverfolgt werden.
- entitySetName
- String
Die Entitätenmenge der Objekte in der Auflistung.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die bei Änderung einer Entität aufgerufen wird.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die bei Änderung der Entitätenauflistung aufgerufen wird.
Hinweise
Die entityChanged-Funktion und collectionChanged-Funktion werden vom PropertyChanged-Ereignis bzw. CollectionChanged-Ereignis aufgerufen. Die entityChanged-Methode verwendet einen EntityCollectionChangedParams-Wert, und die collectionChanged-Methode vewendet 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ückgibt true, tritt das Standardverhalten weiterhin auf.
Standardmäßig ist die automatische Änderungsnachverfolgung für eine DataServiceCollection<T> aktiviert. Sie können eine Instanz von DataServiceCollection<T> erstellen, die die manuelle Änderungsnachverfolgung verwendet, wenn Sie eine Instanz mithilfe eines Konstruktors erstellen, der Ihnen ermöglicht, den Wert None für TrackingMode anzugeben. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie INotifyPropertyChanged und INotifyCollectionChanged implementieren und die Erhöhungsereignisse behandeln, um dem DataServiceContext Änderungen manuell 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 auf Grundlage der Abfrageausführung mit den angegebenen Änderungsmethodendelegaten und verwendet den angegebenen 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
Der DataServiceContext zur Verfolgung von Elementen in der Auflistung.
- items
- IEnumerable<T>
Eine DataServiceQuery<TElement> oder eine LINQ-Abfrage, die eine IEnumerable<T>-Auflistung von Objekten zurückgibt, die zum Initialisieren der Auflistung verwendet werden.
- trackingMode
- TrackingMode
Ein TrackingMode-Wert, der angegeben hat, ob an Elementen in der Auflistung vorgenommene Änderungen automatisch nachverfolgt werden.
- entitySetName
- String
Die Entitätenmenge der Objekte in der Auflistung.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die bei Änderung einer Entität aufgerufen wird.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Ein Delegat, der eine Methode kapselt, die bei Änderung der Entitätenauflistung aufgerufen wird.
Hinweise
Standardmäßig ist die automatische Änderungsnachverfolgung für eine DataServiceCollection<T> aktiviert. Verwenden Sie diesen Klassenkonstruktor, um den Wert None für trackingMode anzugeben, und damit eine Instanz von DataServiceCollection<T> zu erstellen, die die manuelle Änderungsnachverfolgung verwendet. Wenn Sie die manuelle Nachverfolgung verwenden, müssen Sie INotifyPropertyChanged und INotifyCollectionChanged implementieren und die Erhöhungsereignisse behandeln, um dem DataServiceContext Änderungen manuell zu melden.
Der DataServiceContext muss angegeben werden, wenn items keine DataServiceQuery<TElement> oder QueryOperationResponse<T> ist, die einen Verweis auf eine DataServiceContext-Instanz aufweist.
Die entityChanged-Funktion und collectionChanged-Funktion werden vom PropertyChanged-Ereignis bzw. CollectionChanged-Ereignis aufgerufen. Die entityChanged-Methode verwendet einen EntityCollectionChangedParams-Wert, und die collectionChanged-Methode vewendet 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ückgibt true, tritt das Standardverhalten weiterhin auf.
