DataServiceContext.AttachTo メソッド

定義

名前空間:
System.Data.Services.Client
アセンブリ:
System.Data.Services.Client.dll

指定したリソースの追跡を開始するように DataServiceContext に通知し、指定したリソース セット内のリソースの場所を指定します。

オーバーロード

名前 説明
AttachTo(String, Object)

指定したリソースの追跡を開始するように DataServiceContext に通知し、指定したリソース セット内のリソースの場所を指定します。
AttachTo(String, Object, String)

指定したリソースの追跡を開始するように DataServiceContext に通知し、指定したリソース セット内のリソースの場所を指定します。

AttachTo(String, Object)

指定したリソースの追跡を開始するように DataServiceContext に通知し、指定したリソース セット内のリソースの場所を指定します。

public:
 void AttachTo(System::String ^ entitySetName, System::Object ^ entity);
public void AttachTo(string entitySetName, object entity);
member this.AttachTo : string * obj -> unit
Public Sub AttachTo (entitySetName As String, entity As Object)

パラメーター

entitySetName
String

リソースを含むセットの名前。

entity
Object

DataServiceContextによって追跡されるリソース。 リソースは変更されていない状態でアタッチされます。

例外

ArgumentNullException

entity または entitySetName が null。

ArgumentException

entitySetName は空の文字列です。

-または-

entity にはキー プロパティが定義されていません。

InvalidOperationException

entity は既にコンテキストによって追跡されています。

注釈

エンティティがオブジェクト グラフの一部である場合、この操作はグラフを走査して関連オブジェクトを追加しません。 浅い動作です。

このメソッドは、指定したエンティティ セットが、 DataServiceContextに関連付けられているデータ サービス内で発生するかどうかを検証しません。

適用対象

AttachTo(String, Object, String)

指定したリソースの追跡を開始するように DataServiceContext に通知し、指定したリソース セット内のリソースの場所を指定します。

public:
 void AttachTo(System::String ^ entitySetName, System::Object ^ entity, System::String ^ etag);
public void AttachTo(string entitySetName, object entity, string etag);
member this.AttachTo : string * obj * string -> unit
Public Sub AttachTo (entitySetName As String, entity As Object, etag As String)

パラメーター

entitySetName
String

エンティティがアタッチされるエンティティ セットの名前を含む文字列値。

entity
Object

追加するエンティティ。

etag
String

データ サービスから最後に取得されたエンティティの状態を表す etag 値。 この値は不透明な文字列として扱われます。クライアント ライブラリによって検証は実行されません。

例外

ArgumentNullException

entitySetName は nullです。

-または-

entity は nullです。

ArgumentException

entitySetName は空の文字列です。

-または-

指定されたオブジェクトには、キー プロパティがありません。

InvalidOperationException

指定されたオブジェクトは、コンテキストによって既に追跡されています。

注釈

このメソッドを呼び出すと、指定したエンティティの追跡を開始するように DataServiceContext に通知し、エンティティが属するエンティティ セットを識別します。

エンティティがオブジェクト グラフの一部である場合、この操作はグラフを走査して関連オブジェクトを追加しません。 オブジェクトは、変更されていない状態で DataServiceContext に追加されます。 このメソッドは、指定されたエンティティ セットが、 DataServiceContextに関連付けられているデータ サービスで発生するかどうかを検証しません。

etag を持つオーバーロードが使用される場合、指定した etag は新しくアタッチされたエンティティに関連付けられます。 その後、HTTP セマンティクスに従って、エンティティの後続のすべての更新操作またはクエリ操作で、etag がデータ サービスに送信されます。 etag 値を手動で生成することはお勧めしませんが、このオーバーロードは、シリアル化および格納された可能性があるエンティティを関連するコンカレンシー メタデータと共に再アタッチできるようにするために提供されます。

適用対象