Interface IEntityService

Namespace: Umbraco.Cms.Core.Services

Assembly: Umbraco.Core.dll

Syntax

public interface IEntityService

Methods

View Source

Exists(Guid)

Determines whether an entity exists.

Declaration

bool Exists(Guid key)

Parameters

Type	Name	Description
Guid	key	The unique key of the entity.

Returns

Type	Description
System.Boolean

View Source

Exists(Guid, UmbracoObjectTypes)

Determines whether and entity of a certain object type exists.

Declaration

virtual bool Exists(Guid key, UmbracoObjectTypes objectType)

Parameters

Type	Name	Description
Guid	key	The unique key of the entity.
UmbracoObjectTypes	objectType	The object type to look for.

Returns

Type	Description
System.Boolean	True if the entity exists, false if it does not.

View Source

Exists(IEnumerable<Guid>)

Determines whether an entity exists.

Declaration

bool Exists(IEnumerable<Guid> keys)

Parameters

Type	Name	Description
IEnumerable<Guid>	keys	The unique keys of the entities.

Returns

Type	Description
System.Boolean

View Source

Exists(Int32)

Determines whether an entity exists.

Declaration

bool Exists(int id)

Parameters

Type	Name	Description
System.Int32	id	The identifier of the entity.

Returns

Type	Description
System.Boolean

View Source

Exists(Int32, UmbracoObjectTypes)

Determines whether and entity of a certain object type exists.

Declaration

virtual bool Exists(int id, UmbracoObjectTypes objectType)

Parameters

Type	Name	Description
System.Int32	id	The id of the entity.
UmbracoObjectTypes	objectType	The object type to look for.

Returns

Type	Description
System.Boolean	True if the entity exists, false if it does not.

View Source

Get(Guid)

Gets an entity.

Declaration

IEntitySlim Get(Guid key)

Parameters

Type	Name	Description
Guid	key	The unique key of the entity.

Returns

Type	Description
IEntitySlim

View Source

Get(Guid, UmbracoObjectTypes)

Gets an entity.

Declaration

IEntitySlim Get(Guid key, UmbracoObjectTypes objectType)

Parameters

Type	Name	Description
Guid	key	The unique key of the entity.
UmbracoObjectTypes	objectType	The object type of the entity.

Returns

Type	Description
IEntitySlim

View Source

Get(Int32)

Gets an entity.

Declaration

IEntitySlim Get(int id)

Parameters

Type	Name	Description
System.Int32	id	The identifier of the entity.

Returns

Type	Description
IEntitySlim

View Source

Get(Int32, UmbracoObjectTypes)

Gets an entity.

Declaration

IEntitySlim Get(int id, UmbracoObjectTypes objectType)

Parameters

Type	Name	Description
System.Int32	id	The identifier of the entity.
UmbracoObjectTypes	objectType	The object type of the entity.

Returns

Type	Description
IEntitySlim

View Source

Get<T>(Guid)

Gets an entity.

Declaration

IEntitySlim Get<T>(Guid key)
    where T : IUmbracoEntity

Parameters

Type	Name	Description
Guid	key	The unique key of the entity.

Returns

Type	Description
IEntitySlim

Type Parameters

Name	Description
T	The type used to determine the object type of the entity.

View Source

Get<T>(Int32)

Gets an entity.

Declaration

IEntitySlim Get<T>(int id)
    where T : IUmbracoEntity

Parameters

Type	Name	Description
System.Int32	id	The identifier of the entity.

Returns

Type	Description
IEntitySlim

Type Parameters

Name	Description
T	The type used to determine the object type of the entity.

View Source

GetAll(Guid)

Gets entities of a given object type.

Declaration

IEnumerable<IEntitySlim> GetAll(Guid objectType)

Parameters

Type	Name	Description
Guid	objectType	The object type of the entities.

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetAll(Guid, Guid[])

Gets entities of a given object type.

Declaration

IEnumerable<IEntitySlim> GetAll(Guid objectType, params Guid[] keys)

Parameters

Type	Name	Description
Guid	objectType	The object type of the entities.
Guid[]	keys	The unique identifiers of the entities.

Returns

Type	Description
IEnumerable<IEntitySlim>

Remarks

If keys is empty, returns all entities.

View Source

GetAll(Guid, Int32[])

Gets entities of a given object type.

Declaration

IEnumerable<IEntitySlim> GetAll(Guid objectType, params int[] ids)

Parameters

Type	Name	Description
Guid	objectType	The object type of the entities.
System.Int32[]	ids	The identifiers of the entities.

Returns

Type	Description
IEnumerable<IEntitySlim>

Remarks

If ids is empty, returns all entities.

View Source

GetAll(UmbracoObjectTypes)

Gets entities of a given object type.

Declaration

IEnumerable<IEntitySlim> GetAll(UmbracoObjectTypes objectType)

Parameters

Type	Name	Description
UmbracoObjectTypes	objectType	The object type of the entities.

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetAll(UmbracoObjectTypes, Guid[])

Gets entities of a given object type.

Declaration

IEnumerable<IEntitySlim> GetAll(UmbracoObjectTypes objectType, Guid[] keys)

Parameters

Type	Name	Description
UmbracoObjectTypes	objectType	The object type of the entities.
Guid[]	keys	The unique identifiers of the entities.

Returns

Type	Description
IEnumerable<IEntitySlim>

Remarks

If keys is empty, returns all entities.

View Source

GetAll(UmbracoObjectTypes, Int32[])

Gets entities of a given object type.

Declaration

IEnumerable<IEntitySlim> GetAll(UmbracoObjectTypes objectType, params int[] ids)

Parameters

Type	Name	Description
UmbracoObjectTypes	objectType	The object type of the entities.
System.Int32[]	ids	The identifiers of the entities.

Returns

Type	Description
IEnumerable<IEntitySlim>

Remarks

If ids is empty, returns all entities.

View Source

GetAll<T>()

Gets entities of a given object type.

Declaration

IEnumerable<IEntitySlim> GetAll<T>()
    where T : IUmbracoEntity

Returns

Type	Description
IEnumerable<IEntitySlim>

Type Parameters

Name	Description
T	The type used to determine the object type of the entities.

View Source

GetAll<T>(Guid[])

Gets entities of a given object type.

Declaration

IEnumerable<IEntitySlim> GetAll<T>(params Guid[] keys)
    where T : IUmbracoEntity

Parameters

Type	Name	Description
Guid[]	keys	The unique identifiers of the entities.

Returns

Type	Description
IEnumerable<IEntitySlim>

Type Parameters

Name	Description
T	The type used to determine the object type of the entities.

Remarks

If keys is empty, returns all entities.

View Source

GetAll<T>(Int32[])

Gets entities of a given object type.

Declaration

IEnumerable<IEntitySlim> GetAll<T>(params int[] ids)
    where T : IUmbracoEntity

Parameters

Type	Name	Description
System.Int32[]	ids	The identifiers of the entities.

Returns

Type	Description
IEnumerable<IEntitySlim>

Type Parameters

Name	Description
T	The type used to determine the object type of the entities.

Remarks

If ids is empty, returns all entities.

View Source

GetAllPaths(UmbracoObjectTypes, Guid[])

Gets paths for entities.

Declaration

IEnumerable<TreeEntityPath> GetAllPaths(UmbracoObjectTypes objectType, params Guid[] keys)

Parameters

Type	Name	Description
UmbracoObjectTypes	objectType
Guid[]	keys

Returns

Type	Description
IEnumerable<TreeEntityPath>

View Source

GetAllPaths(UmbracoObjectTypes, Int32[])

Gets paths for entities.

Declaration

IEnumerable<TreeEntityPath> GetAllPaths(UmbracoObjectTypes objectType, params int[] ids)

Parameters

Type	Name	Description
UmbracoObjectTypes	objectType
System.Int32[]	ids

Returns

Type	Description
IEnumerable<TreeEntityPath>

View Source

GetChildren(Int32)

Gets the children of an entity.

Declaration

IEnumerable<IEntitySlim> GetChildren(int id)

Parameters

Type	Name	Description
System.Int32	id	The identifier of the entity.

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetChildren(Int32, UmbracoObjectTypes)

Gets the children of an entity.

Declaration

IEnumerable<IEntitySlim> GetChildren(int id, UmbracoObjectTypes objectType)

Parameters

Type	Name	Description
System.Int32	id	The identifier of the entity.
UmbracoObjectTypes	objectType	The object type of the children.

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetChildren(Nullable<Guid>, UmbracoObjectTypes)

Declaration

virtual IEnumerable<IEntitySlim> GetChildren(Guid? key, UmbracoObjectTypes objectType)

Parameters

Type	Name	Description
System.Nullable<Guid>	key
UmbracoObjectTypes	objectType

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetDescendants(Int32)

Gets the descendants of an entity.

Declaration

IEnumerable<IEntitySlim> GetDescendants(int id)

Parameters

Type	Name	Description
System.Int32	id	The identifier of the entity.

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetDescendants(Int32, UmbracoObjectTypes)

Gets the descendants of an entity.

Declaration

IEnumerable<IEntitySlim> GetDescendants(int id, UmbracoObjectTypes objectType)

Parameters

Type	Name	Description
System.Int32	id	The identifier of the entity.
UmbracoObjectTypes	objectType	The object type of the descendants.

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetEntityType(Int32)

Gets the CLR type of an entity.

Declaration

Type? GetEntityType(int id)

Parameters

Type	Name	Description
System.Int32	id

Returns

Type	Description
System.Nullable<Type>

View Source

GetId(Guid, UmbracoObjectTypes)

Gets the integer identifier corresponding to a unique Guid identifier.

Declaration

Attempt<int> GetId(Guid key, UmbracoObjectTypes objectType)

Parameters

Type	Name	Description
Guid	key
UmbracoObjectTypes	objectType

Returns

Type	Description
Attempt<System.Int32>

View Source

GetId(Udi)

Gets the integer identifier corresponding to a Udi.

Declaration

Attempt<int> GetId(Udi udi)

Parameters

Type	Name	Description
Udi	udi

Returns

Type	Description
Attempt<System.Int32>

View Source

GetKey(Int32, UmbracoObjectTypes)

Gets the unique Guid identifier corresponding to an integer identifier.

Declaration

Attempt<Guid> GetKey(int id, UmbracoObjectTypes umbracoObjectType)

Parameters

Type	Name	Description
System.Int32	id
UmbracoObjectTypes	umbracoObjectType

Returns

Type	Description
Attempt<Guid>

View Source

GetObjectType(Guid)

Gets the object type of an entity.

Declaration

UmbracoObjectTypes GetObjectType(Guid key)

Parameters

Type	Name	Description
Guid	key

Returns

Type	Description
UmbracoObjectTypes

View Source

GetObjectType(Int32)

Gets the object type of an entity.

Declaration

UmbracoObjectTypes GetObjectType(int id)

Parameters

Type	Name	Description
System.Int32	id

Returns

Type	Description
UmbracoObjectTypes

View Source

GetObjectType(IUmbracoEntity)

Gets the object type of an entity.

Declaration

UmbracoObjectTypes GetObjectType(IUmbracoEntity entity)

Parameters

Type	Name	Description
IUmbracoEntity	entity

Returns

Type	Description
UmbracoObjectTypes

View Source

GetPagedChildren(Int32, UmbracoObjectTypes, Int64, Int32, out Int64, IQuery<IUmbracoEntity>, Ordering)

Gets children of an entity.

Declaration

IEnumerable<IEntitySlim> GetPagedChildren(int id, UmbracoObjectTypes objectType, long pageIndex, int pageSize, out long totalRecords, IQuery<IUmbracoEntity> filter = null, Ordering ordering = null)

Parameters

Type	Name	Description
System.Int32	id
UmbracoObjectTypes	objectType
System.Int64	pageIndex
System.Int32	pageSize
System.Int64	totalRecords
IQuery<IUmbracoEntity>	filter
Ordering	ordering

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetPagedChildren(Nullable<Guid>, IEnumerable<UmbracoObjectTypes>, IEnumerable<UmbracoObjectTypes>, Int32, Int32, Boolean, out Int64, IQuery<IUmbracoEntity>, Ordering)

Declaration

virtual IEnumerable<IEntitySlim> GetPagedChildren(Guid? parentKey, IEnumerable<UmbracoObjectTypes> parentObjectTypes, IEnumerable<UmbracoObjectTypes> childObjectTypes, int skip, int take, bool trashed, out long totalRecords, IQuery<IUmbracoEntity> filter = null, Ordering ordering = null)

Parameters

Type	Name	Description
System.Nullable<Guid>	parentKey
IEnumerable<UmbracoObjectTypes>	parentObjectTypes
IEnumerable<UmbracoObjectTypes>	childObjectTypes
System.Int32	skip
System.Int32	take
System.Boolean	trashed
System.Int64	totalRecords
IQuery<IUmbracoEntity>	filter
Ordering	ordering

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetPagedChildren(Nullable<Guid>, IEnumerable<UmbracoObjectTypes>, UmbracoObjectTypes, Int32, Int32, out Int64, IQuery<IUmbracoEntity>, Ordering)

Declaration

virtual IEnumerable<IEntitySlim> GetPagedChildren(Guid? parentKey, IEnumerable<UmbracoObjectTypes> parentObjectTypes, UmbracoObjectTypes childObjectType, int skip, int take, out long totalRecords, IQuery<IUmbracoEntity> filter = null, Ordering ordering = null)

Parameters

Type	Name	Description
System.Nullable<Guid>	parentKey
IEnumerable<UmbracoObjectTypes>	parentObjectTypes
UmbracoObjectTypes	childObjectType
System.Int32	skip
System.Int32	take
System.Int64	totalRecords
IQuery<IUmbracoEntity>	filter
Ordering	ordering

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetPagedChildren(Nullable<Guid>, UmbracoObjectTypes, Int32, Int32, out Int64, IQuery<IUmbracoEntity>, Ordering)

Declaration

virtual IEnumerable<IEntitySlim> GetPagedChildren(Guid? parentKey, UmbracoObjectTypes childObjectType, int skip, int take, out long totalRecords, IQuery<IUmbracoEntity> filter = null, Ordering ordering = null)

Parameters

Type	Name	Description
System.Nullable<Guid>	parentKey
UmbracoObjectTypes	childObjectType
System.Int32	skip
System.Int32	take
System.Int64	totalRecords
IQuery<IUmbracoEntity>	filter
Ordering	ordering

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetPagedDescendants(IEnumerable<Int32>, UmbracoObjectTypes, Int64, Int32, out Int64, IQuery<IUmbracoEntity>, Ordering)

Gets descendants of entities.

Declaration

IEnumerable<IEntitySlim> GetPagedDescendants(IEnumerable<int> ids, UmbracoObjectTypes objectType, long pageIndex, int pageSize, out long totalRecords, IQuery<IUmbracoEntity> filter = null, Ordering ordering = null)

Parameters

Type	Name	Description
IEnumerable<System.Int32>	ids
UmbracoObjectTypes	objectType
System.Int64	pageIndex
System.Int32	pageSize
System.Int64	totalRecords
IQuery<IUmbracoEntity>	filter
Ordering	ordering

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetPagedDescendants(Int32, UmbracoObjectTypes, Int64, Int32, out Int64, IQuery<IUmbracoEntity>, Ordering)

Gets descendants of an entity.

Declaration

IEnumerable<IEntitySlim> GetPagedDescendants(int id, UmbracoObjectTypes objectType, long pageIndex, int pageSize, out long totalRecords, IQuery<IUmbracoEntity> filter = null, Ordering ordering = null)

Parameters

Type	Name	Description
System.Int32	id
UmbracoObjectTypes	objectType
System.Int64	pageIndex
System.Int32	pageSize
System.Int64	totalRecords
IQuery<IUmbracoEntity>	filter
Ordering	ordering

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetPagedDescendants(UmbracoObjectTypes, Int64, Int32, out Int64, IQuery<IUmbracoEntity>, Ordering, Boolean)

Gets descendants of root.

Declaration

IEnumerable<IEntitySlim> GetPagedDescendants(UmbracoObjectTypes objectType, long pageIndex, int pageSize, out long totalRecords, IQuery<IUmbracoEntity> filter = null, Ordering ordering = null, bool includeTrashed = true)

Parameters

Type	Name	Description
UmbracoObjectTypes	objectType
System.Int64	pageIndex
System.Int32	pageSize
System.Int64	totalRecords
IQuery<IUmbracoEntity>	filter
Ordering	ordering
System.Boolean	includeTrashed

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetPagedTrashedChildren(Int32, UmbracoObjectTypes, Int64, Int32, out Int64, IQuery<IUmbracoEntity>, Ordering)

Gets children of an entity.

Declaration

virtual IEnumerable<IEntitySlim> GetPagedTrashedChildren(int id, UmbracoObjectTypes objectType, long pageIndex, int pageSize, out long totalRecords, IQuery<IUmbracoEntity> filter = null, Ordering ordering = null)

Parameters

Type	Name	Description
System.Int32	id
UmbracoObjectTypes	objectType
System.Int64	pageIndex
System.Int32	pageSize
System.Int64	totalRecords
IQuery<IUmbracoEntity>	filter
Ordering	ordering

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetPagedTrashedChildren(Nullable<Guid>, UmbracoObjectTypes, Int32, Int32, out Int64, IQuery<IUmbracoEntity>, Ordering)

Gets children of an entity.

Declaration

virtual IEnumerable<IEntitySlim> GetPagedTrashedChildren(Guid? key, UmbracoObjectTypes objectType, int skip, int take, out long totalRecords, IQuery<IUmbracoEntity> filter = null, Ordering ordering = null)

Parameters

Type	Name	Description
System.Nullable<Guid>	key
UmbracoObjectTypes	objectType
System.Int32	skip
System.Int32	take
System.Int64	totalRecords
IQuery<IUmbracoEntity>	filter
Ordering	ordering

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

GetParent(Int32)

Gets the parent of an entity.

Declaration

IEntitySlim GetParent(int id)

Parameters

Type	Name	Description
System.Int32	id	The identifier of the entity.

Returns

Type	Description
IEntitySlim

View Source

GetParent(Int32, UmbracoObjectTypes)

Gets the parent of an entity.

Declaration

IEntitySlim GetParent(int id, UmbracoObjectTypes objectType)

Parameters

Type	Name	Description
System.Int32	id	The identifier of the entity.
UmbracoObjectTypes	objectType	The object type of the parent.

Returns

Type	Description
IEntitySlim

View Source

GetRootEntities(UmbracoObjectTypes)

Gets entities at root.

Declaration

IEnumerable<IEntitySlim> GetRootEntities(UmbracoObjectTypes objectType)

Parameters

Type	Name	Description
UmbracoObjectTypes	objectType	The object type of the entities.

Returns

Type	Description
IEnumerable<IEntitySlim>

View Source

ReserveId(Guid)

Reserves an identifier for a key.

Declaration

int ReserveId(Guid key)

Parameters

Type	Name	Description
Guid	key	They key.

Returns

Type	Description
System.Int32	The identifier.

Remarks

When a new content or a media is saved with the key, it will have the reserved identifier.