A DataType is what you see in the backoffice in the Settings / DataTypes tree. The listed nodes are definitions of the DataTypes that are available to use on your PropertyTypes.

• Namespace: Umbraco.Cms.Core.Models

• Assembly: Umbraco.Core.dll

All samples in this document will require references to the following dll:

• Umbraco.Core.dll

All samples in this document will require the following using statement:

using Umbraco.Cms.Core.Models;

Constructors

new DataType(IDataEditor editor, IConfigurationEditorJsonSerializer serializer, int parentId = -1)

Constructor for creating a new DataType object where the necessary parameters are a IDataEditor and a IConfigurationEditorJsonSerializer. Optionally, the parentId can be added, if not provided the default value is -1, which means it will be created at root level.

Properties

.CreateDate

Gets or Sets a DateTime object, indicating then the given DataType was created.

.CreatorId

Gets or Sets the Id of the User who created the DataType.

.DatabaseType

Gets or Sets the DatabaseType as a ValueStorageType enum for which the DataType's value is saved as.

.Id

Returns the unique DataType ID as an Int. The ID, derived from a database identity field, isn't safe for code references as they are moved across instances. Therefore it's recommended to use Key instead.

.Key

Returns the Guid assigned to the DataType during creation. This value is unique, and should never change, even if the DataType is moved between instances.

.Level

Gets or Sets the given DataType level in the site hierarchy as an Int. DataType placed at the root of the site, will return 1, DataType right underneath will return 2, and so on.

.Name

Gets or Sets the name of the DataType as a String.

.ParentId

Gets or Sets the parent DataType Id as an Int.

.Path

Gets or Sets the path of the DataType as a String. This string contains a comma separated list of the ancestor Ids including the current contents own id at the end of the string.

.SortOrder

Returns the given DataType index, compared to sibling DataType.

.Trashed

Returns a Bool indicating whether the given DataType is currently in the recycle bin.

Represents a Dictionary Item. A Dictionary Item is what you see in the Translation / Dictionary tree.

• Namespace: Umbraco.Cms.Core.Models

• Assembly: Umbraco.Core.dll

All samples in this document will require references to the following dll:

• Umbraco.Core.dll

All samples in this document will require the following using statement:

Constructors

new DictionaryItem(string itemKey)

Constructor for creating a new DictionaryItem object where the necessary parameter is the key of the DictionaryItem as a string.

new DictionaryItem(Guid? parentId, string itemKey)

Constructor for creating a new DictionaryItem object where the necessary parameters are the parentKey as Guid and the key of the DictionaryItem as a string. Use this one if you want to create a DictionaryItem underneath another one.

Properties

.ItemKey

Gets or sets the Key for the Dictionary Item.

.ParentId

Gets or Sets a Guid? of the Dictionary Item ParentId.

.Translations

Gets or sets a IEnumerable<IDictionaryTranslation> of translations for the Dictionary Item.

Represents a Language. Installed languages can be found in the settings section.

• Namespace: Umbraco.Cms.Core.Models

• Assembly: Umbraco.Core.dll

All samples in this document will require references to the following dll:

• Umbraco.Core.dll

All samples in this document will require the following using statement:

using Umbraco.Cms.Core.Models;

Constructors

new Language(GlobalSettings globalSettings, string isoCode)

Constructor for creating a new Language object where the necessary parameter are the global settings as GlobalSettings and the isoCode as a string.

Properties

.CultureInfo

Gets the CultureInfo object for the language.

var language = new Language(globalSettings, "en-US");
CultureInfo cultureInfo = language.CultureInfo;
return cultureInfo;

.CultureName

Gets or sets the culture name of the language.

var language = new Language(globalSettings, "en-US");
string cultureName = language.CultureName;
return cultureName;

.FallbackLanguageId

Gets or sets the identifier of a fallback language. The fallback language can be used in multi-lingual scenarios, to help define fallback strategies when a value does not exist for a requested language.

var language = new Language(globalSettings, "en-US");
int? fallbackLanguageId = language.FallbackLanguageId;
return fallbackLanguageId;

.IsDefault

Gets or sets a value indicating whether the language is the default language.

var language = new Language(globalSettings, "en-US");
bool isDefault = language.IsDefault;
return isDefault;

.IsMandatory

Gets or sets a value indicating whether the language is mandatory. When a language is mandatory, a multi-lingual document cannot be published without that language being published, and unpublishing that language unpublishes the entire document.

var language = new Language(globalSettings, "en-US");
bool isMandatory = language.IsMandatory;
return isMandatory;

.IsoCode

Gets or sets the ISO code of the language.

var language = new Language(globalSettings, "en-US");
return language.IsoCode;