Class DataTypeService

Represents the DataType Service, which is an easy access to operations involving IDataType

Inheritance

System.Object

Namespace: Umbraco.Cms.Core.Services.Implement

Assembly: Umbraco.Core.dll

Syntax

public class DataTypeService : RepositoryService, IDataTypeService, IService

Constructors

View Source

DataTypeService(ICoreScopeProvider, ILoggerFactory, IEventMessagesFactory, IDataTypeRepository, IDataValueEditorFactory, IAuditRepository, IContentTypeRepository, IIOHelper, Lazy<IIdKeyMap>)

Declaration

public DataTypeService(ICoreScopeProvider provider, ILoggerFactory loggerFactory, IEventMessagesFactory eventMessagesFactory, IDataTypeRepository dataTypeRepository, IDataValueEditorFactory dataValueEditorFactory, IAuditRepository auditRepository, IContentTypeRepository contentTypeRepository, IIOHelper ioHelper, Lazy<IIdKeyMap> idKeyMap)

Parameters

Type	Name	Description
ICoreScopeProvider	provider
ILoggerFactory	loggerFactory
IEventMessagesFactory	eventMessagesFactory
IDataTypeRepository	dataTypeRepository
IDataValueEditorFactory	dataValueEditorFactory
IAuditRepository	auditRepository
IContentTypeRepository	contentTypeRepository
IIOHelper	ioHelper
Lazy<IIdKeyMap>	idKeyMap

View Source

DataTypeService(ICoreScopeProvider, ILoggerFactory, IEventMessagesFactory, IDataTypeRepository, IDataValueEditorFactory, IAuditRepository, IContentTypeRepository, IMediaTypeRepository, IMemberTypeRepository, IIOHelper, Lazy<IIdKeyMap>)

Declaration

public DataTypeService(ICoreScopeProvider provider, ILoggerFactory loggerFactory, IEventMessagesFactory eventMessagesFactory, IDataTypeRepository dataTypeRepository, IDataValueEditorFactory dataValueEditorFactory, IAuditRepository auditRepository, IContentTypeRepository contentTypeRepository, IMediaTypeRepository mediaTypeRepository, IMemberTypeRepository memberTypeRepository, IIOHelper ioHelper, Lazy<IIdKeyMap> idKeyMap)

Parameters

Type	Name	Description
ICoreScopeProvider	provider
ILoggerFactory	loggerFactory
IEventMessagesFactory	eventMessagesFactory
IDataTypeRepository	dataTypeRepository
IDataValueEditorFactory	dataValueEditorFactory
IAuditRepository	auditRepository
IContentTypeRepository	contentTypeRepository
IMediaTypeRepository	mediaTypeRepository
IMemberTypeRepository	memberTypeRepository
IIOHelper	ioHelper
Lazy<IIdKeyMap>	idKeyMap

Methods

View Source

Copy(IDataType, Int32)

Declaration

public Attempt<OperationResult<MoveOperationStatusType, IDataType>> Copy(IDataType copying, int containerId)

Parameters

Type	Name	Description
IDataType	copying
System.Int32	containerId

Returns

Type	Description
Attempt<OperationResult<MoveOperationStatusType, IDataType>>

View Source

Copy(IDataType, Int32, Int32)

Declaration

public Attempt<OperationResult<MoveOperationStatusType, IDataType>> Copy(IDataType copying, int containerId, int userId = -1)

Parameters

Type	Name	Description
IDataType	copying
System.Int32	containerId
System.Int32	userId

Returns

Type	Description
Attempt<OperationResult<MoveOperationStatusType, IDataType>>

View Source

CopyAsync(IDataType, Nullable<Guid>, Guid)

Copies a IDataType to a given container

Declaration

public async Task<Attempt<IDataType, DataTypeOperationStatus>> CopyAsync(IDataType toCopy, Guid? containerKey, Guid userKey)

Parameters

Type	Name	Description
IDataType	toCopy	The data type that will be copied
System.Nullable<Guid>	containerKey	The container key where the data type will be copied to.
Guid	userKey	The user that did the Copy action

Returns

Type	Description
Task<Attempt<IDataType, DataTypeOperationStatus>>

View Source

CreateAsync(IDataType, Guid)

Creates a new IDataType

Declaration

public async Task<Attempt<IDataType, DataTypeOperationStatus>> CreateAsync(IDataType dataType, Guid userKey)

Parameters

Type	Name	Description
IDataType	dataType	IDataType to create
Guid	userKey	Key of the user issuing the creation

Returns

Type	Description
Task<Attempt<IDataType, DataTypeOperationStatus>>

View Source

CreateContainer(Int32, Guid, String, Int32)

Declaration

public Attempt<OperationResult<OperationResultType, EntityContainer>> CreateContainer(int parentId, Guid key, string name, int userId = -1)

Parameters

Type	Name	Description
System.Int32	parentId
Guid	key
System.String	name
System.Int32	userId

Returns

Type	Description
Attempt<OperationResult<OperationResultType, EntityContainer>>

View Source

Delete(IDataType, Int32)

Deletes an IDataType

Declaration

public void Delete(IDataType dataType, int userId = -1)

Parameters

Type	Name	Description
IDataType	dataType	IDataType to delete
System.Int32	userId	Optional Id of the user issuing the deletion

Remarks

Please note that deleting a IDataType will remove all the IPropertyType data that references this IDataType.

View Source

DeleteAsync(Guid, Guid)

Deletes an IDataType

Declaration

public async Task<Attempt<IDataType, DataTypeOperationStatus>> DeleteAsync(Guid id, Guid userKey)

Parameters

Type	Name	Description
Guid	id	The guid Id of the IDataType to delete
Guid	userKey	Key of the user issuing the deletion

Returns

Type	Description
Task<Attempt<IDataType, DataTypeOperationStatus>>

Remarks

Please note that deleting a IDataType will remove all the IPropertyType data that references this IDataType.

View Source

DeleteContainer(Int32, Int32)

Declaration

public Attempt<OperationResult> DeleteContainer(int containerId, int userId = -1)

Parameters

Type	Name	Description
System.Int32	containerId
System.Int32	userId

Returns

Type	Description
Attempt<OperationResult>

View Source

FilterAsync(String, String, String, Int32, Int32)

Gets multiple IDataType objects by their unique keys.

Declaration

public Task<PagedModel<IDataType>> FilterAsync(string name = null, string editorUiAlias = null, string editorAlias = null, int skip = 0, int take = 100)

Parameters

Type	Name	Description
System.String	name	Name to filter by.
System.String	editorUiAlias	Editor ui alias to filter by.
System.String	editorAlias	Editor alias to filter by.
System.Int32	skip	Number of items to skip.
System.Int32	take	Number of items to take.

Returns

Type	Description
Task<PagedModel<IDataType>>	An attempt with the requested data types.

View Source

GetAll(Int32[])

Gets all IDataType objects or those with the ids passed in

Declaration

public IEnumerable<IDataType> GetAll(params int[] ids)

Parameters

Type	Name	Description
System.Int32[]	ids	Optional array of Ids

Returns

Type	Description
IEnumerable<IDataType>	An enumerable list of IDataType objects

View Source

GetAllAsync(Guid[])

Gets multiple IDataType objects by their unique keys.

Declaration

public Task<IEnumerable<IDataType>> GetAllAsync(params Guid[] keys)

Parameters

Type	Name	Description
Guid[]	keys	The keys to get datatypes by.

Returns

Type	Description
Task<IEnumerable<IDataType>>	An attempt with the requested data types.

View Source

GetAsync(Guid)

Gets an IDataType by its unique guid Id

Declaration

public Task<IDataType> GetAsync(Guid id)

Parameters

Type	Name	Description
Guid	id	Unique guid Id of the DataType

Returns

Type	Description
Task<IDataType>	IDataType

View Source

GetAsync(String)

Gets an IDataType by its Name

Declaration

public Task<IDataType> GetAsync(string name)

Parameters

Type	Name	Description
System.String	name	Name of the IDataType

Returns

Type	Description
Task<IDataType>	IDataType

View Source

GetByEditorAlias(String)

Gets a IDataType by its control Id

Declaration

public IEnumerable<IDataType> GetByEditorAlias(string propertyEditorAlias)

Parameters

Type	Name	Description
System.String	propertyEditorAlias	Alias of the property editor

Returns

Type	Description
IEnumerable<IDataType>	Collection of IDataType objects with a matching control id

View Source

GetByEditorAliasAsync(String)

Gets all IDataType for a given property editor

Declaration

public Task<IEnumerable<IDataType>> GetByEditorAliasAsync(string propertyEditorAlias)

Parameters

Type	Name	Description
System.String	propertyEditorAlias	Alias of the property editor

Returns

Type	Description
Task<IEnumerable<IDataType>>	Collection of IDataType configured for the property editor

View Source

GetByEditorAliasAsync(String[])

Gets all IDataType for a set of property editors

Declaration

public async Task<IEnumerable<IDataType>> GetByEditorAliasAsync(string[] propertyEditorAlias)

Parameters

Type	Name	Description
System.String[]	propertyEditorAlias	Aliases of the property editors

Returns

Type	Description
Task<IEnumerable<IDataType>>	Collection of IDataType configured for the property editors

View Source

GetByEditorUiAlias(String)

Gets all IDataType for a given editor UI alias

Declaration

public Task<IEnumerable<IDataType>> GetByEditorUiAlias(string editorUiAlias)

Parameters

Type	Name	Description
System.String	editorUiAlias	The UI Alias to query by.

Returns

Type	Description
Task<IEnumerable<IDataType>>	Collection of IDataType which has the UI alias.

View Source

GetContainer(Guid)

Declaration

public EntityContainer GetContainer(Guid containerId)

Parameters

Type	Name	Description
Guid	containerId

Returns

Type	Description
EntityContainer

View Source

GetContainer(Int32)

Declaration

public EntityContainer GetContainer(int containerId)

Parameters

Type	Name	Description
System.Int32	containerId

Returns

Type	Description
EntityContainer

View Source

GetContainers(Int32[])

Declaration

public IEnumerable<EntityContainer> GetContainers(int[] containerIds)

Parameters

Type	Name	Description
System.Int32[]	containerIds

Returns

Type	Description
IEnumerable<EntityContainer>

View Source

GetContainers(String, Int32)

Declaration

public IEnumerable<EntityContainer> GetContainers(string name, int level)

Parameters

Type	Name	Description
System.String	name
System.Int32	level

Returns

Type	Description
IEnumerable<EntityContainer>

View Source

GetContainers(IDataType)

Declaration

public IEnumerable<EntityContainer> GetContainers(IDataType dataType)

Parameters

Type	Name	Description
IDataType	dataType

Returns

Type	Description
IEnumerable<EntityContainer>

View Source

GetDataType(Int32)

Gets a IDataType by its Id

Declaration

public IDataType GetDataType(int id)

Parameters

Type	Name	Description
System.Int32	id	Id of the IDataType

Returns

Type	Description
IDataType	IDataType

View Source

GetDataType(String)

Gets a IDataType by its Name

Declaration

public IDataType GetDataType(string name)

Parameters

Type	Name	Description
System.String	name	Name of the IDataType

Returns

Type	Description
IDataType	IDataType

View Source

GetListViewReferences(Int32)

Declaration

public IReadOnlyDictionary<Udi, IEnumerable<string>> GetListViewReferences(int id)

Parameters

Type	Name	Description
System.Int32	id

Returns

Type	Description
IReadOnlyDictionary<Udi, IEnumerable<System.String>>

View Source

GetPagedRelationsAsync(Guid, Int32, Int32)

Gets a paged result of items which are in relation with the current data type.

Declaration

public Task<PagedModel<RelationItemModel>> GetPagedRelationsAsync(Guid key, int skip, int take)

Parameters

Type	Name	Description
Guid	key	The identifier of the data type to retrieve relations for.
System.Int32	skip	The amount of items to skip
System.Int32	take	The amount of items to take.

Returns

Type	Description
Task<PagedModel<RelationItemModel>>	A paged result of RelationItemModel objects.

Remarks

Note that the model and method signature here aligns with with how we handle retrieval of concrete Umbraco relations based on documents, media and members in ITrackedReferencesService. The intention is that we align data type relations with these so they can be handled polymorphically at the management API and backoffice UI level.

View Source

GetReferences(Int32)

Returns a dictionary of content type Udis and the property type aliases that use a IDataType

Declaration

public IReadOnlyDictionary<Udi, IEnumerable<string>> GetReferences(int id)

Parameters

Type	Name	Description
System.Int32	id

Returns

Type	Description
IReadOnlyDictionary<Udi, IEnumerable<System.String>>

View Source

GetReferencesAsync(Guid)

Returns a dictionary of content type Udis and the property type aliases that use a IDataType

Declaration

public async Task<Attempt<IReadOnlyDictionary<Udi, IEnumerable<string>>, DataTypeOperationStatus>> GetReferencesAsync(Guid id)

Parameters

Type	Name	Description
Guid	id	The guid Id of the IDataType

Returns

Type	Description
Task<Attempt<IReadOnlyDictionary<Udi, IEnumerable<System.String>>, DataTypeOperationStatus>>

View Source

Move(IDataType, Int32)

Declaration

public Attempt<OperationResult<MoveOperationStatusType>> Move(IDataType toMove, int parentId)

Parameters

Type	Name	Description
IDataType	toMove
System.Int32	parentId

Returns

Type	Description
Attempt<OperationResult<MoveOperationStatusType>>

View Source

MoveAsync(IDataType, Nullable<Guid>, Guid)

Declaration

public async Task<Attempt<IDataType, DataTypeOperationStatus>> MoveAsync(IDataType toMove, Guid? containerKey, Guid userKey)

Parameters

Type	Name	Description
IDataType	toMove
System.Nullable<Guid>	containerKey
Guid	userKey

Returns

Type	Description
Task<Attempt<IDataType, DataTypeOperationStatus>>

View Source

RenameContainer(Int32, String, Int32)

Declaration

public Attempt<OperationResult<OperationResultType, EntityContainer>> RenameContainer(int id, string name, int userId = -1)

Parameters

Type	Name	Description
System.Int32	id
System.String	name
System.Int32	userId

Returns

Type	Description
Attempt<OperationResult<OperationResultType, EntityContainer>>

View Source

Save(IEnumerable<IDataType>, Int32)

Saves a collection of IDataType

Declaration

public void Save(IEnumerable<IDataType> dataTypeDefinitions, int userId)

Parameters

Type	Name	Description
IEnumerable<IDataType>	dataTypeDefinitions	IDataType to save
System.Int32	userId	Id of the user issuing the save

View Source

Save(IDataType, Int32)

Saves an IDataType

Declaration

public void Save(IDataType dataType, int userId = -1)

Parameters

Type	Name	Description
IDataType	dataType	IDataType to save
System.Int32	userId	Id of the user issuing the save

View Source

SaveContainer(EntityContainer, Int32)

Declaration

public Attempt<OperationResult> SaveContainer(EntityContainer container, int userId = -1)

Parameters

Type	Name	Description
EntityContainer	container
System.Int32	userId

Returns

Type	Description
Attempt<OperationResult>

View Source

UpdateAsync(IDataType, Guid)

Updates an existing IDataType

Declaration

public async Task<Attempt<IDataType, DataTypeOperationStatus>> UpdateAsync(IDataType dataType, Guid userKey)

Parameters

Type	Name	Description
IDataType	dataType	IDataType to update
Guid	userKey	Key of the user issuing the update

Returns

Type	Description
Task<Attempt<IDataType, DataTypeOperationStatus>>

View Source

ValidateConfigurationData(IDataType)

Performs validation for the configuration data of a given data type.

Declaration

public IEnumerable<ValidationResult> ValidateConfigurationData(IDataType dataType)

Parameters

Type	Name	Description
IDataType	dataType	The data type whose configuration to validate.

Returns

Type	Description
IEnumerable<System.ComponentModel.DataAnnotations.ValidationResult>	One or more System.ComponentModel.DataAnnotations.ValidationResult if the configuration data is invalid, an empty collection otherwise.