DataServiceCollection<T> 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
建立 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
回 時,仍會發生預設行為。