Share via

EntityList<TEntity>.InsertOnSubmit Method

  • Article

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: TEntity

    The 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

EntityList<TEntity> Class

EntityList<TEntity> Members

Microsoft.SharePoint.Linq Namespace

Other Resources

How to: Write to Lists Using LINQ to SharePoint