DataServiceCollection<T> Construtores
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria uma nova instância da DataServiceCollection<T> classe.
Sobrecargas
DataServiceCollection<T>()
Cria uma nova instância da DataServiceCollection<T> classe.
public:
DataServiceCollection();public DataServiceCollection();Public Sub New ()Observações
Por defeito, o rastreio automático de alterações está ativado para um DataServiceCollection<T>. Pode criar uma instância de DataServiceCollection<T> que utilize o acompanhamento manual de alterações quando cria uma instância usando um construtor que lhe permite fornecer um valor de None para TrackingMode. Quando usa rastreamento manual, deve implementar INotifyPropertyChanged e INotifyCollectionChanged e gerir os eventos de aumento para reportar manualmente alterações ao DataServiceContext.
O acompanhamento automático de alterações começa após o carregamento dos itens na coleção.
Aplica-se a
DataServiceCollection<T>(IEnumerable<T>)
Cria uma nova instância da DataServiceCollection<T> classe com base na execução da 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>
Uma DataServiceQuery<TElement> consulta ou LINQ que devolve uma IEnumerable<T> coleção de objetos usados para inicializar a coleção.
Observações
A IEnumerable<T> coleção de objetos fornecida para items é geralmente uma consulta que devolve os itens da coleção. No entanto, qualquer IEnumerable<T> coleção do tipo correto pode ser fornecida.
Por defeito, o rastreio automático de alterações está ativado para um DataServiceCollection<T>. Pode criar uma instância de DataServiceCollection<T> que utilize o acompanhamento manual de alterações quando cria uma instância usando um construtor que lhe permite fornecer um valor de None para TrackingMode. Quando usa rastreamento manual, deve implementar INotifyPropertyChanged e INotifyCollectionChanged e gerir os eventos de aumento para reportar manualmente alterações ao DataServiceContext.
Aplica-se a
DataServiceCollection<T>(DataServiceContext)
Cria uma nova instância da DataServiceCollection<T> classe que utiliza o especificado DataServiceContext.
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
É DataServiceContext usado para acompanhar alterações nos objetos da coleção.
Observações
Use este construtor para criar uma entidade vazia DataServiceCollection<T> à qual objetos da entidade podem ser adicionados sem executar uma consulta ao serviço ou quando um IEnumerable<T> não estiver disponível.
Por defeito, o rastreio automático de alterações está ativado para um DataServiceCollection<T>. Pode criar uma instância de DataServiceCollection<T> que utilize o acompanhamento manual de alterações quando cria uma instância usando um construtor que lhe permite fornecer um valor de None para TrackingMode. Quando usa rastreamento manual, deve implementar INotifyPropertyChanged e INotifyCollectionChanged e gerir os eventos de aumento para reportar manualmente alterações ao DataServiceContext.
Aplica-se a
DataServiceCollection<T>(IEnumerable<T>, TrackingMode)
Cria uma nova instância da DataServiceCollection<T> classe com base na execução da consulta e com o modo de rastreamento 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>
Uma DataServiceQuery<TElement> consulta ou LINQ que devolve uma IEnumerable<T> coleção de objetos usados para inicializar a coleção.
- trackingMode
- TrackingMode
Um valor que indicava se as TrackingMode alterações feitas aos itens na coleção são ou não rastreadas automaticamente.
Observações
Por defeito, o rastreio automático de alterações está ativado para um DataServiceCollection<T>. Use este construtor de classes e forneça um valor de None for trackingMode para criar uma instância de DataServiceCollection<T> que utilize o acompanhamento manual de alterações. Quando usa rastreamento manual, deve implementar INotifyPropertyChanged e INotifyCollectionChanged e gerir os eventos de aumento para reportar manualmente alterações ao DataServiceContext.
A IEnumerable<T> coleção de objetos fornecida para items é geralmente uma consulta que devolve os itens da coleção. No entanto, qualquer IEnumerable<T> coleção do tipo correto pode ser fornecida.
Aplica-se a
DataServiceCollection<T>(DataServiceContext, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)
Cria uma nova instância da DataServiceCollection<T> classe com os delegados do método de alteração fornecidos e que utiliza o especificado DataServiceContext.
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 acompanhar itens na coleção.
- entitySetName
- String
O conjunto de entidades dos objetos na coleção.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Um delegado que encapsula um método chamado quando uma entidade muda.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Um delegado que encapsula um método chamado quando a coleção de entidades muda.
Observações
Use este construtor para criar uma entidade vazia DataServiceCollection<T> à qual objetos da entidade podem ser adicionados sem executar uma consulta ao serviço ou quando um IEnumerable<T> não estiver disponível.
Por defeito, o rastreio automático de alterações está ativado para um DataServiceCollection<T>. Pode criar uma instância de DataServiceCollection<T> que utilize o acompanhamento manual de alterações quando cria uma instância usando um construtor que lhe permite fornecer um valor de None para TrackingMode. Quando usa rastreamento manual, deve implementar INotifyPropertyChanged e INotifyCollectionChanged e gerir os eventos de aumento para reportar manualmente alterações ao DataServiceContext.
Aplica-se a
DataServiceCollection<T>(IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)
Cria uma nova instância da DataServiceCollection<T> classe A com base na execução da consulta e com o método de alteração fornecido para delegar.
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>
Uma DataServiceQuery<TElement> consulta ou LINQ que devolve uma IEnumerable<T> coleção de objetos usados para inicializar a coleção.
- trackingMode
- TrackingMode
Um valor que indicava se as TrackingMode alterações feitas aos itens na coleção são ou não rastreadas automaticamente.
- entitySetName
- String
O conjunto de entidades dos objetos na coleção.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Um delegado que encapsula um método chamado quando uma entidade muda.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Um delegado que encapsula um método chamado quando a coleção de entidades muda.
Observações
As entityChanged funções e collectionChanged são invocadas pelos PropertyChanged eventos e CollectionChanged , respetivamente. O entityChanged método assume um EntityCollectionChangedParams valor e o collectionChanged método assume um EntityChangedParams valor. Ambos os métodos devem devolver um valor booleano que indique se o evento foi tratado pela função. Quando o método retorna true, o comportamento padrão continua a ocorrer.
Por defeito, o rastreio automático de alterações está ativado para um DataServiceCollection<T>. Pode criar uma instância de DataServiceCollection<T> que utilize o acompanhamento manual de alterações quando cria uma instância usando um construtor que lhe permite fornecer um valor de None para TrackingMode. Quando usa rastreamento manual, deve implementar INotifyPropertyChanged e INotifyCollectionChanged e gerir os eventos de aumento para reportar manualmente alterações ao DataServiceContext.
Aplica-se a
DataServiceCollection<T>(DataServiceContext, IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams, Boolean>)
Cria uma nova instância da DataServiceCollection<T> classe a com base na execução da consulta, com o método de alteração fornecido como delegado, e que utiliza o .DataServiceContext
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 acompanhar itens na coleção.
- items
- IEnumerable<T>
Uma DataServiceQuery<TElement> consulta ou LINQ que devolve uma IEnumerable<T> coleção de objetos usados para inicializar a coleção.
- trackingMode
- TrackingMode
Um valor que indicava se as TrackingMode alterações feitas aos itens na coleção são ou não rastreadas automaticamente.
- entitySetName
- String
O conjunto de entidades dos objetos na coleção.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Um delegado que encapsula um método chamado quando uma entidade muda.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Um delegado que encapsula um método chamado quando a coleção de entidades muda.
Observações
Por defeito, o rastreio automático de alterações está ativado para um DataServiceCollection<T>. Use este construtor de classes para fornecer um valor de None for trackingMode e criar uma instância de DataServiceCollection<T> que utilize o acompanhamento manual de alterações. Quando usa rastreamento manual, deve implementar INotifyPropertyChanged e INotifyCollectionChanged e gerir os eventos de aumento para reportar manualmente alterações ao DataServiceContext.
O DataServiceContext deve ser fornecido quando items não é um DataServiceQuery<TElement> ou QueryOperationResponse<T> que tem referência a uma DataServiceContext instância.
As entityChanged funções e collectionChanged são invocadas pelos PropertyChanged eventos e CollectionChanged , respetivamente. O entityChanged método assume um EntityCollectionChangedParams valor e o collectionChanged método assume um EntityChangedParams valor. Ambos os métodos devem devolver um valor booleano que indique se o evento foi tratado pela função. Quando o método retorna true, o comportamento padrão continuará a ocorrer.
