DataServiceCollection<T> 建構函式

定義

命名空間:

System.Data.Services.Client

組件:

System.Data.Services.Client.dll

建立 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回 時，仍會發生預設行為。