Interface IListItem

Public interface to define a SharePoint Online list item

Inherited Members
Namespace: PnP.Core.Model.SharePoint
Assembly: PnP.Core.dll
Syntax
public interface IListItem : IDataModel<IListItem>, IDataModelParent, IDataModelWithContext, ISupportModules<IListItem>, IDataModelGet<IListItem>, IDataModelLoad<IListItem>, IDataModelUpdate, IDataModelDelete, IDataModelSupportingGetChanges, ISecurableObject, IExpandoDataModel, IQueryableDataModel

Properties

All

A special property used to add an asterisk to a $select statement

Declaration
object All { get; }
Property Value
System.Object

AttachmentFiles

Collection of attachments for this list item Implements .
See Requesting model collections and IQueryable performance considerations to learn more.

Declaration
IAttachmentCollection AttachmentFiles { get; }
Property Value
IAttachmentCollection

CommentsDisabled

Determines if comments are disabled for the list item

Declaration
bool CommentsDisabled { get; }
Property Value
System.Boolean

CommentsDisabledScope

The scope for which comments are disabled

Declaration
CommentsDisabledScope CommentsDisabledScope { get; }
Property Value
CommentsDisabledScope

ContentType

The content type for the list item

Declaration
IContentType ContentType { get; }
Property Value
IContentType

FieldValuesAsHtml

All the field values for the list item as HTML

Declaration
IFieldStringValues FieldValuesAsHtml { get; }
Property Value
IFieldStringValues

FieldValuesAsText

All the field values for the list item as text

Declaration
IFieldStringValues FieldValuesAsText { get; }
Property Value
IFieldStringValues

FieldValuesForEdit

All the field values for the list item for editing

Declaration
IFieldStringValues FieldValuesForEdit { get; }
Property Value
IFieldStringValues

File

The file, if any, associated with the list item

Declaration
IFile File { get; }
Property Value
IFile

FileSystemObjectType

The FileSystemObjectType for the list item, such as Folder or File

Declaration
FileSystemObjectType FileSystemObjectType { get; }
Property Value
FileSystemObjectType

Folder

The folder, if any, represented by the list item

Declaration
IFolder Folder { get; }
Property Value
IFolder

Id

Id of the list item

Declaration
int Id { get; }
Property Value
System.Int32

LikedByInformation

Information about the likes on this list item

Declaration
ILikedByInformation LikedByInformation { get; }
Property Value
ILikedByInformation

ParentList

The list for the list item

Declaration
IList ParentList { get; }
Property Value
IList

Properties

The properties of the list item

Declaration
IPropertyValues Properties { get; }
Property Value
IPropertyValues

ServerRedirectedEmbedUri

The URI used to render the WOPI (Web Application Open Platform Interface) frame

Declaration
string ServerRedirectedEmbedUri { get; }
Property Value
System.String

ServerRedirectedEmbedUrl

The URL used to render the WOPI (Web Application Open Platform Interface) frame

Declaration
string ServerRedirectedEmbedUrl { get; }
Property Value
System.String

Title

Title value of the list item

Declaration
string Title { get; set; }
Property Value
System.String

UniqueId

The unique identifier of the list item

Declaration
Guid UniqueId { get; }
Property Value
Guid

Versions

Gets a value that returns a collection of list item version objects that represent the versions of the list item Implements .
See Requesting model collections and IQueryable performance considerations to learn more.

Declaration
IListItemVersionCollection Versions { get; }
Property Value
IListItemVersionCollection

Methods

AreCommentsDisabled()

Are comments disabled for this IListItem?

Declaration
bool AreCommentsDisabled()
Returns
System.Boolean

True if disabled, false otherwise

AreCommentsDisabledAsync()

Are comments disabled for this IListItem?

Declaration
Task<bool> AreCommentsDisabledAsync()
Returns
Task<System.Boolean>

True if disabled, false otherwise

CheckIfUserHasPermissions(String, PermissionKind)

Checks if a user has a specific kind of permissions to a listitem

Declaration
bool CheckIfUserHasPermissions(string userPrincipalName, PermissionKind permissionKind)
Parameters
System.String userPrincipalName

Login name of the user you wish to check if he has a specific permission
PermissionKind permissionKind

Permission kind to check
Returns
System.Boolean

Boolean that says if the user has permissions or not

CheckIfUserHasPermissionsAsync(String, PermissionKind)

Checks if a user has a specific kind of permissions to a listitem

Declaration
Task<bool> CheckIfUserHasPermissionsAsync(string userPrincipalName, PermissionKind permissionKind)
Parameters
System.String userPrincipalName

Login name of the user you wish to check if he has a specific permission
PermissionKind permissionKind

Permission kind to check
Returns
Task<System.Boolean>

Boolean that says if the user has permissions or not

CreateAnonymousSharingLink(AnonymousLinkOptions)

Creates an anonymous sharing link for a list item

Declaration
IGraphPermission CreateAnonymousSharingLink(AnonymousLinkOptions anonymousLinkOptions)
Parameters
AnonymousLinkOptions anonymousLinkOptions

Returns
IGraphPermission

Permission that has been created

CreateAnonymousSharingLinkAsync(AnonymousLinkOptions)

Creates an anonymous sharing link for a list item

Declaration
Task<IGraphPermission> CreateAnonymousSharingLinkAsync(AnonymousLinkOptions anonymousLinkOptions)
Parameters
AnonymousLinkOptions anonymousLinkOptions

Returns
Task<IGraphPermission>

Permission that has been created

CreateOrganizationalSharingLink(OrganizationalLinkOptions)

Creates an organization sharing link for a list item

Declaration
IGraphPermission CreateOrganizationalSharingLink(OrganizationalLinkOptions organizationalLinkOptions)
Parameters
OrganizationalLinkOptions organizationalLinkOptions

Returns
IGraphPermission

Permission that has been created

CreateOrganizationalSharingLinkAsync(OrganizationalLinkOptions)

Creates an organization sharing link for a list item

Declaration
Task<IGraphPermission> CreateOrganizationalSharingLinkAsync(OrganizationalLinkOptions organizationalLinkOptions)
Parameters
OrganizationalLinkOptions organizationalLinkOptions

Returns
Task<IGraphPermission>

Permission that has been created

CreateUserSharingLink(UserLinkOptions)

Creates a user sharing link for a list item

Declaration
IGraphPermission CreateUserSharingLink(UserLinkOptions userLinkOptions)
Parameters
UserLinkOptions userLinkOptions

Returns
IGraphPermission

Permission that has been created

CreateUserSharingLinkAsync(UserLinkOptions)

Creates a user sharing link for a list item

Declaration
Task<IGraphPermission> CreateUserSharingLinkAsync(UserLinkOptions userLinkOptions)
Parameters
UserLinkOptions userLinkOptions

Returns
Task<IGraphPermission>

Permission that has been created

GetComments(Expression<Func<IComment, Object>>[])

Get list item comments

Declaration
ICommentCollection GetComments(params Expression<Func<IComment, object>>[] selectors)
Parameters
Expression<Func<IComment, System.Object>>[] selectors

The expressions declaring the fields to select
Returns
ICommentCollection

GetCommentsAsync(Expression<Func<IComment, Object>>[])

Get list item comments

Declaration
Task<ICommentCollection> GetCommentsAsync(params Expression<Func<IComment, object>>[] selectors)
Parameters
Expression<Func<IComment, System.Object>>[] selectors

The expressions declaring the fields to select
Returns
Task<ICommentCollection>

GetDisplayName()

Gets the display name of the list item.

Declaration
string GetDisplayName()
Returns
System.String

The display name or null.

GetDisplayNameAsync()

Gets the display name of the list item.

Declaration
Task<string> GetDisplayNameAsync()
Returns
Task<System.String>

The display name or null.

GetParentFolder()

Returns the IFolder that holds this item

Declaration
IFolder GetParentFolder()
Returns
IFolder

The IFolder for this item is returned, if the item itself is a folder then the item is returned as IFolder.

GetParentFolderAsync()

Returns the IFolder that holds this item

Declaration
Task<IFolder> GetParentFolderAsync()
Returns
Task<IFolder>

The IFolder for this item is returned, if the item itself is a folder then the item is returned as IFolder.

GetUserEffectivePermissions(String)

Gets the user effective permissions of a user for a listitem

Declaration
IBasePermissions GetUserEffectivePermissions(string userPrincipalName)
Parameters
System.String userPrincipalName

Login name of the user you wish to retrieve the permissions of
Returns
IBasePermissions

Base permissions object that contains the High and the Low permissions

GetUserEffectivePermissionsAsync(String)

Gets the user effective permissions of a user for a listitem

Declaration
Task<IBasePermissions> GetUserEffectivePermissionsAsync(string userPrincipalName)
Parameters
System.String userPrincipalName

Login name of the user you wish to retrieve the permissions of
Returns
Task<IBasePermissions>

Base permissions object that contains the High and the Low permissions

IsFile()

Checks if this IListItem is a file

Declaration
bool IsFile()
Returns
System.Boolean

Returns true if this IListItem is a file.

IsFileAsync()

Checks if this IListItem is a file

Declaration
Task<bool> IsFileAsync()
Returns
Task<System.Boolean>

Returns true if this IListItem is a file.

IsFolder()

Checks if this IListItem is a folder

Declaration
bool IsFolder()
Returns
System.Boolean

Returns true if this IListItem is a folder.

IsFolderAsync()

Checks if this IListItem is a folder

Declaration
Task<bool> IsFolderAsync()
Returns
Task<System.Boolean>

Returns true if this IListItem is a folder.

MoveTo(String)

Moves this ListItem to another folder in this list

Declaration
void MoveTo(string destinationFolderUrl)
Parameters
System.String destinationFolderUrl

Folder path within this list, e.g. 'subfolder1/subfolder2'

MoveToAsync(String)

Moves this ListItem to another folder in this list

Declaration
Task MoveToAsync(string destinationFolderUrl)
Parameters
System.String destinationFolderUrl

Folder path within this list, e.g. 'subfolder1/subfolder2'
Returns
Task

NewFieldLookupValue(IField, Int32)

Creates a new IFieldLookupValue object

Declaration
IFieldLookupValue NewFieldLookupValue(IField fieldToUpdate, int lookupId)
Parameters
IField fieldToUpdate

IField representing the field to set
System.Int32 lookupId

Id of the lookup value
Returns
IFieldLookupValue

Configured IFieldLookupValue object

NewFieldTaxonomyValue(IField, Guid, String, Int32)

Creates a new IFieldTaxonomyValue object

Declaration
IFieldTaxonomyValue NewFieldTaxonomyValue(IField fieldToUpdate, Guid termId, string label, int wssId = null)
Parameters
IField fieldToUpdate

IField representing the field to set
Guid termId

Name of the term to set
System.String label

Label of the term to set
System.Int32 wssId

Optionally provide the wssId value
Returns
IFieldTaxonomyValue

Configured IFieldTaxonomyValue object

NewFieldUrlValue(IField, String, String)

Creates a new IFieldUrlValue object

Declaration
IFieldUrlValue NewFieldUrlValue(IField fieldToUpdate, string url, string description = null)
Parameters
IField fieldToUpdate

IField representing the field to set
System.String url

Url value
System.String description

Optional description value
Returns
IFieldUrlValue

Configured IFieldUrlValue object

NewFieldUserValue(IField, ISharePointPrincipal)

Creates a new IFieldUserValue object

Declaration
IFieldUserValue NewFieldUserValue(IField fieldToUpdate, ISharePointPrincipal principal)
Parameters
IField fieldToUpdate

IField representing the field to set
ISharePointPrincipal principal

ISharePointUser or ISharePointGroup
Returns
IFieldUserValue

Configured IFieldUserValue object

NewFieldUserValue(IField, Int32)

Creates a new IFieldUserValue object

Declaration
IFieldUserValue NewFieldUserValue(IField fieldToUpdate, int userId)
Parameters
IField fieldToUpdate

IField representing the field to set
System.Int32 userId

Id of the user
Returns
IFieldUserValue

Configured IFieldUserValue object

NewFieldValueCollection(IField)

Creates a new collection to hold IFieldValue objects

Declaration
IFieldValueCollection NewFieldValueCollection(IField fieldToUpdate)
Parameters
IField fieldToUpdate

IField representing the field to set
Returns
IFieldValueCollection

Recycle()

Recycle the current item

Declaration
Guid Recycle()
Returns
Guid

RecycleAsync()

Recycle the current item

Declaration
Task<Guid> RecycleAsync()
Returns
Task<Guid>

RecycleBatch()

Recycle the current item

Declaration
IBatchSingleResult<BatchResultValue<Guid>> RecycleBatch()
Returns
IBatchSingleResult<BatchResultValue<Guid>>

RecycleBatch(Batch)

Recycle the current item

Declaration
IBatchSingleResult<BatchResultValue<Guid>> RecycleBatch(Batch batch)
Parameters
Batch batch

Batch to add the request to
Returns
IBatchSingleResult<BatchResultValue<Guid>>

RecycleBatchAsync()

Recycle the current item

Declaration
Task<IBatchSingleResult<BatchResultValue<Guid>>> RecycleBatchAsync()
Returns
Task<IBatchSingleResult<BatchResultValue<Guid>>>

RecycleBatchAsync(Batch)

Recycle the current item

Declaration
Task<IBatchSingleResult<BatchResultValue<Guid>>> RecycleBatchAsync(Batch batch)
Parameters
Batch batch

Batch to add the request to
Returns
Task<IBatchSingleResult<BatchResultValue<Guid>>>

SetCommentsDisabled(Boolean)

Enable/Disable comments for this list item

Declaration
void SetCommentsDisabled(bool commentsDisabled)
Parameters
System.Boolean commentsDisabled

Do comments need to enabled or disabled

SetCommentsDisabledAsync(Boolean)

Enable/Disable comments for this list item

Declaration
Task SetCommentsDisabledAsync(bool commentsDisabled)
Parameters
System.Boolean commentsDisabled

Do comments need to enabled or disabled
Returns
Task

SetComplianceTag(String, Boolean, Boolean, Boolean, Boolean)

Sets a compliancetag / retention label for this list item

Declaration
void SetComplianceTag(string complianceTag, bool isTagPolicyHold, bool isTagPolicyRecord, bool isEventBasedTag, bool isTagSuperLock)
Parameters
System.String complianceTag

The tag/label to set for this list item
System.Boolean isTagPolicyHold

Whether the tag is hold
System.Boolean isTagPolicyRecord

Whether the tag is record
System.Boolean isEventBasedTag

Whether the tag is Event based, this is not used
System.Boolean isTagSuperLock

Whether the tag is Sec 17 tag,no allow change even for site admin

SetComplianceTagAsync(String, Boolean, Boolean, Boolean, Boolean)

Sets a compliancetag / retention label for this list item

Declaration
Task SetComplianceTagAsync(string complianceTag, bool isTagPolicyHold, bool isTagPolicyRecord, bool isEventBasedTag, bool isTagSuperLock)
Parameters
System.String complianceTag

The tag/label to set for this list item
System.Boolean isTagPolicyHold

Whether the tag is hold
System.Boolean isTagPolicyRecord

Whether the tag is record
System.Boolean isEventBasedTag

Whether the tag is Event based, this is not used
System.Boolean isTagSuperLock

Whether the tag is Sec 17 tag,no allow change even for site admin
Returns
Task

SetComplianceTagBatch(Batch, String, Boolean, Boolean, Boolean, Boolean)

Sets a compliancetag / retention label for this list item

Declaration
void SetComplianceTagBatch(Batch batch, string complianceTag, bool isTagPolicyHold, bool isTagPolicyRecord, bool isEventBasedTag, bool isTagSuperLock)
Parameters
Batch batch

Batch to add the request to
System.String complianceTag

The tag/label to set for this list item
System.Boolean isTagPolicyHold

Whether the tag is hold
System.Boolean isTagPolicyRecord

Whether the tag is record
System.Boolean isEventBasedTag

Whether the tag is Event based, this is not used
System.Boolean isTagSuperLock

Whether the tag is Sec 17 tag,no allow change even for site admin

SetComplianceTagBatch(String, Boolean, Boolean, Boolean, Boolean)

Sets a compliancetag / retention label for this list item

Declaration
void SetComplianceTagBatch(string complianceTag, bool isTagPolicyHold, bool isTagPolicyRecord, bool isEventBasedTag, bool isTagSuperLock)
Parameters
System.String complianceTag

The tag/label to set for this list item
System.Boolean isTagPolicyHold

Whether the tag is hold
System.Boolean isTagPolicyRecord

Whether the tag is record
System.Boolean isEventBasedTag

Whether the tag is Event based, this is not used
System.Boolean isTagSuperLock

Whether the tag is Sec 17 tag,no allow change even for site admin

SetComplianceTagBatchAsync(Batch, String, Boolean, Boolean, Boolean, Boolean)

Sets a compliancetag / retention label for this list item

Declaration
Task SetComplianceTagBatchAsync(Batch batch, string complianceTag, bool isTagPolicyHold, bool isTagPolicyRecord, bool isEventBasedTag, bool isTagSuperLock)
Parameters
Batch batch

Batch to add the request to
System.String complianceTag

The tag/label to set for this list item
System.Boolean isTagPolicyHold

Whether the tag is hold
System.Boolean isTagPolicyRecord

Whether the tag is record
System.Boolean isEventBasedTag

Whether the tag is Event based, this is not used
System.Boolean isTagSuperLock

Whether the tag is Sec 17 tag,no allow change even for site admin
Returns
Task

SetComplianceTagBatchAsync(String, Boolean, Boolean, Boolean, Boolean)

Sets a compliancetag / retention label for this list item

Declaration
Task SetComplianceTagBatchAsync(string complianceTag, bool isTagPolicyHold, bool isTagPolicyRecord, bool isEventBasedTag, bool isTagSuperLock)
Parameters
System.String complianceTag

The tag/label to set for this list item
System.Boolean isTagPolicyHold

Whether the tag is hold
System.Boolean isTagPolicyRecord

Whether the tag is record
System.Boolean isEventBasedTag

Whether the tag is Event based, this is not used
System.Boolean isTagSuperLock

Whether the tag is Sec 17 tag,no allow change even for site admin
Returns
Task

SystemUpdate()

Performs a system update of the list item

Declaration
void SystemUpdate()

SystemUpdateAsync()

Performs a system update of the list item

Declaration
Task SystemUpdateAsync()
Returns
Task

SystemUpdateBatch()

Performs a system update of the list item

Declaration
void SystemUpdateBatch()

SystemUpdateBatch(Batch)

Performs a system update of the list item

Declaration
void SystemUpdateBatch(Batch batch)
Parameters
Batch batch

Batch to add the systemupdate request to

SystemUpdateBatchAsync()

Performs a system update of the list item

Declaration
Task SystemUpdateBatchAsync()
Returns
Task

SystemUpdateBatchAsync(Batch)

Performs a system update of the list item

Declaration
Task SystemUpdateBatchAsync(Batch batch)
Parameters
Batch batch

Batch to add the systemupdate request to
Returns
Task

UpdateOverwriteVersion()

Performs a UpdateOverwriteVersion of the list item

Declaration
void UpdateOverwriteVersion()

UpdateOverwriteVersionAsync()

Performs a UpdateOverwriteVersion of the list item

Declaration
Task UpdateOverwriteVersionAsync()
Returns
Task

UpdateOverwriteVersionBatch()

Performs a UpdateOverwriteVersion of the list item

Declaration
void UpdateOverwriteVersionBatch()

UpdateOverwriteVersionBatch(Batch)

Performs a UpdateOverwriteVersion of the list item

Declaration
void UpdateOverwriteVersionBatch(Batch batch)
Parameters
Batch batch

Batch to add the UpdateOverwriteVersion request to

UpdateOverwriteVersionBatchAsync()

Performs a UpdateOverwriteVersion of the list item

Declaration
Task UpdateOverwriteVersionBatchAsync()
Returns
Task

UpdateOverwriteVersionBatchAsync(Batch)

Performs a UpdateOverwriteVersion of the list item

Declaration
Task UpdateOverwriteVersionBatchAsync(Batch batch)
Parameters
Batch batch

Batch to add the UpdateOverwriteVersion request to
Returns
Task

Extension Methods