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 automático de cambios está habilitado para un DataServiceCollection<T>. Puede crear una instancia de DataServiceCollection<T> que use el seguimiento de cambios manual al crear una instancia mediante un constructor que le permita proporcionar un valor de None para TrackingMode. Al usar el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos de elevación para notificar manualmente los cambios en el DataServiceContext.
El seguimiento automático de cambios comienza después de cargar los elementos en la colección.
Se aplica a
DataServiceCollection<T>(IEnumerable<T>)
Crea una nueva instancia de la clase DataServiceCollection<T> basada en la ejecución de consultas.
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>
Una consulta DataServiceQuery<TElement> o LINQ que devuelve una colección IEnumerable<T> de objetos que se usan para inicializar la colección.
Comentarios
La colección IEnumerable<T> de objetos proporcionados 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 automático de cambios está habilitado para un DataServiceCollection<T>. Puede crear una instancia de DataServiceCollection<T> que use el seguimiento de cambios manual al crear una instancia mediante un constructor que le permita proporcionar un valor de None para TrackingMode. Al usar el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos de elevación para notificar manualmente los cambios en el DataServiceContext.
Se aplica a
DataServiceCollection<T>(DataServiceContext)
Crea una nueva instancia de la clase DataServiceCollection<T> que usa el DataServiceContextespecificado.
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 no esté disponible un IEnumerable<T>.
De forma predeterminada, el seguimiento automático de cambios está habilitado para un DataServiceCollection<T>. Puede crear una instancia de DataServiceCollection<T> que use el seguimiento de cambios manual al crear una instancia mediante un constructor que le permita proporcionar un valor de None para TrackingMode. Al usar el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos de elevación para notificar manualmente los cambios en el DataServiceContext.
Se aplica a
DataServiceCollection<T>(IEnumerable<T>, TrackingMode)
Crea una nueva instancia de la clase DataServiceCollection<T> basada en la ejecución de consultas 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>
Una consulta DataServiceQuery<TElement> o LINQ que devuelve una colección IEnumerable<T> de objetos que se usan para inicializar la colección.
- trackingMode
- TrackingMode
Valor TrackingMode que indica si se realiza un seguimiento automático de los cambios realizados en los elementos de la colección.
Comentarios
De forma predeterminada, el seguimiento automático de cambios está habilitado para un DataServiceCollection<T>. Use este constructor de clase y proporcione un valor de None para trackingMode para crear una instancia de DataServiceCollection<T> que use el seguimiento de cambios manual. Al usar el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos de elevación para notificar manualmente los cambios en el DataServiceContext.
La colección IEnumerable<T> de objetos proporcionados 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 del método de cambio proporcionados y que usa el DataServiceContextespecificado.
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
El DataServiceContext usado para realizar un 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 cambia una entidad.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Delegado que encapsula un método al que se llama cuando cambia la colección de entidades.
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 no esté disponible un IEnumerable<T>.
De forma predeterminada, el seguimiento automático de cambios está habilitado para un DataServiceCollection<T>. Puede crear una instancia de DataServiceCollection<T> que use el seguimiento de cambios manual al crear una instancia mediante un constructor que le permita proporcionar un valor de None para TrackingMode. Al usar el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos de elevación para notificar manualmente los cambios en el 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> basada en la ejecución de consultas y con los delegados del 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>
Una consulta DataServiceQuery<TElement> o LINQ que devuelve una colección IEnumerable<T> de objetos que se usan para inicializar la colección.
- trackingMode
- TrackingMode
Valor TrackingMode que indica si se realiza un seguimiento automático de los cambios realizados 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 cambia una entidad.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Delegado que encapsula un método al que se llama cuando cambia la colección de entidades.
Comentarios
Los eventos PropertyChanged y CollectionChanged invocan las funciones entityChanged 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 automático de cambios está habilitado para un DataServiceCollection<T>. Puede crear una instancia de DataServiceCollection<T> que use el seguimiento de cambios manual al crear una instancia mediante un constructor que le permita proporcionar un valor de None para TrackingMode. Al usar el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos de elevación para notificar manualmente los cambios en el 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> basada en la ejecución de consultas, con los delegados del método de cambio proporcionados y que usa el DataServiceContextproporcionado.
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
El DataServiceContext usado para realizar un seguimiento de los elementos de la colección.
- items
- IEnumerable<T>
Una consulta DataServiceQuery<TElement> o LINQ que devuelve una colección IEnumerable<T> de objetos que se usan para inicializar la colección.
- trackingMode
- TrackingMode
Valor TrackingMode que indica si se realiza un seguimiento automático de los cambios realizados 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 cambia una entidad.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Delegado que encapsula un método al que se llama cuando cambia la colección de entidades.
Comentarios
De forma predeterminada, el seguimiento automático de cambios está habilitado para un DataServiceCollection<T>. Use este constructor de clase para proporcionar un valor de None para trackingMode para crear una instancia de DataServiceCollection<T> que use el seguimiento manual de cambios. Al usar el seguimiento manual, debe implementar INotifyPropertyChanged y INotifyCollectionChanged y controlar los eventos de elevación para notificar manualmente los cambios en el DataServiceContext.
El DataServiceContext debe proporcionarse cuando items no es un DataServiceQuery<TElement> o QueryOperationResponse<T> que tenga una referencia a una instancia de DataServiceContext.
Los eventos PropertyChanged y CollectionChanged invocan las funciones entityChanged 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.
