DataServiceContext.AttachTo メソッド

定義

指定されたリソースの追跡を開始するように 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 によって追跡されるリソース。 このリソースは、変更なしの状態でアタッチされます。

例外

entity または entitySetNamenull です。

entitySetName が空の文字列です。

または

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

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 値。 この値は不透明な文字列として扱われ、クライアント ライブラリはこの値を検証しません。

例外

entitySetNamenull です。

または

entitynull です。

entitySetName が空の文字列です。

または

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

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

注釈

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

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

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

適用対象