DataServiceCollection<T> Costruttori

Definizione

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> basata sull'esecuzione di query.

DataServiceCollection<T>(DataServiceContext)

Crea una nuova istanza della classe DataServiceCollection<T> che utilizza l'oggetto DataServiceContext specificato.

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.

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.

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.

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.

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, si verificherà comunque il comportamento predefinito.

Si applica a