Represents the Media Service, which is an easy access to operations involving IMedia
InheritanceSystem.Object
Namespace: Umbraco.Cms.Core.Services Assembly: Umbraco.Core.dll Syntaxpublic class MediaService : RepositoryService, IMediaService, IContentServiceBase<IMedia>, IContentServiceBase, IService
Constructors View Source MediaService(ICoreScopeProvider, MediaFileManager, ILoggerFactory, IEventMessagesFactory, IMediaRepository, IAuditRepository, IMediaTypeRepository, IEntityRepository, IShortStringHelper) Declaration
public MediaService(ICoreScopeProvider provider, MediaFileManager mediaFileManager, ILoggerFactory loggerFactory, IEventMessagesFactory eventMessagesFactory, IMediaRepository mediaRepository, IAuditRepository auditRepository, IMediaTypeRepository mediaTypeRepository, IEntityRepository entityRepository, IShortStringHelper shortStringHelper)
Parameters View Source MediaService(ICoreScopeProvider, MediaFileManager, ILoggerFactory, IEventMessagesFactory, IMediaRepository, IAuditRepository, IMediaTypeRepository, IEntityRepository, IShortStringHelper, IUserIdKeyResolver) Declaration
public MediaService(ICoreScopeProvider provider, MediaFileManager mediaFileManager, ILoggerFactory loggerFactory, IEventMessagesFactory eventMessagesFactory, IMediaRepository mediaRepository, IAuditRepository auditRepository, IMediaTypeRepository mediaTypeRepository, IEntityRepository entityRepository, IShortStringHelper shortStringHelper, IUserIdKeyResolver userIdKeyResolver)
Parameters Methods View Source CheckDataIntegrity(ContentDataIntegrityReportOptions) Declaration
public ContentDataIntegrityReport CheckDataIntegrity(ContentDataIntegrityReportOptions options)
Parameters Returns View Source Count(String) Declaration
public int Count(string mediaTypeAlias = null)
Parameters Type Name Description System.String mediaTypeAlias Returns Type Description System.Int32 View Source CountChildren(Int32, String) Declaration
public int CountChildren(int parentId, string mediaTypeAlias = null)
Parameters Type Name Description System.Int32 parentId System.String mediaTypeAlias Returns Type Description System.Int32 View Source CountDescendants(Int32, String) Declaration
public int CountDescendants(int parentId, string mediaTypeAlias = null)
Parameters Type Name Description System.Int32 parentId System.String mediaTypeAlias Returns Type Description System.Int32 View Source CountNotTrashed(String) Declaration
public int CountNotTrashed(string mediaTypeAlias = null)
Parameters Type Name Description System.String mediaTypeAlias Returns Type Description System.Int32 View Source CreateMedia(String, Guid, String, Int32)
Creates an IMedia object using the alias of the IMediaType that this Media should based on.
Declarationpublic IMedia CreateMedia(string name, Guid parentId, string mediaTypeAlias, int userId = -1)
Parameters Type Name Description System.String name
Name of the Media object
Guid parentIdId of Parent for the new Media item
System.String mediaTypeAliasAlias of the IMediaType
System.Int32 userIdOptional id of the user creating the media item
Returns View Source CreateMedia(String, Int32, String, Int32)Creates an IMedia object of a specified media type.
Declarationpublic IMedia CreateMedia(string name, int parentId, string mediaTypeAlias, int userId = -1)
Parameters Type Name Description System.String name
The name of the media object.
System.Int32 parentIdThe identifier of the parent, or -1.
System.String mediaTypeAliasThe alias of the media type.
System.Int32 userIdThe optional id of the user creating the media.
Returns Type Description IMediaThe media object.
View Source CreateMedia(String, String, Int32)Creates an IMedia object of a specified media type, at root.
Declarationpublic IMedia CreateMedia(string name, string mediaTypeAlias, int userId = -1)
Parameters Type Name Description System.String name
The name of the media object.
System.String mediaTypeAliasThe alias of the media type.
System.Int32 userIdThe optional id of the user creating the media.
Returns Type Description IMediaThe media object.
View Source CreateMedia(String, IMedia, String, Int32)Creates an IMedia object of a specified media type, under a parent.
Declarationpublic IMedia CreateMedia(string name, IMedia parent, string mediaTypeAlias, int userId = -1)
Parameters Type Name Description System.String name
The name of the media object.
IMedia parentThe parent media object.
System.String mediaTypeAliasThe alias of the media type.
System.Int32 userIdThe optional id of the user creating the media.
Returns Type Description IMediaThe media object.
View Source CreateMediaWithIdentity(String, Int32, String, Int32)Creates an IMedia object of a specified media type.
Declarationpublic IMedia CreateMediaWithIdentity(string name, int parentId, string mediaTypeAlias, int userId = -1)
Parameters Type Name Description System.String name
The name of the media object.
System.Int32 parentIdThe identifier of the parent, or -1.
System.String mediaTypeAliasThe alias of the media type.
System.Int32 userIdThe optional id of the user creating the media.
Returns Type Description IMediaThe media object.
View Source CreateMediaWithIdentity(String, IMedia, String, Int32)Creates an IMedia object of a specified media type, under a parent.
Declarationpublic IMedia CreateMediaWithIdentity(string name, IMedia parent, string mediaTypeAlias, int userId = -1)
Parameters Type Name Description System.String name
The name of the media object.
IMedia parentThe parent media object.
System.String mediaTypeAliasThe alias of the media type.
System.Int32 userIdThe optional id of the user creating the media.
Returns Type Description IMediaThe media object.
View Source Delete(IMedia, Int32)Permanently deletes an IMedia object
Declarationpublic Attempt<OperationResult> Delete(IMedia media, int userId = -1)
Parameters Type Name Description IMedia media
The IMedia to delete
System.Int32 userIdId of the User deleting the Media
Returns View Source DeleteMediaFile(String) Declarationpublic void DeleteMediaFile(string filepath)
Parameters Type Name Description System.String filepath View Source DeleteMediaOfType(Int32, Int32)
Deletes all media of specified type. All children of deleted media is moved to Recycle Bin.
Declarationpublic void DeleteMediaOfType(int mediaTypeId, int userId = -1)
Parameters Type Name Description System.Int32 mediaTypeId
Id of the IMediaType
System.Int32 userIdOptional id of the user deleting the media
View Source DeleteMediaOfTypes(IEnumerable<Int32>, Int32)Deletes all media of specified type. All children of deleted media is moved to Recycle Bin.
Declarationpublic void DeleteMediaOfTypes(IEnumerable<int> mediaTypeIds, int userId = -1)
Parameters Type Name Description IEnumerable<System.Int32> mediaTypeIds
Id of the IMediaType
System.Int32 userIdOptional id of the user deleting the media
View Source DeleteVersion(Int32, Int32, Boolean, Int32)Permanently deletes specific version(s) from an IMedia object. This method will never delete the latest version of a media item.
Declarationpublic void DeleteVersion(int id, int versionId, bool deletePriorVersions, int userId = -1)
Parameters Type Name Description System.Int32 id
Id of the IMedia object to delete a version from
System.Int32 versionIdId of the version to delete
System.Boolean deletePriorVersionsBoolean indicating whether to delete versions prior to the versionId
System.Int32 userIdOptional Id of the User deleting versions of a Media object
View Source DeleteVersions(Int32, DateTime, Int32)Permanently deletes versions from an IMedia object prior to a specific date. This method will never delete the latest version of a media item.
Declarationpublic void DeleteVersions(int id, DateTime versionDate, int userId = -1)
Parameters Type Name Description System.Int32 id
Id of the IMedia object to delete versions from
DateTime versionDateLatest version date
System.Int32 userIdOptional Id of the User deleting versions of a Media object
View Source EmptyRecycleBin(Int32)Empties the Recycle Bin by deleting all IMedia that resides in the bin
Declarationpublic OperationResult EmptyRecycleBin(int userId = -1)
Parameters Type Name Description System.Int32 userId
Optional Id of the User emptying the Recycle Bin
Returns View Source EmptyRecycleBinAsync(Guid) Declarationpublic async Task<OperationResult> EmptyRecycleBinAsync(Guid userId)
Parameters Type Name Description Guid userId Returns View Source GetAncestors(Int32)
Gets a collection of IMedia objects, which are ancestors of the current media.
Declarationpublic IEnumerable<IMedia> GetAncestors(int id)
Parameters Type Name Description System.Int32 id
Id of the IMedia to retrieve ancestors for
Returns Type Description IEnumerable<IMedia>An Enumerable list of IMedia objects
View Source GetAncestors(IMedia)Gets a collection of IMedia objects, which are ancestors of the current media.
Declarationpublic IEnumerable<IMedia> GetAncestors(IMedia media)
Parameters Type Name Description IMedia media
IMedia to retrieve ancestors for
Returns Type Description IEnumerable<IMedia>An Enumerable list of IMedia objects
View Source GetById(Guid)Gets an IMedia object by its 'UniqueId'
Declarationpublic IMedia GetById(Guid key)
Parameters Type Name Description Guid key
Guid key of the Media to retrieve
Returns View Source GetById(Int32)Gets an IMedia object by Id
Declarationpublic IMedia GetById(int id)
Parameters Type Name Description System.Int32 id
Id of the Media to retrieve
Returns View Source GetByIds(IEnumerable<Guid>)Gets an IMedia object by Id
Declarationpublic IEnumerable<IMedia> GetByIds(IEnumerable<Guid> ids)
Parameters Type Name Description IEnumerable<Guid> ids
Ids of the Media to retrieve
Returns View Source GetByIds(IEnumerable<Int32>)Gets an IMedia object by Id
Declarationpublic IEnumerable<IMedia> GetByIds(IEnumerable<int> ids)
Parameters Type Name Description IEnumerable<System.Int32> ids
Ids of the Media to retrieve
Returns View Source GetByLevel(Int32)Gets a collection of IMedia objects by Level
Declarationpublic IEnumerable<IMedia>? GetByLevel(int level)
Parameters Type Name Description System.Int32 level
The level to retrieve Media from
Returns Type Description System.Nullable<IEnumerable<IMedia>>An Enumerable list of IMedia objects
View Source GetMediaByPath(String)Gets an IMedia object from the path stored in the 'umbracoFile' property.
Declarationpublic IMedia GetMediaByPath(string mediaPath)
Parameters Type Name Description System.String mediaPath
Path of the media item to retrieve (for example: /media/1024/koala_403x328.jpg)
Returns View Source GetMediaFileContentStream(String) Declarationpublic Stream GetMediaFileContentStream(string filepath)
Parameters Type Name Description System.String filepath Returns View Source GetMediaFileSize(String) Declaration
public long GetMediaFileSize(string filepath)
Parameters Type Name Description System.String filepath Returns Type Description System.Int64 View Source GetPagedChildren(Int32, Int64, Int32, out Int64, IQuery<IMedia>, Ordering)
Gets a collection of IMedia objects by Parent Id
Declarationpublic IEnumerable<IMedia> GetPagedChildren(int id, long pageIndex, int pageSize, out long totalChildren, IQuery<IMedia> filter = null, Ordering ordering = null)
Parameters Type Name Description System.Int32 id
Id of the Parent to retrieve Children from
System.Int64 pageIndexPage number
System.Int32 pageSizePage size
System.Int64 totalChildren IQuery<IMedia> filter Ordering ordering Returns Type Description IEnumerable<IMedia>An Enumerable list of IContent objects
View Source GetPagedDescendants(Int32, Int64, Int32, out Int64, IQuery<IMedia>, Ordering)Gets a collection of IMedia objects by Parent Id
Declarationpublic IEnumerable<IMedia> GetPagedDescendants(int id, long pageIndex, int pageSize, out long totalChildren, IQuery<IMedia> filter = null, Ordering ordering = null)
Parameters Type Name Description System.Int32 id
Id of the Parent to retrieve Descendants from
System.Int64 pageIndexPage number
System.Int32 pageSizePage size
System.Int64 totalChildren IQuery<IMedia> filter Ordering ordering Returns Type Description IEnumerable<IMedia>An Enumerable list of IContent objects
View Source GetPagedMediaInRecycleBin(Int64, Int32, out Int64, IQuery<IMedia>, Ordering)Gets a collection of an IMedia objects, which resides in the Recycle Bin
Declarationpublic IEnumerable<IMedia> GetPagedMediaInRecycleBin(long pageIndex, int pageSize, out long totalRecords, IQuery<IMedia> filter = null, Ordering ordering = null)
Parameters Type Name Description System.Int64 pageIndex System.Int32 pageSize System.Int64 totalRecords IQuery<IMedia> filter Ordering ordering Returns Type Description IEnumerable<IMedia>
An Enumerable list of IMedia objects
View Source GetPagedOfType(Int32, Int64, Int32, out Int64, IQuery<IMedia>, Ordering)Gets paged documents of a content
Declarationpublic IEnumerable<IMedia> GetPagedOfType(int contentTypeId, long pageIndex, int pageSize, out long totalRecords, IQuery<IMedia> filter = null, Ordering ordering = null)
Parameters Type Name Description System.Int32 contentTypeId
The page number.
System.Int64 pageIndexThe page number.
System.Int32 pageSizeThe page size.
System.Int64 totalRecordsTotal number of documents.
IQuery<IMedia> filterSearch text filter.
Ordering orderingOrdering infos.
Returns Type Description IEnumerable<IMedia> View Source GetPagedOfTypes(Int32[], Int64, Int32, out Int64, IQuery<IMedia>, Ordering)Gets paged documents for specified content types
Declarationpublic IEnumerable<IMedia> GetPagedOfTypes(int[] contentTypeIds, long pageIndex, int pageSize, out long totalRecords, IQuery<IMedia> filter = null, Ordering ordering = null)
Parameters Type Name Description System.Int32[] contentTypeIds
The page number.
System.Int64 pageIndexThe page number.
System.Int32 pageSizeThe page size.
System.Int64 totalRecordsTotal number of documents.
IQuery<IMedia> filterSearch text filter.
Ordering orderingOrdering infos.
Returns Type Description IEnumerable<IMedia> View Source GetParent(Int32)Gets the parent of the current media as an IMedia item.
Declarationpublic IMedia GetParent(int id)
Parameters Type Name Description System.Int32 id
Id of the IMedia to retrieve the parent from
Returns View Source GetParent(IMedia)Gets the parent of the current media as an IMedia item.
Declarationpublic IMedia GetParent(IMedia media)
Parameters Type Name Description IMedia media
IMedia to retrieve the parent from
Returns View Source GetRootMedia()Gets a collection of IMedia objects, which reside at the first level / root
Declarationpublic IEnumerable<IMedia> GetRootMedia()
Returns Type Description IEnumerable<IMedia>
An Enumerable list of IMedia objects
View Source GetVersion(Int32)Gets a specific version of an IMedia item.
Declarationpublic IMedia GetVersion(int versionId)
Parameters Type Name Description System.Int32 versionId
Id of the version to retrieve
Returns View Source GetVersions(Int32)Gets a collection of an IMedia objects versions by Id
Declarationpublic IEnumerable<IMedia> GetVersions(int id)
Parameters Type Name Description System.Int32 id Returns Type Description IEnumerable<IMedia>
An Enumerable list of IMedia objects
View Source HasChildren(Int32)Checks whether an IMedia item has any children
Declarationpublic bool HasChildren(int id)
Parameters Type Name Description System.Int32 id
Id of the IMedia
Returns Type Description System.BooleanTrue if the media has any children otherwise False
View Source Move(IMedia, Int32, Int32)Moves an IMedia object to a new location
Declarationpublic Attempt<OperationResult> Move(IMedia media, int parentId, int userId = -1)
Parameters Type Name Description IMedia media
The IMedia to move
System.Int32 parentIdId of the Media's new Parent
System.Int32 userIdId of the User moving the Media
Returns View Source MoveToRecycleBin(IMedia, Int32)Deletes an IMedia object by moving it to the Recycle Bin
Declarationpublic Attempt<OperationResult> MoveToRecycleBin(IMedia media, int userId = -1)
Parameters Type Name Description IMedia media
The IMedia to delete
System.Int32 userIdId of the User deleting the Media
Returns View Source RecycleBinSmells() Declarationpublic bool RecycleBinSmells()
Returns Type Description System.Boolean View Source Save(IEnumerable<IMedia>, Int32)
Saves a collection of IMedia objects
Declarationpublic Attempt<OperationResult> Save(IEnumerable<IMedia> medias, int userId = -1)
Parameters Type Name Description IEnumerable<IMedia> medias
Collection of IMedia to save
System.Int32 userIdId of the User saving the Media
Returns View Source Save(IMedia, Int32)Saves a single IMedia object
Declarationpublic Attempt<OperationResult> Save(IMedia media, int userId = -1)
Parameters Type Name Description IMedia media
The IMedia to save
System.Int32 userIdId of the User saving the Media
Returns View Source SetMediaFileContent(String, Stream) Declarationpublic void SetMediaFileContent(string filepath, Stream stream)
Parameters Type Name Description System.String filepath Stream stream View Source Sort(IEnumerable<IMedia>, Int32)
Sorts a collection of IMedia objects by updating the SortOrder according to the ordering of items in the passed in .
Declarationpublic bool Sort(IEnumerable<IMedia> items, int userId = -1)
Parameters Type Name Description IEnumerable<IMedia> items System.Int32 userId Returns Type Description System.Boolean
True if sorting succeeded, otherwise False
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4