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> コレクションを返すIEnumerable<T>または LINQ クエリ。
注釈
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> コレクションを返すIEnumerable<T>または LINQ クエリ。
- 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> クラス a の新しいインスタンスを作成します。
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> コレクションを返すIEnumerable<T>または LINQ クエリ。
- 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> クラス a の新しいインスタンスを作成し、指定された 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> コレクションを返すIEnumerable<T>または LINQ クエリ。
- 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を返しても、既定の動作が引き続き発生します。
