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 delle modifiche automatico è abilitato per un oggetto DataServiceCollection<T>. È possibile creare un'istanza dell'oggetto DataServiceCollection<T> che utilizza il rilevamento delle modifiche manuale quando si crea un'istanza tramite un costruttore che consente di fornire un valore del campo None per l'oggetto TrackingMode. Quando si utilizza il rilevamento manuale, è necessario implementare gli oggetti INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi generati per segnalare manualmente le modifiche all'oggetto DataServiceContext.
Il rilevamento delle modifiche automatico inizia dopo il caricamento degli elementi nella raccolta.
Si applica a
DataServiceCollection<T>(IEnumerable<T>)
Crea una nuova istanza della classe DataServiceCollection<T> basata sull'esecuzione di 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>
Oggetto DataServiceQuery<TElement> o query LINQ che restituisce una raccolta IEnumerable<T> di oggetti utilizzati per inizializzare la raccolta.
Commenti
La raccolta IEnumerable<T> di oggetti fornita per il parametro items
è generalmente una query che restituisce gli elementi nella raccolta. Tuttavia, è possibile fornire qualsiasi raccolta IEnumerable<T> del tipo corretto.
Per impostazione predefinita, il rilevamento delle modifiche automatico è abilitato per un oggetto DataServiceCollection<T>. È possibile creare un'istanza dell'oggetto DataServiceCollection<T> che utilizza il rilevamento delle modifiche manuale quando si crea un'istanza tramite un costruttore che consente di fornire un valore del campo None per l'oggetto TrackingMode. Quando si utilizza il rilevamento manuale, è necessario implementare gli oggetti INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi generati per segnalare manualmente le modifiche all'oggetto DataServiceContext.
Si applica a
DataServiceCollection<T>(DataServiceContext)
Crea una nuova istanza della classe DataServiceCollection<T> che utilizza l'oggetto DataServiceContext specificato.
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
Oggetto DataServiceContext utilizzato per rilevare le modifiche apportate agli oggetti nella raccolta.
Commenti
Utilizzare questo costruttore per creare un oggetto DataServiceCollection<T> vuoto al quale è possibile aggiungere gli oggetti entità senza eseguire una query sul servizio o quando un oggetto IEnumerable<T> non è disponibile.
Per impostazione predefinita, il rilevamento delle modifiche automatico è abilitato per un oggetto DataServiceCollection<T>. È possibile creare un'istanza dell'oggetto DataServiceCollection<T> che utilizza il rilevamento delle modifiche manuale quando si crea un'istanza tramite un costruttore che consente di fornire un valore del campo None per l'oggetto TrackingMode. Quando si utilizza il rilevamento manuale, è necessario implementare gli oggetti INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi generati per segnalare manualmente le modifiche all'oggetto DataServiceContext.
Si applica a
DataServiceCollection<T>(IEnumerable<T>, TrackingMode)
Crea una nuova istanza della classe DataServiceCollection<T> basata sull'esecuzione di 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>
Oggetto DataServiceQuery<TElement> o query LINQ che restituisce una raccolta IEnumerable<T> di oggetti utilizzati per inizializzare la raccolta.
- trackingMode
- TrackingMode
Valore TrackingMode che indica se le modifiche apportate agli elementi nella raccolta vengono rilevate automaticamente.
Commenti
Per impostazione predefinita, il rilevamento delle modifiche automatico è abilitato per un oggetto DataServiceCollection<T>. Utilizzare questo costruttore di classi e fornire un valore del campo None affinché il parametro trackingMode
crei un'istanza dell'oggetto DataServiceCollection<T> che utilizza il rilevamento delle modifiche manuale. Quando si utilizza il rilevamento manuale, è necessario implementare gli oggetti INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi generati per segnalare manualmente le modifiche all'oggetto DataServiceContext.
La raccolta IEnumerable<T> di oggetti fornita per il parametro items
è generalmente una query che restituisce gli elementi nella raccolta. Tuttavia, è possibile fornire qualsiasi raccolta IEnumerable<T> 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 l'oggetto DataServiceContext specificato.
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
Oggetto DataServiceContext utilizzato per rilevare gli elementi nella raccolta.
- entitySetName
- String
Set di entità degli oggetti nella raccolta.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Delegato che incapsula un metodo chiamato quando un'entità viene modificata.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Delegato che incapsula un metodo chiamato quando la raccolta di entità viene modificata.
Commenti
Utilizzare questo costruttore per creare un oggetto DataServiceCollection<T> vuoto al quale è possibile aggiungere gli oggetti entità senza eseguire una query sul servizio o quando un oggetto IEnumerable<T> non è disponibile.
Per impostazione predefinita, il rilevamento delle modifiche automatico è abilitato per un oggetto DataServiceCollection<T>. È possibile creare un'istanza dell'oggetto DataServiceCollection<T> che utilizza il rilevamento delle modifiche manuale quando si crea un'istanza tramite un costruttore che consente di fornire un valore del campo None per l'oggetto TrackingMode. Quando si utilizza il rilevamento manuale, è necessario implementare gli oggetti INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi generati per segnalare manualmente le modifiche all'oggetto DataServiceContext.
Si applica a
DataServiceCollection<T>(IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)
Crea una nuova istanza della classe DataServiceCollection<T> basata sull'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>
Oggetto DataServiceQuery<TElement> o query LINQ che restituisce una raccolta IEnumerable<T> di oggetti utilizzati per inizializzare la raccolta.
- trackingMode
- TrackingMode
Valore TrackingMode che indica se le modifiche apportate agli elementi nella raccolta vengono rilevate automaticamente.
- entitySetName
- String
Set di entità degli oggetti nella raccolta.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Delegato che incapsula un metodo chiamato quando un'entità viene modificata.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Delegato che incapsula un metodo chiamato quando la raccolta di entità viene modificata.
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 delle modifiche automatico è abilitato per un oggetto DataServiceCollection<T>. È possibile creare un'istanza dell'oggetto DataServiceCollection<T> che utilizza il rilevamento delle modifiche manuale quando si crea un'istanza tramite un costruttore che consente di fornire un valore del campo None per l'oggetto TrackingMode. Quando si utilizza il rilevamento manuale, è necessario implementare gli oggetti INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi generati per segnalare manualmente le modifiche all'oggetto 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> basata sull'esecuzione di query, con i delegati del metodo di modifica forniti e che utilizza l'oggetto DataServiceContext fornito.
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
Oggetto DataServiceContext utilizzato per rilevare gli elementi nella raccolta.
- items
- IEnumerable<T>
Oggetto DataServiceQuery<TElement> o query LINQ che restituisce una raccolta IEnumerable<T> di oggetti utilizzati per inizializzare la raccolta.
- trackingMode
- TrackingMode
Valore TrackingMode che indica se le modifiche apportate agli elementi nella raccolta vengono rilevate automaticamente.
- entitySetName
- String
Set di entità degli oggetti nella raccolta.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Delegato che incapsula un metodo chiamato quando un'entità viene modificata.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Delegato che incapsula un metodo chiamato quando la raccolta di entità viene modificata.
Commenti
Per impostazione predefinita, il rilevamento delle modifiche automatico è abilitato per un oggetto DataServiceCollection<T>. Utilizzare questo costruttore di classi per fornire un valore del campo None affinché il parametro trackingMode
crei un'istanza dell'oggetto DataServiceCollection<T> che utilizza il rilevamento delle modifiche manuale. Quando si utilizza il rilevamento manuale, è necessario implementare gli oggetti INotifyPropertyChanged e INotifyCollectionChanged e gestire gli eventi generati per segnalare manualmente le modifiche all'oggetto DataServiceContext.
L'oggetto DataServiceContext deve essere fornito quando il parametro items
non è un oggetto DataServiceQuery<TElement> o QueryOperationResponse<T> che dispone di un riferimento a un'istanza 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
, il comportamento predefinito si verificherà comunque.