EntityList<TEntity>.InsertOnSubmit Method
Marks the specified entity for insertion into the list on the next call of SubmitChanges().
Namespace: Microsoft.SharePoint.Linq
Assembly: Microsoft.SharePoint.Linq (in Microsoft.SharePoint.Linq.dll)
Syntax
'Declaration
Public Sub InsertOnSubmit ( _
entity As TEntity _
)
'Usage
Dim instance As EntityList
Dim entity As TEntity
instance.InsertOnSubmit(entity)
public void InsertOnSubmit(
TEntity entity
)
Parameters
entity
Type: TEntityThe entity to be marked for insertion.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | entity is a null reference (Nothing in Visual Basic). |
| InvalidOperationException | Object tracking is not enabled for the DataContext object. - or - entity is not of the same type as the list items. - or - entity has been deleted. - or - entity has been updated. - or - There is a problem with the internal ID of entity that is used by the object tracking system. |
Remarks
entity is usually a list item, but it can be a detached entity of the same type as the list items.
Examples
The following is an example of InsertOnSubmit(TEntity) in use:
// 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.
See Also
Reference
Microsoft.SharePoint.Linq Namespace