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 do que usa o controle manual de DataServiceCollection<T> 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 manipular os eventos de acionamento 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 de 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> ou consulta LINQ que retorna uma coleção IEnumerable<T> de objetos usados para inicializar a coleção.
Comentários
A IEnumerable<T> coleção de objetos fornecidos para items
geralmente é uma consulta que retorna os itens na coleção. No entanto, qualquer IEnumerable<T> coleção 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 do que usa o controle manual de DataServiceCollection<T> 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 manipular os eventos de acionamento 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 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
O DataServiceContext usado para controlar as alterações em objetos na coleção.
Comentários
Use esse construtor para criar um vazio DataServiceCollection<T> ao qual objetos de entidade podem ser adicionados sem executar uma consulta no serviço ou quando um IEnumerable<T> não está disponível.
Por padrão, o controle automático de alterações está habilitado para um DataServiceCollection<T>. Você pode criar uma instância do que usa o controle manual de DataServiceCollection<T> 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 manipular os eventos de acionamento 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 em uma execução de 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 DataServiceQuery<TElement> ou consulta LINQ que retorna uma coleção IEnumerable<T> de objetos usados para inicializar a coleção.
- trackingMode
- TrackingMode
Um valor TrackingMode que indica se as alterações feitas nos itens da coleção são controlados automaticamente ou não.
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 do que usa o controle manual de DataServiceCollection<T> alterações. Ao usar o acompanhamento manual, você deve implementar INotifyPropertyChanged e INotifyCollectionChanged manipular os eventos de acionamento para relatar manualmente as alterações no DataServiceContext.
A IEnumerable<T> coleção de objetos fornecidos para items
geralmente é uma consulta que retorna os itens na 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 classe DataServiceCollection<T> com os delegados de método de alteração fornecidos e que usa o 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
O DataServiceContext usado para acompanhar os 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 que é chamado quando uma entidade é alterada.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Um delegado que encapsula um método que é chamado quando a coleção de entidades é alterada.
Comentários
Use esse construtor para criar um vazio DataServiceCollection<T> ao qual objetos de entidade podem ser adicionados sem executar uma consulta no serviço ou quando um IEnumerable<T> não está disponível.
Por padrão, o controle automático de alterações está habilitado para um DataServiceCollection<T>. Você pode criar uma instância do que usa o controle manual de DataServiceCollection<T> 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 manipular os eventos de acionamento 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 em uma execução de 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 DataServiceQuery<TElement> ou consulta LINQ que retorna uma coleção IEnumerable<T> de objetos usados para inicializar a coleção.
- trackingMode
- TrackingMode
Um valor TrackingMode que indica se as alterações feitas nos itens da coleção são controlados automaticamente ou não.
- entitySetName
- String
O conjunto de entidades dos objetos na coleção.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Um delegado que encapsula um método que é chamado quando uma entidade é alterada.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Um delegado que encapsula um método que é chamado quando a coleção de entidades é alterada.
Comentários
As entityChanged
funções e collectionChanged
são invocadas pelos PropertyChanged eventos e CollectionChanged , respectivamente. O entityChanged
método usa um EntityCollectionChangedParams valor e o collectionChanged
método usa um EntityChangedParams valor. Ambos os métodos devem retornar um valor booliano que indique 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 do que usa o controle manual de DataServiceCollection<T> 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 manipular os eventos de acionamento 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 em uma execução de consulta, com os delegados de método de alteração fornecidos e que usa o DataServiceContext fornecido.
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 acompanhar os itens na coleção.
- items
- IEnumerable<T>
Uma DataServiceQuery<TElement> ou consulta LINQ que retorna uma coleção IEnumerable<T> de objetos usados para inicializar a coleção.
- trackingMode
- TrackingMode
Um valor TrackingMode que indica se as alterações feitas nos itens da coleção são controlados automaticamente ou não.
- entitySetName
- String
O conjunto de entidades dos objetos na coleção.
- entityChangedCallback
- Func<EntityChangedParams,Boolean>
Um delegado que encapsula um método que é chamado quando uma entidade é alterada.
- collectionChangedCallback
- Func<EntityCollectionChangedParams,Boolean>
Um delegado que encapsula um método que é 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 do que usa o controle manual de DataServiceCollection<T> alterações. Ao usar o acompanhamento manual, você deve implementar INotifyPropertyChanged e INotifyCollectionChanged manipular os eventos de acionamento para relatar manualmente as alterações no DataServiceContext.
O DataServiceContext deve ser fornecido quando items
não é um DataServiceQuery<TElement> ou QueryOperationResponse<T> que tem uma referência a uma DataServiceContext instância.
As entityChanged
funções e collectionChanged
são invocadas pelos PropertyChanged eventos e CollectionChanged , respectivamente. O entityChanged
método usa um EntityCollectionChangedParams valor e o collectionChanged
método usa um EntityChangedParams valor. Ambos os métodos devem retornar um valor booliano que indique se o evento foi manipulado pela função . Quando o método retornar true
, o comportamento padrão ainda ocorrerá.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de