DataServiceCollection<T> Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea una nueva instancia de la clase DataServiceCollection<T>.
Sobrecargas
DataServiceCollection<T>()
Crea una nueva instancia de la clase DataServiceCollection<T>.
public:
DataServiceCollection();
public DataServiceCollection ();
Public Sub New ()
Comentarios
De forma predeterminada, el seguimiento de cambios automático está habilitado para DataServiceCollection<T>. Puede crear una instancia de DataServiceCollection<T> que usa el seguimiento de cambios manual al crear una instancia mediante un constructor que le permite proporcionar un valor de None para TrackingMode. Cuando use el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos para notificar manualmente los cambios a DataServiceContext.
El seguimiento de cambios automático comienza una vez cargados los elementos en la colección.
Se aplica a
DataServiceCollection<T>(IEnumerable<T>)
Crea una nueva instancia de la clase DataServiceCollection<T> basándose en la ejecución de la consulta.
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))
Parámetros
- items
- IEnumerable<T>
DataServiceQuery<TElement> o consulta LINQ que devuelve una colección IEnumerable<T> de los objetos que se usan para inicializar la colección.
Comentarios
La colección IEnumerable<T> de objetos proporcionada para items
suele ser una consulta que devuelve los elementos de la colección. Sin embargo, se puede proporcionar cualquier colección IEnumerable<T> del tipo correcto.
De forma predeterminada, el seguimiento de cambios automático está habilitado para DataServiceCollection<T>. Puede crear una instancia de DataServiceCollection<T> que usa el seguimiento de cambios manual al crear una instancia mediante un constructor que le permite proporcionar un valor de None para TrackingMode. Cuando use el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos para notificar manualmente los cambios a DataServiceContext.
Se aplica a
DataServiceCollection<T>(DataServiceContext)
Crea una nueva instancia de la clase DataServiceCollection<T> que usa el objeto DataServiceContext especificado.
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)
Parámetros
- context
- DataServiceContext
El DataServiceContext usado para realizar un seguimiento de los cambios en los objetos de la colección.
Comentarios
Use este constructor para crear una DataServiceCollection<T> vacía a la que se pueden agregar objetos de entidad sin ejecutar una consulta en el servicio o cuando IEnumerable<T> no está disponible.
De forma predeterminada, el seguimiento de cambios automático está habilitado para DataServiceCollection<T>. Puede crear una instancia de DataServiceCollection<T> que usa el seguimiento de cambios manual al crear una instancia mediante un constructor que le permite proporcionar un valor de None para TrackingMode. Cuando use el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos para notificar manualmente los cambios a DataServiceContext.
Se aplica a
DataServiceCollection<T>(IEnumerable<T>, TrackingMode)
Crea una nueva instancia de la clase DataServiceCollection<T> basándose en la ejecución de la consulta y con el modo de seguimiento especificado.
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)
Parámetros
- items
- IEnumerable<T>
DataServiceQuery<TElement> o consulta LINQ que devuelve una colección IEnumerable<T> de los objetos que se usan para inicializar la colección.
- trackingMode
- TrackingMode
Valor TrackingMode que indica si se realiza automáticamente un seguimiento o no de los cambios efectuados en los elementos de la colección.
Comentarios
De forma predeterminada, el seguimiento de cambios automático está habilitado para DataServiceCollection<T>. Use este constructor de clase y proporcione un valor de None para trackingMode
con el fin de crear una instancia de DataServiceCollection<T> que use el seguimiento de cambios manual. Cuando use el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos para notificar manualmente los cambios a DataServiceContext.
La colección IEnumerable<T> de objetos proporcionada para items
suele ser una consulta que devuelve los elementos de la colección. Sin embargo, se puede proporcionar cualquier colección IEnumerable<T> del tipo correcto.
Se aplica a
DataServiceCollection<T>(DataServiceContext, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)
Crea una nueva instancia de la clase DataServiceCollection<T> con los delegados de método de cambio proporcionados y que usa el DataServiceContext especificado.
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))
Parámetros
- context
- DataServiceContext
DataServiceContext usado para realizar el seguimiento de los elementos de la colección.
- entitySetName
- String
Conjunto de entidades de los objetos de la colección.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Delegado que encapsula un método al que se llama cuando una entidad cambia.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Delegado que encapsula un método al que se llama cuando la colección de entidades cambia.
Comentarios
Use este constructor para crear una DataServiceCollection<T> vacía a la que se pueden agregar objetos de entidad sin ejecutar una consulta en el servicio o cuando IEnumerable<T> no está disponible.
De forma predeterminada, el seguimiento de cambios automático está habilitado para DataServiceCollection<T>. Puede crear una instancia de DataServiceCollection<T> que usa el seguimiento de cambios manual al crear una instancia mediante un constructor que le permite proporcionar un valor de None para TrackingMode. Cuando use el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos para notificar manualmente los cambios a DataServiceContext.
Se aplica a
DataServiceCollection<T>(IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)
Crea una nueva instancia de la clase DataServiceCollection<T> basándose en la ejecución de la consulta y con los delegados de método de cambio proporcionados.
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))
Parámetros
- items
- IEnumerable<T>
DataServiceQuery<TElement> o consulta LINQ que devuelve una colección IEnumerable<T> de los objetos que se usan para inicializar la colección.
- trackingMode
- TrackingMode
Valor TrackingMode que indica si se realiza automáticamente un seguimiento o no de los cambios efectuados en los elementos de la colección.
- entitySetName
- String
Conjunto de entidades de los objetos de la colección.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Delegado que encapsula un método al que se llama cuando una entidad cambia.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Delegado que encapsula un método al que se llama cuando la colección de entidades cambia.
Comentarios
Los eventos entityChanged
y collectionChanged
invocan las funciones PropertyChanged y CollectionChanged, respectivamente. El método entityChanged
toma un valor EntityCollectionChangedParams y el método collectionChanged
toma un valor EntityChangedParams. Ambos métodos deben devolver un valor booleano que indica si la función controló el evento. Cuando el método devuelve true
, se sigue produciendo el comportamiento predeterminado.
De forma predeterminada, el seguimiento de cambios automático está habilitado para DataServiceCollection<T>. Puede crear una instancia de DataServiceCollection<T> que usa el seguimiento de cambios manual al crear una instancia mediante un constructor que le permite proporcionar un valor de None para TrackingMode. Cuando use el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos para notificar manualmente los cambios a DataServiceContext.
Se aplica a
DataServiceCollection<T>(DataServiceContext, IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams, Boolean>)
Crea una nueva instancia de la clase DataServiceCollection<T> basándose en la ejecución de la consulta, con los delegados de método de cambio proporcionados y que usa el DataServiceContext proporcionado.
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))
Parámetros
- context
- DataServiceContext
DataServiceContext usado para realizar el seguimiento de los elementos de la colección.
- items
- IEnumerable<T>
DataServiceQuery<TElement> o consulta LINQ que devuelve una colección IEnumerable<T> de los objetos que se usan para inicializar la colección.
- trackingMode
- TrackingMode
Valor TrackingMode que indica si se realiza automáticamente un seguimiento o no de los cambios efectuados en los elementos de la colección.
- entitySetName
- String
Conjunto de entidades de los objetos de la colección.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Delegado que encapsula un método al que se llama cuando una entidad cambia.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Delegado que encapsula un método al que se llama cuando la colección de entidades cambia.
Comentarios
De forma predeterminada, el seguimiento de cambios automático está habilitado para DataServiceCollection<T>. Use este constructor de clase para proporcionar un valor de None para trackingMode
con el fin de crear una instancia de DataServiceCollection<T> que use el seguimiento de cambios manual. Cuando use el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos para notificar manualmente los cambios a DataServiceContext.
Se debe proporcionar DataServiceContext cuando items
no es una DataServiceQuery<TElement> o QueryOperationResponse<T> que tiene una referencia a una instancia de DataServiceContext.
Los eventos entityChanged
y collectionChanged
invocan las funciones PropertyChanged y CollectionChanged, respectivamente. El método entityChanged
toma un valor EntityCollectionChangedParams y el método collectionChanged
toma un valor EntityChangedParams. Ambos métodos deben devolver un valor booleano que indica si la función controló el evento. Cuando el método devuelve true
, se seguirá produciendo el comportamiento predeterminado.