DataServiceCollection<T> Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает новый экземпляр класса DataServiceCollection<T>.
Перегрузки
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, поведение по умолчанию по-прежнему будет выполняться.
