Freigeben über


DataServiceCollection<T> Konstruktoren

Definition

Erstellt eine neue Instanz der DataServiceCollection<T>-Klasse.

Überlädt

DataServiceCollection<T>()

Erstellt eine neue Instanz der DataServiceCollection<T>-Klasse.

DataServiceCollection<T>(IEnumerable<T>)

Erstellt auf Grundlage der Abfrageausführung eine neue Instanz der DataServiceCollection<T>-Klasse.

DataServiceCollection<T>(DataServiceContext)

Erstellt eine neue Instanz der DataServiceCollection<T>-Klasse, die den angegebenen DataServiceContext verwendet.

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

Erstellt auf Grundlage der Abfrageausführung und mit dem angegebenen Nachverfolgungsmodus eine neue Instanz der DataServiceCollection<T>-Klasse.

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.

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.

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.

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.

Gilt für: