View Source

Class Property

Represents a property.

Inheritance

System.Object

BeingDirtyBase

EntityBase

Namespace: Umbraco.Cms.Core.Models

Assembly: Umbraco.Core.dll

Syntax

[DataContract(IsReference = true)]
public class Property : EntityBase, IProperty, IEntity, IDeepCloneable, IRememberBeingDirty, ICanBeDirty

Constructors

Property(Int32, IPropertyType)

Initializes a new instance of the Property class.

Declaration

public Property(int id, IPropertyType propertyType)

Parameters

Type	Name	Description
System.Int32	id
IPropertyType	propertyType

Property(IPropertyType)

Initializes a new instance of the Property class.

Declaration

public Property(IPropertyType propertyType)

Parameters

Type	Name	Description
IPropertyType	propertyType

Properties

Alias

Returns the Alias of the PropertyType, which this Property is based on

Declaration

[DataMember]
public string Alias { get; }

Property Value

Type	Description
System.String

PropertyType

Returns the PropertyType, which this Property is based on

Declaration

[IgnoreDataMember]
public IPropertyType PropertyType { get; }

Property Value

Type	Description
IPropertyType

PropertyTypeId

Returns the Id of the PropertyType, which this Property is based on

Declaration

[IgnoreDataMember]
public int PropertyTypeId { get; }

Property Value

Type	Description
System.Int32

Values

Gets the list of values.

Declaration

[DataMember]
public IReadOnlyCollection<IPropertyValue> Values { get; set; }

Property Value

Type	Description
IReadOnlyCollection<IPropertyValue>

ValueStorageType

Returns the DatabaseType that the underlaying DataType is using to store its values

Declaration

[IgnoreDataMember]
public ValueStorageType ValueStorageType { get; }

Property Value

Type	Description
ValueStorageType

Remarks

Only used internally when saving the property value.

Methods

ConvertAssignedValue(Object)

Declaration

public object ConvertAssignedValue(object value)

Parameters

Type	Name	Description
System.Object	value

Returns

Type	Description
System.Object

CreateWithValues(Int32, IPropertyType, Property.InitialPropertyValue[])

Creates a new Property instance for existing IProperty

Declaration

public static Property CreateWithValues(int id, IPropertyType propertyType, params Property.InitialPropertyValue[] values)

Parameters

Type	Name	Description
System.Int32	id
IPropertyType	propertyType
Property.InitialPropertyValue[]	values	Generally will contain a published and an unpublished property values

Returns

Type	Description
Property

GetValue(String, String, Boolean)

Gets the value.

Declaration

public object GetValue(string culture = null, string segment = null, bool published = false)

Parameters

Type	Name	Description
System.String	culture
System.String	segment
System.Boolean	published

Returns

Type	Description
System.Object

PerformDeepClone(Object)

Declaration

protected override void PerformDeepClone(object clone)

Parameters

Type	Name	Description
System.Object	clone

PublishPartialValues(IDataEditor, String)

Declaration

public void PublishPartialValues(IDataEditor dataEditor, string culture)

Parameters

Type	Name	Description
IDataEditor	dataEditor
System.String	culture

PublishValues(String, String)

Declaration

public void PublishValues(string culture = "*", string segment = "*")

Parameters

Type	Name	Description
System.String	culture
System.String	segment

SetValue(Object, String, String)

Sets a value.

Declaration

public bool SetValue(object value, string culture = null, string segment = null)

Parameters

Type	Name	Description
System.Object	value
System.String	culture
System.String	segment

Returns

Type	Description
System.Boolean	true if the value was set (updated), false otherwise.

Remarks

A false return value does not indicate failure, but rather that the property value was not changed (i.e. the value passed in was equal to the current property value).

UnpublishValues(String, String)

Declaration

public void UnpublishValues(string culture = "*", string segment = "*")

Parameters

Type	Name	Description
System.String	culture
System.String	segment