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 は、新しくアタッチされたエンティティに関連付けられます。 その後、この etag は、HTTP セマンティクスに従って、エンティティに対する後続のすべての更新操作またはクエリ操作と共に、データ サービスに送信されます。 etag 値を手動で生成することはお勧めできませんが、このオーバーロードは、シリアル化および格納されているエンティティを、関連するコンカレンシー メタデータと共に再アタッチできるように提供されています。