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

Определение

Создает новый экземпляр класса DataServiceCollection<T>.Creates a new instance of the DataServiceCollection<T> class.

Перегрузки

DataServiceCollection<T>()

Создает новый экземпляр класса DataServiceCollection<T>.Creates a new instance of the DataServiceCollection<T> class.

DataServiceCollection<T>(IEnumerable<T>)

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса.Creates a new instance of the DataServiceCollection<T> class based on query execution.

DataServiceCollection<T>(DataServiceContext)

Создает новый экземпляр класса DataServiceCollection<T>, использующий указанный DataServiceContext.Creates a new instance of the DataServiceCollection<T> class that uses the specified DataServiceContext.

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

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса и с указанным режимом отслеживания.Creates a new instance of the DataServiceCollection<T> class based on query execution and with the specified tracking mode.

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

Создает новый экземпляр класса DataServiceCollection<T> с предоставленными делегатами метода изменений, который использует указанный DataServiceContext.Creates a new instance of the DataServiceCollection<T> class with the supplied change method delegates and that uses the specified DataServiceContext.

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

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса и с указанными делегатами метода изменений.Creates a new instance of the DataServiceCollection<T> class a based on query execution and with the supplied change method delegates.

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

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса с указанными делегатами метода изменений и использует указанный DataServiceContext.Creates a new instance of the DataServiceCollection<T> class a based on query execution, with the supplied change method delegates, and that uses the supplied DataServiceContext.

DataServiceCollection<T>()

Создает новый экземпляр класса DataServiceCollection<T>.Creates a new instance of the DataServiceCollection<T> class.

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

Комментарии

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>.By default, automatic change tracking is enabled for a DataServiceCollection<T>. Можно создать экземпляр DataServiceCollection<T>, который использует отслеживание изменений вручную при создании экземпляра с помощью конструктора, который позволяет предоставлять значение None для TrackingMode.You can create an instance of DataServiceCollection<T> that uses manual change tracking when you create an instance using a constructor that enables you to supply a value of None for TrackingMode. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.When you use manual tracking, you must implement INotifyPropertyChanged and INotifyCollectionChanged and handle the raise events to manually report changes to the DataServiceContext.

Автоматическое отслеживание изменений начинается после загрузки элементов в коллекцию.Automatic change tracking begins after items are loaded into the collection.

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

DataServiceCollection<T>(IEnumerable<T>)

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса.Creates a new instance of the DataServiceCollection<T> class based on query execution.

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>, которые используются для инициализации коллекции.A DataServiceQuery<TElement> or LINQ query that returns an IEnumerable<T> collection of objects that are used to initialize the collection.

Комментарии

Коллекция объектов IEnumerable<T>, предоставляемых для items, обычно представляет собой запрос, который возвращает элементы в коллекцию.The IEnumerable<T> collection of objects supplied for items is usually a query that returns the items in the collection. При этом может поставляться любая коллекция IEnumerable<T> правильного типа.However, any IEnumerable<T> collection of the correct type can be supplied.

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>.By default, automatic change tracking is enabled for a DataServiceCollection<T>. Можно создать экземпляр DataServiceCollection<T>, который использует отслеживание изменений вручную при создании экземпляра с помощью конструктора, который позволяет предоставлять значение None для TrackingMode.You can create an instance of DataServiceCollection<T> that uses manual change tracking when you create an instance using a constructor that enables you to supply a value of None for TrackingMode. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.When you use manual tracking, you must implement INotifyPropertyChanged and INotifyCollectionChanged and handle the raise events to manually report changes to the DataServiceContext.

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

DataServiceCollection<T>(DataServiceContext)

Создает новый экземпляр класса DataServiceCollection<T>, использующий указанный DataServiceContext.Creates a new instance of the DataServiceCollection<T> class that uses the specified 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 используется для отслеживания изменений объектов в коллекции.The DataServiceContext used to track changes to objects in the collection.

Комментарии

Этот конструктор используется для создания пустой коллекции DataServiceCollection<T>, в которую можно добавлять объекты сущностей без выполнения запроса службы или в случае, если недоступно перечисление IEnumerable<T>.Use this constructor to create an empty DataServiceCollection<T> to which entity objects can be added without executing a query against the service or when an IEnumerable<T> is not available.

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>.By default, automatic change tracking is enabled for a DataServiceCollection<T>. Можно создать экземпляр DataServiceCollection<T>, который использует отслеживание изменений вручную при создании экземпляра с помощью конструктора, который позволяет предоставлять значение None для TrackingMode.You can create an instance of DataServiceCollection<T> that uses manual change tracking when you create an instance using a constructor that enables you to supply a value of None for TrackingMode. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.When you use manual tracking, you must implement INotifyPropertyChanged and INotifyCollectionChanged and handle the raise events to manually report changes to the DataServiceContext.

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

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

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса и с указанным режимом отслеживания.Creates a new instance of the DataServiceCollection<T> class based on query execution and with the specified tracking mode.

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>, используемых для инициализации этой коллекции.A DataServiceQuery<TElement> or LINQ query that returns an IEnumerable<T> collection of objects that are used to initialize the collection.

trackingMode
TrackingMode

Значение TrackingMode, которое указывает, будут ли автоматически отслеживаться изменения, внесенные в элементы в коллекции,A TrackingMode value that indicated whether or not changes made to items in the collection are automatically tracked.

Комментарии

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>.By default, automatic change tracking is enabled for a DataServiceCollection<T>. Используйте этот конструктор классов и укажите значение None для trackingMode, чтобы создать экземпляр DataServiceCollection<T>, использующий отслеживание изменений вручную.Use this class constructor and supply a value of None for trackingMode to create an instance of DataServiceCollection<T> that uses manual change tracking. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.When you use manual tracking, you must implement INotifyPropertyChanged and INotifyCollectionChanged and handle the raise events to manually report changes to the DataServiceContext.

Коллекция объектов IEnumerable<T>, предоставляемых для items, обычно представляет собой запрос, который возвращает элементы в коллекцию.The IEnumerable<T> collection of objects supplied for items is usually a query that returns the items in the collection. При этом может поставляться любая коллекция IEnumerable<T> правильного типа.However, any IEnumerable<T> collection of the correct type can be supplied.

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

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

Создает новый экземпляр класса DataServiceCollection<T> с предоставленными делегатами метода изменений, который использует указанный DataServiceContext.Creates a new instance of the DataServiceCollection<T> class with the supplied change method delegates and that uses the specified 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, используемый для отслеживания элементов в коллекции.The DataServiceContext used to track items in the collection.

entitySetName
String

Набор сущностей объектов в коллекции.The entity set of the objects in the collection.

entityChangedCallback
Func<EntityChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущности.A delegate that encapsulates a method that is called when an entity changes.

collectionChangedCallback
Func<EntityCollectionChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущностей в коллекции.A delegate that encapsulates a method that is called when the collection of entities changes.

Комментарии

Этот конструктор используется для создания пустой коллекции DataServiceCollection<T>, в которую можно добавлять объекты сущностей без выполнения запроса службы или в случае, если недоступно перечисление IEnumerable<T>.Use this constructor to create an empty DataServiceCollection<T> to which entity objects can be added without executing a query against the service or when an IEnumerable<T> is not available.

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>.By default, automatic change tracking is enabled for a DataServiceCollection<T>. Можно создать экземпляр DataServiceCollection<T>, который использует отслеживание изменений вручную при создании экземпляра с помощью конструктора, который позволяет предоставлять значение None для TrackingMode.You can create an instance of DataServiceCollection<T> that uses manual change tracking when you create an instance using a constructor that enables you to supply a value of None for TrackingMode. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.When you use manual tracking, you must implement INotifyPropertyChanged and INotifyCollectionChanged and handle the raise events to manually report changes to the DataServiceContext.

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

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

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса и с указанными делегатами метода изменений.Creates a new instance of the DataServiceCollection<T> class a based on query execution and with the supplied change method delegates.

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>, используемых для инициализации этой коллекции.A DataServiceQuery<TElement> or LINQ query that returns an IEnumerable<T> collection of objects that are used to initialize the collection.

trackingMode
TrackingMode

Значение TrackingMode, которое указывает, будут ли автоматически отслеживаться изменения, внесенные в элементы в коллекции,A TrackingMode value that indicated whether or not changes made to items in the collection are automatically tracked.

entitySetName
String

Набор сущностей объектов в коллекции.The entity set of the objects in the collection.

entityChangedCallback
Func<EntityChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущности.A delegate that encapsulates a method that is called when an entity changes.

collectionChangedCallback
Func<EntityCollectionChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущностей в коллекции.A delegate that encapsulates a method that is called when the collection of entities changes.

Комментарии

Функции entityChanged и collectionChanged вызываются соответственно событиями PropertyChanged и CollectionChanged.The entityChanged and collectionChanged functions are invoked by the PropertyChanged and CollectionChanged events, respectively. Метод entityChanged принимает значение EntityCollectionChangedParams, а метод collectionChanged принимает значение EntityChangedParams.The entityChanged method takes an EntityCollectionChangedParams value and the collectionChanged method takes a EntityChangedParams value. Оба метода должны возвращать логическое значение, указывающее, было ли событие обработано функцией.Both methods must return a Boolean value that indicates whether the event was handled by the function. При возврате из метода по true -прежнему происходит поведение по умолчанию.When the method returns true, the default behavior still occurs.

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>.By default, automatic change tracking is enabled for a DataServiceCollection<T>. Можно создать экземпляр DataServiceCollection<T>, который использует отслеживание изменений вручную при создании экземпляра с помощью конструктора, который позволяет предоставлять значение None для TrackingMode.You can create an instance of DataServiceCollection<T> that uses manual change tracking when you create an instance using a constructor that enables you to supply a value of None for TrackingMode. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.When you use manual tracking, you must implement INotifyPropertyChanged and INotifyCollectionChanged and handle the raise events to manually report changes to the DataServiceContext.

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

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

Создает новый экземпляр класса DataServiceCollection<T> на основе выполнения запроса с указанными делегатами метода изменений и использует указанный DataServiceContext.Creates a new instance of the DataServiceCollection<T> class a based on query execution, with the supplied change method delegates, and that uses the supplied 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, используемый для отслеживания элементов в коллекции.The DataServiceContext used to track items in the collection.

items
IEnumerable<T>

Объект DataServiceQuery<TElement> или запрос LINQ, возвращающий коллекцию объектов IEnumerable<T>, используемых для инициализации этой коллекции.A DataServiceQuery<TElement> or LINQ query that returns an IEnumerable<T> collection of objects that are used to initialize the collection.

trackingMode
TrackingMode

Значение TrackingMode, которое указывает, будут ли автоматически отслеживаться изменения, внесенные в элементы в коллекции,A TrackingMode value that indicated whether or not changes made to items in the collection are automatically tracked.

entitySetName
String

Набор сущностей объектов в коллекции.The entity set of the objects in the collection.

entityChangedCallback
Func<EntityChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущности.A delegate that encapsulates a method that is called when an entity changes.

collectionChangedCallback
Func<EntityCollectionChangedParams,Boolean>

Делегат, инкапсулирующий метод, который вызывается при изменении сущностей в коллекции.A delegate that encapsulates a method that is called when the collection of entities changes.

Комментарии

По умолчанию автоматическое отслеживание изменений включено для DataServiceCollection<T>.By default, automatic change tracking is enabled for a DataServiceCollection<T>. Используйте этот конструктор классов и укажите значение None для trackingMode, чтобы создать экземпляр DataServiceCollection<T>, использующий отслеживание изменений вручную.Use this class constructor to supply a value of None for trackingMode to create an instance of DataServiceCollection<T> that uses manual change tracking. При использовании отслеживания вручную необходимо реализовать INotifyPropertyChanged и INotifyCollectionChanged и обрабатывать вызываемые события, предоставляя вручную отчеты об изменениях в DataServiceContext.When you use manual tracking, you must implement INotifyPropertyChanged and INotifyCollectionChanged and handle the raise events to manually report changes to the DataServiceContext.

DataServiceContext должен всегда предоставляться, если items не является DataServiceQuery<TElement> или QueryOperationResponse<T>, ссылающимся на экземпляр DataServiceContext.The DataServiceContext must be supplied when items is not a DataServiceQuery<TElement> or QueryOperationResponse<T> that has a reference to a DataServiceContext instance.

Функции entityChanged и collectionChanged вызываются соответственно событиями PropertyChanged и CollectionChanged.The entityChanged and collectionChanged functions are invoked by the PropertyChanged and CollectionChanged events, respectively. Метод entityChanged принимает значение EntityCollectionChangedParams, а метод collectionChanged принимает значение EntityChangedParams.The entityChanged method takes an EntityCollectionChangedParams value and the collectionChanged method takes a EntityChangedParams value. Оба метода должны возвращать логическое значение, указывающее, было ли событие обработано функцией.Both methods must return a Boolean value that indicates whether the event was handled by the function. Когда метод возвращает значение true , поведение по умолчанию будет по-прежнему происходить.When the method returns true, the default behavior will still occur.

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