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 值，但可提供此重载以启用实体，这些实体可能已序列化并已进行存储，目的是将其与相关并发元数据重新附加到一起。