Share via


DataServiceCollection<T> Construtores

Definição

Cria uma nova instância da classe DataServiceCollection<T>.

Sobrecargas

DataServiceCollection<T>()

Cria uma nova instância da classe DataServiceCollection<T>.

DataServiceCollection<T>(IEnumerable<T>)

Cria uma nova instância da classe DataServiceCollection<T> com base na execução de consulta.

DataServiceCollection<T>(DataServiceContext)

Cria uma nova instância da classe DataServiceCollection<T> que usa o DataServiceContext especificado.

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.

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.

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.

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.

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