DataServiceContext.AttachTo メソッド (String, Object, String)

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

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

構文

'宣言
Public Sub AttachTo ( _
    entitySetName As String, _
    entity As Object, _
    etag As String _
)
'使用
Dim instance As DataServiceContext
Dim entitySetName As String
Dim entity As Object
Dim etag As String

instance.AttachTo(entitySetName, entity, _
    etag)

public void AttachTo(
    string entitySetName,
    Object entity,
    string etag
)

public:
void AttachTo(
    String^ entitySetName, 
    Object^ entity, 
    String^ etag
)

member AttachTo : 
        entitySetName:string * 
        entity:Object * 
        etag:string -> unit 

public function AttachTo(
    entitySetName : String, 
    entity : Object, 
    etag : String
)

パラメーター

• entitySetName
  型: System.String
  エンティティがアタッチされるエンティティ セットの名前を含む文字列値。

• entity
  型: System.Object
  追加するエンティティ。

• etag
  型: System.String
  最後にデータ サービスから受信されたときのエンティティの状態を表す etag 値。この値は不透明な文字列として扱われ、クライアント ライブラリはこの値を検証しません。

例外

例外	条件
ArgumentNullException	entitySetName が nullNULL 参照 (Visual Basic では Nothing) の場合。 または entity が nullNULL 参照 (Visual Basic では Nothing) の場合。
ArgumentException	entitySetName が空の文字列である場合。 または 指定されたオブジェクトにキー プロパティがない場合。
InvalidOperationException	指定されたオブジェクトがコンテキストによって既に追跡されている場合。

説明

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

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

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

関連項目

参照

DataServiceContext クラス

AttachTo オーバーロード

System.Data.Services.Client 名前空間