DataServiceCollection<T> Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea una nuova istanza della classe DataServiceCollection<T>.
Overload
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.
Si applica a
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.
Si applica a
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.
Si applica a
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.
Si applica a
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.
Si applica a
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.
Si applica a
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.