A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://apidocs.umbraco.com/v15/csharp/api/Umbraco.Cms.Core.Services.MediaService.html below:

View Source

Represents the Media Service, which is an easy access to operations involving IMedia

Inheritance

System.Object

Namespace: Umbraco.Cms.Core.Services Assembly: Umbraco.Core.dll Syntax
public 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.

Declaration
public IMedia CreateMedia(string name, Guid parentId, string mediaTypeAlias, int userId = -1)
Parameters Type Name Description System.String name

Name of the Media object

Guid parentId

Id of Parent for the new Media item

System.String mediaTypeAlias

Alias of the IMediaType

System.Int32 userId

Optional 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.

Declaration
public 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 parentId

The identifier of the parent, or -1.

System.String mediaTypeAlias

The alias of the media type.

System.Int32 userId

The optional id of the user creating the media.

Returns Type Description IMedia

The media object.

View Source CreateMedia(String, String, Int32)

Creates an IMedia object of a specified media type, at root.

Declaration
public IMedia CreateMedia(string name, string mediaTypeAlias, int userId = -1)
Parameters Type Name Description System.String name

The name of the media object.

System.String mediaTypeAlias

The alias of the media type.

System.Int32 userId

The optional id of the user creating the media.

Returns Type Description IMedia

The media object.

View Source CreateMedia(String, IMedia, String, Int32)

Creates an IMedia object of a specified media type, under a parent.

Declaration
public 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 parent

The parent media object.

System.String mediaTypeAlias

The alias of the media type.

System.Int32 userId

The optional id of the user creating the media.

Returns Type Description IMedia

The media object.

View Source CreateMediaWithIdentity(String, Int32, String, Int32)

Creates an IMedia object of a specified media type.

Declaration
public 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 parentId

The identifier of the parent, or -1.

System.String mediaTypeAlias

The alias of the media type.

System.Int32 userId

The optional id of the user creating the media.

Returns Type Description IMedia

The media object.

View Source CreateMediaWithIdentity(String, IMedia, String, Int32)

Creates an IMedia object of a specified media type, under a parent.

Declaration
public 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 parent

The parent media object.

System.String mediaTypeAlias

The alias of the media type.

System.Int32 userId

The optional id of the user creating the media.

Returns Type Description IMedia

The media object.

View Source Delete(IMedia, Int32)

Permanently deletes an IMedia object

Declaration
public Attempt<OperationResult> Delete(IMedia media, int userId = -1)
Parameters Type Name Description IMedia media

The IMedia to delete

System.Int32 userId

Id of the User deleting the Media

Returns View Source DeleteMediaFile(String) Declaration
public 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.

Declaration
public void DeleteMediaOfType(int mediaTypeId, int userId = -1)
Parameters Type Name Description System.Int32 mediaTypeId

Id of the IMediaType

System.Int32 userId

Optional 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.

Declaration
public void DeleteMediaOfTypes(IEnumerable<int> mediaTypeIds, int userId = -1)
Parameters Type Name Description IEnumerable<System.Int32> mediaTypeIds

Id of the IMediaType

System.Int32 userId

Optional 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.

Declaration
public 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 versionId

Id of the version to delete

System.Boolean deletePriorVersions

Boolean indicating whether to delete versions prior to the versionId

System.Int32 userId

Optional 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.

Declaration
public 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 versionDate

Latest version date

System.Int32 userId

Optional 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

Declaration
public 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) Declaration
public 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.

Declaration
public 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.

Declaration
public 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'

Declaration
public 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

Declaration
public 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

Declaration
public 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

Declaration
public 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

Declaration
public 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.

Declaration
public 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) Declaration
public 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

Declaration
public 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 pageIndex

Page number

System.Int32 pageSize

Page 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

Declaration
public 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 pageIndex

Page number

System.Int32 pageSize

Page 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

Declaration
public 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

Declaration
public 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 pageIndex

The page number.

System.Int32 pageSize

The page size.

System.Int64 totalRecords

Total number of documents.

IQuery<IMedia> filter

Search text filter.

Ordering ordering

Ordering infos.

Returns Type Description IEnumerable<IMedia> View Source GetPagedOfTypes(Int32[], Int64, Int32, out Int64, IQuery<IMedia>, Ordering)

Gets paged documents for specified content types

Declaration
public 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 pageIndex

The page number.

System.Int32 pageSize

The page size.

System.Int64 totalRecords

Total number of documents.

IQuery<IMedia> filter

Search text filter.

Ordering ordering

Ordering infos.

Returns Type Description IEnumerable<IMedia> View Source GetParent(Int32)

Gets the parent of the current media as an IMedia item.

Declaration
public 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.

Declaration
public 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

Declaration
public 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.

Declaration
public 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

Declaration
public 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

Declaration
public bool HasChildren(int id)
Parameters Type Name Description System.Int32 id

Id of the IMedia

Returns Type Description System.Boolean

True if the media has any children otherwise False

View Source Move(IMedia, Int32, Int32)

Moves an IMedia object to a new location

Declaration
public Attempt<OperationResult> Move(IMedia media, int parentId, int userId = -1)
Parameters Type Name Description IMedia media

The IMedia to move

System.Int32 parentId

Id of the Media's new Parent

System.Int32 userId

Id of the User moving the Media

Returns View Source MoveToRecycleBin(IMedia, Int32)

Deletes an IMedia object by moving it to the Recycle Bin

Declaration
public Attempt<OperationResult> MoveToRecycleBin(IMedia media, int userId = -1)
Parameters Type Name Description IMedia media

The IMedia to delete

System.Int32 userId

Id of the User deleting the Media

Returns View Source RecycleBinSmells() Declaration
public bool RecycleBinSmells()
Returns Type Description System.Boolean View Source Save(IEnumerable<IMedia>, Int32)

Saves a collection of IMedia objects

Declaration
public Attempt<OperationResult> Save(IEnumerable<IMedia> medias, int userId = -1)
Parameters Type Name Description IEnumerable<IMedia> medias

Collection of IMedia to save

System.Int32 userId

Id of the User saving the Media

Returns View Source Save(IMedia, Int32)

Saves a single IMedia object

Declaration
public Attempt<OperationResult> Save(IMedia media, int userId = -1)
Parameters Type Name Description IMedia media

The IMedia to save

System.Int32 userId

Id of the User saving the Media

Returns View Source SetMediaFileContent(String, Stream) Declaration
public 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 .

Declaration
public 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