EntityList<TEntity>.InsertOnSubmit 方法

项目
05/13/2015

将标记插入到列表上的下一个调用SubmitChanges()指定的实体。

命名空间： Microsoft.SharePoint.Linq
程序集： Microsoft.SharePoint.Linq（位于 Microsoft.SharePoint.Linq.dll 中）

语法

声明
Public Sub InsertOnSubmit ( _
    entity As TEntity _
)
用法
Dim instance As EntityList
Dim entity As TEntity

instance.InsertOnSubmit(entity)

public void InsertOnSubmit(
    TEntity entity
)

参数

entity
类型：TEntity

要标记为插入实体。

异常

异常	条件
ArgumentNullException	entity是空引用（无在 Visual Basic 中）。
InvalidOperationException	DataContext对象未启用跟踪的对象。 - 或者 - entity不是相同类型的列表项。 - 或者 - entity已被删除。 - 或者 - entity已被更新。 - 或者 - 没有entity ，由跟踪系统的对象的内部 ID 问题。

ArgumentNullException

entity是空引用（无在 Visual Basic 中）。

InvalidOperationException

DataContext对象未启用跟踪的对象。

- 或者 -

entity不是相同类型的列表项。

- 或者 -

entity已被删除。

- 或者 -

entity已被更新。

- 或者 -

没有entity ，由跟踪系统的对象的内部 ID 问题。

备注

entity通常为列表项，但它可以是一个分离的实体列表项类型相同。

示例

以下是在使用InsertOnSubmit(TEntity)的一个示例：

// Create the new list item.
TeamMember bob = new TeamMember() { Title=”Bob Smith” };

// Set the item to be inserted.
teamSite.TeamMembers.InsertOnSubmit(bob);

// Write changes to the content database.
teamSite.SubmitChanges();

// Try-catch blocks omitted for readability.

' Create the new list item.
Dim bob As New TeamMember() With {.Title="Bob Smith"}

' Set the item to be inserted.
teamSite.TeamMembers. InsertOnSubmit(bob)

' Write changes to the content database.
teamSite.SubmitChanges()

' Try-catch blocks omitted for readability.