View Source

Class BlockGridPropertyValueConverter

Inheritance

System.Object

PropertyValueConverterBase

Namespace: Umbraco.Cms.Core.PropertyEditors.ValueConverters

Assembly: Umbraco.Infrastructure.dll

Syntax

public class BlockGridPropertyValueConverter : PropertyValueConverterBase, IDeliveryApiPropertyValueConverter, IPropertyValueConverter, IDiscoverable

Constructors

BlockGridPropertyValueConverter(IProfilingLogger, BlockEditorConverter, IJsonSerializer, IApiElementBuilder, BlockGridPropertyValueConstructorCache)

Declaration

public BlockGridPropertyValueConverter(IProfilingLogger proflog, BlockEditorConverter blockConverter, IJsonSerializer jsonSerializer, IApiElementBuilder apiElementBuilder, BlockGridPropertyValueConstructorCache constructorCache)

Parameters

Type	Name	Description
IProfilingLogger	proflog
BlockEditorConverter	blockConverter
IJsonSerializer	jsonSerializer
IApiElementBuilder	apiElementBuilder
BlockGridPropertyValueConstructorCache	constructorCache

BlockGridPropertyValueConverter(IProfilingLogger, BlockEditorConverter, IJsonSerializer, IApiElementBuilder, BlockGridPropertyValueConstructorCache, IVariationContextAccessor, BlockEditorVarianceHandler)

Declaration

public BlockGridPropertyValueConverter(IProfilingLogger proflog, BlockEditorConverter blockConverter, IJsonSerializer jsonSerializer, IApiElementBuilder apiElementBuilder, BlockGridPropertyValueConstructorCache constructorCache, IVariationContextAccessor variationContextAccessor, BlockEditorVarianceHandler blockEditorVarianceHandler)

Parameters

Type	Name	Description
IProfilingLogger	proflog
BlockEditorConverter	blockConverter
IJsonSerializer	jsonSerializer
IApiElementBuilder	apiElementBuilder
BlockGridPropertyValueConstructorCache	constructorCache
IVariationContextAccessor	variationContextAccessor
BlockEditorVarianceHandler	blockEditorVarianceHandler

Methods

ConvertIntermediateToDeliveryApiObject(IPublishedElement, IPublishedPropertyType, PropertyCacheLevel, Object, Boolean, Boolean)

Converts a property intermediate value to an Object value for Delivery API representation.

Declaration

public object ConvertIntermediateToDeliveryApiObject(IPublishedElement owner, IPublishedPropertyType propertyType, PropertyCacheLevel referenceCacheLevel, object inter, bool preview, bool expanding)

Parameters

Type	Name	Description
IPublishedElement	owner	The property set owning the property.
IPublishedPropertyType	propertyType	The property type.
PropertyCacheLevel	referenceCacheLevel	The reference cache level.
System.Object	inter	The intermediate value.
System.Boolean	preview	A value indicating whether conversion should take place in preview mode.
System.Boolean	expanding	A value indicating whether the property value should be expanded (if applicable).

Returns

Type	Description
System.Object	The result of the conversion.

Remarks

The converter should know how to convert a null intermediate value, or any intermediate value indicating that no value has been assigned to the property. It is up to the converter to determine what to return in that case: either null, or the default value...

The referenceCacheLevel is passed to the converter so that it can be, in turn, passed to eg a PublishedFragment constructor. It is used by the fragment and the properties to manage the cache levels of property values. It is not meant to be used by the converter.

ConvertIntermediateToObject(IPublishedElement, IPublishedPropertyType, PropertyCacheLevel, Object, Boolean)

Converts a property intermediate value to an Object value.

Declaration

public override object ConvertIntermediateToObject(IPublishedElement owner, IPublishedPropertyType propertyType, PropertyCacheLevel referenceCacheLevel, object inter, bool preview)

Parameters

Type	Name	Description
IPublishedElement	owner	The property set owning the property.
IPublishedPropertyType	propertyType	The property type.
PropertyCacheLevel	referenceCacheLevel	The reference cache level.
System.Object	inter	The intermediate value.
System.Boolean	preview	A value indicating whether conversion should take place in preview mode.

Returns

Type	Description
System.Object	The result of the conversion.

Remarks

The converter should know how to convert a null intermediate value, or any intermediate value indicating that no value has been assigned to the property. It is up to the converter to determine what to return in that case: either null, or the default value...

The referenceCacheLevel is passed to the converter so that it can be, in turn, passed to eg a PublishedFragment constructor. It is used by the fragment and the properties to manage the cache levels of property values. It is not meant to be used by the converter.

GetDeliveryApiPropertyCacheLevel(IPublishedPropertyType)

Gets the property cache level for Delivery API representation.

Declaration

public PropertyCacheLevel GetDeliveryApiPropertyCacheLevel(IPublishedPropertyType propertyType)

Parameters

Type	Name	Description
IPublishedPropertyType	propertyType	The property type.

Returns

Type	Description
PropertyCacheLevel	The property cache level.

GetDeliveryApiPropertyCacheLevelForExpansion(IPublishedPropertyType)

Gets the property cache level for Delivery API representation when expanding the property.

Declaration

public PropertyCacheLevel GetDeliveryApiPropertyCacheLevelForExpansion(IPublishedPropertyType propertyType)

Parameters

Type	Name	Description
IPublishedPropertyType	propertyType	The property type.

Returns

Type	Description
PropertyCacheLevel	The property cache level.

Remarks

Defaults to the value of GetDeliveryApiPropertyCacheLevel(IPublishedPropertyType).

GetDeliveryApiPropertyValueType(IPublishedPropertyType)

Declaration

public Type GetDeliveryApiPropertyValueType(IPublishedPropertyType propertyType)

Parameters

Type	Name	Description
IPublishedPropertyType	propertyType

Returns

Type	Description
Type

GetPropertyCacheLevel(IPublishedPropertyType)

Gets the property cache level.

Declaration

public override PropertyCacheLevel GetPropertyCacheLevel(IPublishedPropertyType propertyType)

Parameters

Type	Name	Description
IPublishedPropertyType	propertyType	The property type.

Returns

Type	Description
PropertyCacheLevel	The property cache level.

GetPropertyValueType(IPublishedPropertyType)

Gets the type of values returned by the converter.

Declaration

public override Type GetPropertyValueType(IPublishedPropertyType propertyType)

Parameters

Type	Name	Description
IPublishedPropertyType	propertyType	The property type.

Returns

Type	Description
Type	The CLR type of values returned by the converter.

Remarks

Some of the CLR types may be generated, therefore this method cannot directly return a Type object (which may not exist yet). In which case it needs to return a ModelType instance.

IsConverter(IPublishedPropertyType)

Gets a value indicating whether the converter supports a property type.

Declaration

public override bool IsConverter(IPublishedPropertyType propertyType)

Parameters

Type	Name	Description
IPublishedPropertyType	propertyType	The property type.

Returns

Type	Description
System.Boolean	A value indicating whether the converter supports a property type.