DataServiceCollection<T> Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria uma nova instância da classe DataServiceCollection<T>.
Sobrecargas
DataServiceCollection<T>()
Cria uma nova instância da classe DataServiceCollection<T>.
public:
DataServiceCollection();public DataServiceCollection ();Public Sub New ()Comentários
Por padrão, o controle automático de alterações está habilitado para um DataServiceCollection<T>. Você pode criar uma instância de DataServiceCollection<T> que usa o controle manual de alterações ao criar uma instância usando um construtor que permite fornecer um valor de None para TrackingMode. Ao usar o acompanhamento manual, você deve implementar INotifyPropertyChanged e INotifyCollectionChanged e manipular os eventos de geração para relatar manualmente as alterações no DataServiceContext.
O controle automático de alterações começa depois que os itens são carregados na coleção.
Aplica-se a
DataServiceCollection<T>(IEnumerable<T>)
Cria uma nova instância da classe DataServiceCollection<T> 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 consulta DataServiceQuery<TElement> ou LINQ que retorna uma coleção IEnumerable<T> de objetos que são usados para inicializar a coleção.
Comentários
A coleção IEnumerable<T> de objetos fornecidos para items geralmente é uma consulta que retorna os itens na coleção. No entanto, qualquer coleção IEnumerable<T> do tipo correto pode ser fornecida.
Por padrão, o controle automático de alterações está habilitado para um DataServiceCollection<T>. Você pode criar uma instância de DataServiceCollection<T> que usa o controle manual de alterações ao criar uma instância usando um construtor que permite fornecer um valor de None para TrackingMode. Ao usar o acompanhamento manual, você deve implementar INotifyPropertyChanged e INotifyCollectionChanged e manipular os eventos de geração para relatar manualmente as alterações no DataServiceContext.
Aplica-se a
DataServiceCollection<T>(DataServiceContext)
Cria uma nova instância da classe DataServiceCollection<T> que usa o 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
O DataServiceContext usado para controlar alterações em objetos na coleção.
Comentários
Use esse construtor para criar uma DataServiceCollection<T> vazia à qual os objetos de entidade podem ser adicionados sem executar uma consulta no serviço ou quando um IEnumerable<T> não estiver disponível.
Por padrão, o controle automático de alterações está habilitado para um DataServiceCollection<T>. Você pode criar uma instância de DataServiceCollection<T> que usa o controle manual de alterações ao criar uma instância usando um construtor que permite fornecer um valor de None para TrackingMode. Ao usar o acompanhamento manual, você deve implementar INotifyPropertyChanged e INotifyCollectionChanged e manipular os eventos de geração para relatar manualmente as alterações no DataServiceContext.
Aplica-se a
DataServiceCollection<T>(IEnumerable<T>, TrackingMode)
Cria uma nova instância da classe DataServiceCollection<T> com base na execução da consulta e com o modo de acompanhamento 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 consulta DataServiceQuery<TElement> ou LINQ que retorna uma coleção IEnumerable<T> de objetos que são usados para inicializar a coleção.
- trackingMode
- TrackingMode
Um valor TrackingMode que indica se as alterações feitas em itens na coleção são controladas automaticamente.
Comentários
Por padrão, o controle automático de alterações está habilitado para um DataServiceCollection<T>. Use esse construtor de classe e forneça um valor de None para trackingMode para criar uma instância de DataServiceCollection<T> que usa o controle manual de alterações. Ao usar o acompanhamento manual, você deve implementar INotifyPropertyChanged e INotifyCollectionChanged e manipular os eventos de geração para relatar manualmente as alterações no DataServiceContext.
A coleção IEnumerable<T> de objetos fornecidos para items geralmente é uma consulta que retorna os itens na coleção. No entanto, qualquer coleção IEnumerable<T> 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 classe DataServiceCollection<T> com os delegados de método de alteração fornecidos e que usa o 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
O DataServiceContext usado para rastrear 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 é alterada.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Um delegado que encapsula um método chamado quando a coleção de entidades é alterada.
Comentários
Use esse construtor para criar uma DataServiceCollection<T> vazia à qual os objetos de entidade podem ser adicionados sem executar uma consulta no serviço ou quando um IEnumerable<T> não estiver disponível.
Por padrão, o controle automático de alterações está habilitado para um DataServiceCollection<T>. Você pode criar uma instância de DataServiceCollection<T> que usa o controle manual de alterações ao criar uma instância usando um construtor que permite fornecer um valor de None para TrackingMode. Ao usar o acompanhamento manual, você deve implementar INotifyPropertyChanged e INotifyCollectionChanged e manipular os eventos de geração para relatar manualmente as alterações no DataServiceContext.
Aplica-se a
DataServiceCollection<T>(IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)
Cria uma nova instância da classe DataServiceCollection<T> com base na execução da consulta e com os delegados de método de alteração fornecidos.
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 consulta DataServiceQuery<TElement> ou LINQ que retorna uma coleção IEnumerable<T> de objetos que são usados para inicializar a coleção.
- trackingMode
- TrackingMode
Um valor TrackingMode que indica se as alterações feitas em itens na coleção são controladas 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 é alterada.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Um delegado que encapsula um método chamado quando a coleção de entidades é alterada.
Comentários
As funções entityChanged e collectionChanged são invocadas pelos eventos PropertyChanged e CollectionChanged, respectivamente. O método entityChanged usa um valor EntityCollectionChangedParams e o método collectionChanged usa um valor EntityChangedParams. Ambos os métodos devem retornar um valor booliano que indica se o evento foi manipulado pela função. Quando o método retorna true, o comportamento padrão ainda ocorre.
Por padrão, o controle automático de alterações está habilitado para um DataServiceCollection<T>. Você pode criar uma instância de DataServiceCollection<T> que usa o controle manual de alterações ao criar uma instância usando um construtor que permite fornecer um valor de None para TrackingMode. Ao usar o acompanhamento manual, você deve implementar INotifyPropertyChanged e INotifyCollectionChanged e manipular os eventos de geração para relatar manualmente as alterações no DataServiceContext.
Aplica-se a
DataServiceCollection<T>(DataServiceContext, IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams, Boolean>)
Cria uma nova instância da classe DataServiceCollection<T> com base na execução da consulta, com os delegados de método de alteração fornecidos e que usa o DataServiceContextfornecido.
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
O DataServiceContext usado para rastrear itens na coleção.
- items
- IEnumerable<T>
Uma consulta DataServiceQuery<TElement> ou LINQ que retorna uma coleção IEnumerable<T> de objetos que são usados para inicializar a coleção.
- trackingMode
- TrackingMode
Um valor TrackingMode que indica se as alterações feitas em itens na coleção são controladas 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 é alterada.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Um delegado que encapsula um método chamado quando a coleção de entidades é alterada.
Comentários
Por padrão, o controle automático de alterações está habilitado para um DataServiceCollection<T>. Use esse construtor de classe para fornecer um valor de None para trackingMode para criar uma instância de DataServiceCollection<T> que usa o controle manual de alterações. Ao usar o acompanhamento manual, você deve implementar INotifyPropertyChanged e INotifyCollectionChanged e manipular os eventos de geração para relatar manualmente as alterações no DataServiceContext.
O DataServiceContext deve ser fornecido quando items não é um DataServiceQuery<TElement> ou QueryOperationResponse<T> que tenha uma referência a uma instância de DataServiceContext.
As funções entityChanged e collectionChanged são invocadas pelos eventos PropertyChanged e CollectionChanged, respectivamente. O método entityChanged usa um valor EntityCollectionChangedParams e o método collectionChanged usa um valor EntityChangedParams. Ambos os métodos devem retornar um valor booliano que indica se o evento foi manipulado pela função. Quando o método retorna true, o comportamento padrão ainda ocorrerá.
