DataServiceContext.AddObject 方法
将指定对象添加到 DataServiceContext 正在跟踪的一组对象中。
命名空间: System.Data.Services.Client
程序集: Microsoft.Data.Services.Client(在 Microsoft.Data.Services.Client.dll 中)
语法
声明
Public Sub AddObject ( _
entitySetName As String, _
entity As Object _
)
用法
Dim instance As DataServiceContext
Dim entitySetName As String
Dim entity As Object
instance.AddObject(entitySetName, entity)
public void AddObject(
string entitySetName,
Object entity
)
public:
void AddObject(
String^ entitySetName,
Object^ entity
)
member AddObject :
entitySetName:string *
entity:Object -> unit
public function AddObject(
entitySetName : String,
entity : Object
)
参数
- entitySetName
类型:System.String
将要向其添加资源的实体集的名称。
- entity
类型:System.Object
将由 DataServiceContext 跟踪的对象。
异常
异常 | 条件 |
---|---|
ArgumentNullException | 当 entitySetName 或 entity 为 null 时。 |
ArgumentException | 当 entitySetName 为空时。 - 或 - 当 entity 未定义键属性时。 |
InvalidOperationException | 当该实体已由上下文跟踪时。 |
注释
将该对象放入处于 Added 状态的 DataServiceContext 的跟踪集中。 下次调用 SaveChanges 时,DataServiceContext 将尝试通过 HTTP POST 插入该对象。 此方法不会将与指定实体相关的对象添加到 DataServiceContext。 必须单独调用 AddObject 才能添加每个对象。
该方法无法验证指定的实体集是否存在于与 DataServiceContext 关联的数据服务中,也无法验证添加的对象是否具有必需的属性,以便将其添加到指定的实体集。