DataServiceCollection<T> Costruttori

Definizione

Spazio dei nomi:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Crea una nuova istanza della classe DataServiceCollection<T>.

Overload

DataServiceCollection<T>()	Crea una nuova istanza della classe DataServiceCollection<T>.
DataServiceCollection<T>(IEnumerable<T>)	Crea una nuova istanza della classe DataServiceCollection<T> in base all'esecuzione della query.
DataServiceCollection<T>(DataServiceContext)	Crea una nuova istanza della classe DataServiceCollection<T> che utilizza il DataServiceContextspecificato.
DataServiceCollection<T>(IEnumerable<T>, TrackingMode)	Crea una nuova istanza della classe DataServiceCollection<T> in base all'esecuzione della query e con la modalità di rilevamento specificata.
DataServiceCollection<T>(DataServiceContext, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)	Crea una nuova istanza della classe DataServiceCollection<T> con i delegati del metodo di modifica forniti e che utilizza il DataServiceContextspecificato.
DataServiceCollection<T>(IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)	Crea una nuova istanza della classe DataServiceCollection<T> in base all'esecuzione di query e con i delegati del metodo di modifica forniti.
DataServiceCollection<T>(DataServiceContext, IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams, Boolean>)	Crea una nuova istanza della classe DataServiceCollection<T> in base all'esecuzione della query, con i delegati del metodo di modifica forniti e che usa l'DataServiceContextfornito.

DataServiceCollection<T>()

Crea una nuova istanza della classe DataServiceCollection<T>.

public:
 DataServiceCollection();

public DataServiceCollection ();

Public Sub New ()

Commenti

Per impostazione predefinita, il rilevamento automatico delle modifiche è abilitato per un DataServiceCollection<T>. È possibile creare un'istanza di DataServiceCollection<T> che usa il rilevamento delle modifiche manuale quando si crea un'istanza usando un costruttore che consente di fornire un valore di None per TrackingMode. Quando si usa il rilevamento manuale, è necessario implementare INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi di generazione per segnalare manualmente le modifiche al DataServiceContext.

Il rilevamento automatico delle modifiche inizia dopo il caricamento degli elementi nella raccolta.

DataServiceCollection<T>(IEnumerable<T>)

Crea una nuova istanza della classe DataServiceCollection<T> in base all'esecuzione della query.

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

Parametri

items

IEnumerable<T>

Una query DataServiceQuery<TElement> o LINQ che restituisce un insieme IEnumerable<T> di oggetti utilizzati per inizializzare l'insieme.

Commenti

La IEnumerable<T> raccolta di oggetti forniti per items è in genere una query che restituisce gli elementi nell'insieme. È tuttavia possibile specificare qualsiasi IEnumerable<T> raccolta del tipo corretto.

Per impostazione predefinita, il rilevamento automatico delle modifiche è abilitato per un DataServiceCollection<T>. È possibile creare un'istanza di DataServiceCollection<T> che usa il rilevamento delle modifiche manuale quando si crea un'istanza usando un costruttore che consente di fornire un valore di None per TrackingMode. Quando si usa il rilevamento manuale, è necessario implementare INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi di generazione per segnalare manualmente le modifiche al DataServiceContext.

DataServiceCollection<T>(DataServiceContext)

Crea una nuova istanza della classe DataServiceCollection<T> che utilizza il DataServiceContextspecificato.

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)

Parametri

context

DataServiceContext

Il DataServiceContext utilizzato per tenere traccia delle modifiche apportate agli oggetti nell'insieme.

Commenti

Usare questo costruttore per creare un DataServiceCollection<T> vuoto a cui è possibile aggiungere oggetti entità senza eseguire una query sul servizio o quando un IEnumerable<T> non è disponibile.

Per impostazione predefinita, il rilevamento automatico delle modifiche è abilitato per un DataServiceCollection<T>. È possibile creare un'istanza di DataServiceCollection<T> che usa il rilevamento delle modifiche manuale quando si crea un'istanza usando un costruttore che consente di fornire un valore di None per TrackingMode. Quando si usa il rilevamento manuale, è necessario implementare INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi di generazione per segnalare manualmente le modifiche al DataServiceContext.

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

Crea una nuova istanza della classe DataServiceCollection<T> in base all'esecuzione della query e con la modalità di rilevamento specificata.

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)

Parametri

items

IEnumerable<T>

Una query DataServiceQuery<TElement> o LINQ che restituisce un insieme IEnumerable<T> di oggetti utilizzati per inizializzare l'insieme.

trackingMode

TrackingMode

Valore TrackingMode che indica se le modifiche apportate agli elementi nella raccolta vengono registrate automaticamente.

Commenti

Per impostazione predefinita, il rilevamento automatico delle modifiche è abilitato per un DataServiceCollection<T>. Utilizzare questo costruttore di classe e fornire un valore di None per trackingMode per creare un'istanza di DataServiceCollection<T> che usa il rilevamento delle modifiche manuale. Quando si usa il rilevamento manuale, è necessario implementare INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi di generazione per segnalare manualmente le modifiche al DataServiceContext.

La IEnumerable<T> raccolta di oggetti forniti per items è in genere una query che restituisce gli elementi nell'insieme. È tuttavia possibile specificare qualsiasi IEnumerable<T> raccolta del tipo corretto.

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

Crea una nuova istanza della classe DataServiceCollection<T> con i delegati del metodo di modifica forniti e che utilizza il DataServiceContextspecificato.

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

Parametri

context

DataServiceContext

Il DataServiceContext utilizzato per tenere traccia degli elementi nella raccolta.

entitySetName

String

Set di entità degli oggetti nell'insieme.

entityChangedCallback

Func<EntityChangedParams,Boolean>

Delegato che incapsula un metodo chiamato quando viene modificata un'entità.

collectionChangedCallback

Func<EntityCollectionChangedParams,Boolean>

Delegato che incapsula un metodo chiamato quando cambia la raccolta di entità.

Commenti

Usare questo costruttore per creare un DataServiceCollection<T> vuoto a cui è possibile aggiungere oggetti entità senza eseguire una query sul servizio o quando un IEnumerable<T> non è disponibile.

Per impostazione predefinita, il rilevamento automatico delle modifiche è abilitato per un DataServiceCollection<T>. È possibile creare un'istanza di DataServiceCollection<T> che usa il rilevamento delle modifiche manuale quando si crea un'istanza usando un costruttore che consente di fornire un valore di None per TrackingMode. Quando si usa il rilevamento manuale, è necessario implementare INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi di generazione per segnalare manualmente le modifiche al DataServiceContext.

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

Crea una nuova istanza della classe DataServiceCollection<T> in base all'esecuzione di query e con i delegati del metodo di modifica forniti.

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

Parametri

items

IEnumerable<T>

Una query DataServiceQuery<TElement> o LINQ che restituisce un insieme IEnumerable<T> di oggetti utilizzati per inizializzare l'insieme.

trackingMode

TrackingMode

Valore TrackingMode che indica se le modifiche apportate agli elementi nella raccolta vengono registrate automaticamente.

entitySetName

String

Set di entità degli oggetti nell'insieme.

entityChangedCallback

Func<EntityChangedParams,Boolean>

Delegato che incapsula un metodo chiamato quando viene modificata un'entità.

collectionChangedCallback

Func<EntityCollectionChangedParams,Boolean>

Delegato che incapsula un metodo chiamato quando cambia la raccolta di entità.

Commenti

Le funzioni entityChanged e collectionChanged vengono richiamate rispettivamente dagli eventi PropertyChanged e CollectionChanged. Il metodo entityChanged accetta un valore EntityCollectionChangedParams e il metodo collectionChanged accetta un valore EntityChangedParams. Entrambi i metodi devono restituire un valore booleano che indica se l'evento è stato gestito dalla funzione . Quando il metodo restituisce true, il comportamento predefinito si verifica ancora.

Per impostazione predefinita, il rilevamento automatico delle modifiche è abilitato per un DataServiceCollection<T>. È possibile creare un'istanza di DataServiceCollection<T> che usa il rilevamento delle modifiche manuale quando si crea un'istanza usando un costruttore che consente di fornire un valore di None per TrackingMode. Quando si usa il rilevamento manuale, è necessario implementare INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi di generazione per segnalare manualmente le modifiche al DataServiceContext.

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

Crea una nuova istanza della classe DataServiceCollection<T> in base all'esecuzione della query, con i delegati del metodo di modifica forniti e che usa l'DataServiceContextfornito.

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

Parametri

context

DataServiceContext

Il DataServiceContext utilizzato per tenere traccia degli elementi nella raccolta.

items

IEnumerable<T>

Una query DataServiceQuery<TElement> o LINQ che restituisce un insieme IEnumerable<T> di oggetti utilizzati per inizializzare l'insieme.

trackingMode

TrackingMode

Valore TrackingMode che indica se le modifiche apportate agli elementi nella raccolta vengono registrate automaticamente.

entitySetName

String

Set di entità degli oggetti nell'insieme.

entityChangedCallback

Func<EntityChangedParams,Boolean>

Delegato che incapsula un metodo chiamato quando viene modificata un'entità.

collectionChangedCallback

Func<EntityCollectionChangedParams,Boolean>

Delegato che incapsula un metodo chiamato quando cambia la raccolta di entità.

Commenti

Per impostazione predefinita, il rilevamento automatico delle modifiche è abilitato per un DataServiceCollection<T>. Utilizzare questo costruttore di classe per fornire un valore di None per trackingMode per creare un'istanza di DataServiceCollection<T> che usa il rilevamento delle modifiche manuale. Quando si usa il rilevamento manuale, è necessario implementare INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi di generazione per segnalare manualmente le modifiche al DataServiceContext.

Il DataServiceContext deve essere fornito quando items non è un DataServiceQuery<TElement> o QueryOperationResponse<T> con un riferimento a un'istanza di DataServiceContext.

Le funzioni entityChanged e collectionChanged vengono richiamate rispettivamente dagli eventi PropertyChanged e CollectionChanged. Il metodo entityChanged accetta un valore EntityCollectionChangedParams e il metodo collectionChanged accetta un valore EntityChangedParams. Entrambi i metodi devono restituire un valore booleano che indica se l'evento è stato gestito dalla funzione . Quando il metodo restituisce true, si verificherà comunque il comportamento predefinito.