Поделиться через


DataServiceCollection<T> Конструкторы

Определение

Создает новый экземпляр класса DataServiceCollection<T>.

Перегрузки

DataServiceCollection<T>()

Создает новый экземпляр класса DataServiceCollection<T>.

DataServiceCollection<T>(IEnumerable<T>)

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса.

DataServiceCollection<T>(DataServiceContext)

Создает новый экземпляр класса DataServiceCollection<T>, использующий указанный DataServiceContext.

DataServiceCollection<T>(IEnumerable<T>, TrackingMode)

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса и с указанным режимом отслеживания.

DataServiceCollection<T>(DataServiceContext, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)

Создает новый экземпляр класса DataServiceCollection<T> с предоставленными делегатами метода изменений, который использует указанный DataServiceContext.

DataServiceCollection<T>(IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса и с указанными делегатами метода изменений.

DataServiceCollection<T>(DataServiceContext, IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams, Boolean>)

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса с указанными делегатами метода изменений и использует указанный DataServiceContext.

DataServiceCollection<T>()

Создает новый экземпляр класса DataServiceCollection<T>.

public:
 DataServiceCollection();
public DataServiceCollection ();
Public Sub New ()

Комментарии

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>. Можно создать экземпляр DataServiceCollection<T>, который использует отслеживание изменений вручную при создании экземпляра с помощью конструктора, который позволяет предоставлять значение None для TrackingMode. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.

Автоматическое отслеживание изменений начинается после загрузки элементов в коллекцию.

Применяется к

DataServiceCollection<T>(IEnumerable<T>)

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса.

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))

Параметры

items
IEnumerable<T>

Объект DataServiceQuery<TElement> или запрос LINQ, возвращающий коллекцию объектов IEnumerable<T>, используемых для инициализации этой коллекции.

Комментарии

Коллекция объектов IEnumerable<T>, предоставляемых для items, обычно представляет собой запрос, который возвращает элементы в коллекцию. При этом может поставляться любая коллекция IEnumerable<T> правильного типа.

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>. Можно создать экземпляр DataServiceCollection<T>, который использует отслеживание изменений вручную при создании экземпляра с помощью конструктора, который позволяет предоставлять значение None для TrackingMode. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.

Применяется к

DataServiceCollection<T>(DataServiceContext)

Создает новый экземпляр класса DataServiceCollection<T>, использующий указанный 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)

Параметры

context
DataServiceContext

Контекст DataServiceContext используется для отслеживания изменений объектов в коллекции.

Комментарии

Этот конструктор используется для создания пустой коллекции DataServiceCollection<T>, в которую можно добавлять объекты сущностей без выполнения запроса службы или в случае, если недоступно перечисление IEnumerable<T>.

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>. Можно создать экземпляр DataServiceCollection<T>, который использует отслеживание изменений вручную при создании экземпляра с помощью конструктора, который позволяет предоставлять значение None для TrackingMode. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.

Применяется к

DataServiceCollection<T>(IEnumerable<T>, TrackingMode)

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса и с указанным режимом отслеживания.

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)

Параметры

items
IEnumerable<T>

Объект DataServiceQuery<TElement> или запрос LINQ, возвращающий коллекцию объектов IEnumerable<T>, используемых для инициализации этой коллекции.

trackingMode
TrackingMode

Значение TrackingMode, которое указывает, будут ли автоматически отслеживаться изменения, внесенные в элементы в коллекции,

Комментарии

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>. Используйте этот конструктор классов и укажите значение None для trackingMode, чтобы создать экземпляр DataServiceCollection<T>, использующий отслеживание изменений вручную. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.

Коллекция объектов IEnumerable<T>, предоставляемых для items, обычно представляет собой запрос, который возвращает элементы в коллекцию. При этом может поставляться любая коллекция IEnumerable<T> правильного типа.

Применяется к

DataServiceCollection<T>(DataServiceContext, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)

Создает новый экземпляр класса DataServiceCollection<T> с предоставленными делегатами метода изменений, который использует указанный 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))

Параметры

context
DataServiceContext

Объект DataServiceContext, используемый для отслеживания элементов в коллекции.

entitySetName
String

Набор сущностей объектов в коллекции.

entityChangedCallback
Func<EntityChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущности.

collectionChangedCallback
Func<EntityCollectionChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущностей в коллекции.

Комментарии

Этот конструктор используется для создания пустой коллекции DataServiceCollection<T>, в которую можно добавлять объекты сущностей без выполнения запроса службы или в случае, если недоступно перечисление IEnumerable<T>.

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>. Можно создать экземпляр DataServiceCollection<T>, который использует отслеживание изменений вручную при создании экземпляра с помощью конструктора, который позволяет предоставлять значение None для TrackingMode. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.

Применяется к

DataServiceCollection<T>(IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams,Boolean>)

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса и с указанными делегатами метода изменений.

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))

Параметры

items
IEnumerable<T>

Объект DataServiceQuery<TElement> или запрос LINQ, возвращающий коллекцию объектов IEnumerable<T>, используемых для инициализации этой коллекции.

trackingMode
TrackingMode

Значение TrackingMode, которое указывает, будут ли автоматически отслеживаться изменения, внесенные в элементы в коллекции,

entitySetName
String

Набор сущностей объектов в коллекции.

entityChangedCallback
Func<EntityChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущности.

collectionChangedCallback
Func<EntityCollectionChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущностей в коллекции.

Комментарии

Функции entityChanged и collectionChanged вызываются соответственно событиями PropertyChanged и CollectionChanged. Метод entityChanged принимает значение EntityCollectionChangedParams, а метод collectionChanged принимает значение EntityChangedParams. Оба метода должны возвращать логическое значение, указывающее, было ли событие обработано функцией. Когда метод возвращает true, поведение по умолчанию по-прежнему выполняется.

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>. Можно создать экземпляр DataServiceCollection<T>, который использует отслеживание изменений вручную при создании экземпляра с помощью конструктора, который позволяет предоставлять значение None для TrackingMode. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.

Применяется к

DataServiceCollection<T>(DataServiceContext, IEnumerable<T>, TrackingMode, String, Func<EntityChangedParams,Boolean>, Func<EntityCollectionChangedParams, Boolean>)

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса с указанными делегатами метода изменений и использует указанный 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))

Параметры

context
DataServiceContext

Объект DataServiceContext, используемый для отслеживания элементов в коллекции.

items
IEnumerable<T>

Объект DataServiceQuery<TElement> или запрос LINQ, возвращающий коллекцию объектов IEnumerable<T>, используемых для инициализации этой коллекции.

trackingMode
TrackingMode

Значение TrackingMode, которое указывает, будут ли автоматически отслеживаться изменения, внесенные в элементы в коллекции,

entitySetName
String

Набор сущностей объектов в коллекции.

entityChangedCallback
Func<EntityChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущности.

collectionChangedCallback
Func<EntityCollectionChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущностей в коллекции.

Комментарии

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>. Используйте этот конструктор классов и укажите значение None для trackingMode, чтобы создать экземпляр DataServiceCollection<T>, использующий отслеживание изменений вручную. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.

DataServiceContext должен всегда предоставляться, если items не является DataServiceQuery<TElement> или QueryOperationResponse<T>, ссылающимся на экземпляр DataServiceContext.

Функции entityChanged и collectionChanged вызываются соответственно событиями PropertyChanged и CollectionChanged. Метод entityChanged принимает значение EntityCollectionChangedParams, а метод collectionChanged принимает значение EntityChangedParams. Оба метода должны возвращать логическое значение, указывающее, было ли событие обработано функцией. Когда метод возвращает true, поведение по умолчанию по-прежнему будет выполняться.

Применяется к