Topics

All topics

Development

Autogenerated field types

This article contains
NEW TO SITEFINITY?

Out of the box, you get enhanced field editors for the following property types:

String

The string property displays an input field.

It looks in the following way:

To insert a string, use the following code sample:

using System.ComponentModel;
using Progress.Sitefinity.Renderer.Entities.Content;
using Progress.Sitefinity.Renderer.Designers.Attributes;
namespace SitefinityWebApp
{
public class DemoString
{
public string InputField { get; set; }
}
}
view raw DemoString.cs hosted with ❤ by GitHub

Boolean

The Boolean property displays a Yes/No option.

The Boolean field looks in the following way:

bool-field

To insert a Boolean field, use the following code sample:

using System.ComponentModel;
using Progress.Sitefinity.Renderer.Entities.Content;
using Progress.Sitefinity.Renderer.Designers.Attributes;
namespace SitefinityWebApp
{
public class DemoBoolean
{
//Radio button yes/no
[DisplayName("Boolean field")]
public bool CheckboxField { get; set; }
//Checkbox yes/no
[Group("Options")]
[DisplayName("Checkbox field")]
[DefaultValue(true)]
[DataType(customDataType: KnownFieldTypes.CheckBox)]
public bool CheckboxField { get; set; }
}
}
view raw DemoBoolean.cs hosted with ❤ by GitHub

Enum

The property displays a dropdown selector with all available options for the enumerator.

The selector can allow single or multiple values to be selected.

The multiple option selector looks in the following ways:

enum-multiple

The single option selector looks in the following ways:

enum-single

To insert an enumerator field, use the following code sample:

using System.ComponentModel;
using Progress.Sitefinity.Renderer.Entities.Content;
using Progress.Sitefinity.Renderer.Designers.Attributes;
namespace SitefinityWebApp
{
public class DemoEnum
{
//Single option enumerator
[DefaultValue(EnumSingle.Value2)]
public EnumSingle EnumDefaultValue { get; set; }
//Multiple option enumerator
[DefaultValue(EnumMultiple.Value1 | EnumMultiple.Value2)]
public EnumMultiple EnumDefaultValueMultiple { get; set; }
}
public enum EnumSingle
{
Value1,
Value2,
Value3
}
[Flags]
public enum EnumMultiple
{
Value1 = 0x01,
Value2 = 0x02,
Value3 = 0x04
}
}
view raw DemoEnum.cs hosted with ❤ by GitHub

Int, double

This property displays a number field that can be an integer or a floating number.

It looks in the following way:

int

To insert it, use the following code sample:

using System.ComponentModel;
using Progress.Sitefinity.Renderer.Entities.Content;
using Progress.Sitefinity.Renderer.Designers.Attributes;
namespace SitefinityWebApp
{
public class DemoInt
{
[DisplayName("Int prop")]
public int IntProp { get; set; }
}
}
view raw DemoInt.cs hosted with ❤ by GitHub

DateTime

This property displays a date-time picker.

It looks in the following way:

date-field

To insert it, use the following code sample: 

using System.ComponentModel;
using Progress.Sitefinity.Renderer.Entities.Content;
using Progress.Sitefinity.Renderer.Designers.Attributes;
namespace SitefinityWebApp
{
public class DemoDateTime
{
[Required(ErrorMessage = "This is required date.")]
public DateTime DateFieldRequired { get; set; }
}
}
view raw DemoDateTime.cs hosted with ❤ by GitHub

LinkModel

This property displays a link selector. You can use it to select external links or link to a specific Sitefinity CMS item.

The link field looks in the following way:

link-field

To insert a link fields, use the following code:

using System.ComponentModel;
using Progress.Sitefinity.Renderer.Entities.Content;
using Progress.Sitefinity.Renderer.Designers.Attributes;
namespace SitefinityWebApp
{
public class DemoLinkModel
{
[Required]
public LinkModel LinkRequired { get; set; }
}
}
view raw DemoLinkModel.cs hosted with ❤ by GitHub

MixedContentContext

You use this property to select content, such as news or pages.
This field type works with the ContentAttribute and sets the property to behave as an item selector. This selector can work with different types of providers and you can configure it to display live or draft data.

You can use the MixedContentContext to create a selector for the following:

  • Pages
  • Content items
  • Media items
  • Dynamic content items
  • Taxonomies
  • Custom taxonomies

You can also:

  • Control whether single or multiple selection is allowed
  • Control whether to display live or draft data in the selectors.
    You cannot do this for pages and media items

The following are examples of how some content selectors look like:

Pages selector

page-selector

Images selector

image-selector

To insert a content selector, use the following code sample:

using System.ComponentModel;
using Progress.Sitefinity.Renderer.Entities.Content;
using Progress.Sitefinity.Renderer.Designers.Attributes;
namespace SitefinityWebApp
{
public class DemoMixedContentContext
{
[Content(Type = KnownContentTypes.News)]
public MixedContentContext News { get; set; }
[Content(Type = KnownContentTypes.News, LiveData = true)]
public MixedContentContext NewsLive { get; set; }
[Content(Type = KnownContentTypes.Pages, AllowMultipleItemsSelection = false)]
public MixedContentContext Page { get; set; }
[Content(Type = "Telerik.Sitefinity.DynamicTypes.Model.Pressreleases.PressRelease")]
public MixedContentContext PressReleases { get; set; }
[Content(Type = KnownContentTypes.Images)]
public MixedContentContext Images { get; set; }
[TaxonomyContent(Type = KnownContentTypes.Tags)]
public MixedContentContext Tags { get; set; }
[TaxonomyContent(Type = "GeographicalRegions")]
public MixedContentContext GeographicalRegions { get; set; }
}
}
view raw DemoMixedContentContext.cs hosted with ❤ by GitHub

Complex objects

A complex object is a property that consists of simpler properties. Sitefinity CMS automatically generates editors for the them, depending on their types, and displays them in a row. If the properties constructing the complex object are four or less, they are displayed in one row. 

The following screenshot displays a complex object with two properties of types string and int:

complex-object

The following screenshot displays a complex object that has one property and another complex object, which in turn, has two properties:

multilevel-complex-object

To enable the persistence of complex objects, you must ensure that the properties that hold complex objects:

  • are decorated with the attribute [TypeConverter(typeof(ExpandableObjectConverter))]
  • have their default value initialized in the constructor or inline

To insert a complex object, use the following code sample:

using System.ComponentModel;
using Progress.Sitefinity.Renderer.Entities.Content;
using Progress.Sitefinity.Renderer.Designers.Attributes;
namespace SitefinityWebApp
{
public class DemoComplexObjects
{
public ComplexObject Complex { get; set; }
public MultiLevelComplexObject MultiLevelComplexObject { get; set; }
public IList<string> List { get; set; }
public IList<ComplexObject> ListComplexObject { get; set; }
public IList<ComplexObjectNoDefaults> ListComplexObjectNoDefaults { get; set; }
}
public class ComplexObject
{
[DisplayName("String prop")]
[DefaultValue("test")]
public string ChildString { get; set; }
[DisplayName("Int prop")]
[DefaultValue(42)]
public int ChildInt { get; set; }
}
public class ComplexObjectNoDefaults
{
[DisplayName("Boolean prop")]
public bool BoolProp { get; set; }
[DisplayName("Int prop")]
public int ChildInt { get; set; }
}
public class MultiLevelComplexObject
{
[DisplayName("String prop")]
[DefaultValue("testouter")]
public string ChildString { get; set; }
[DisplayName("Child complex prop")]
public ComplexObject ChildComplexObject { get; set; }
}
}
view raw DemoComplexObjects.cs hosted with ❤ by GitHub

List

You use this property to add a list section. A list can contain only strings or only complex objects.

A list is declared as List<T> in the code. The generic parameter in the List<T> property can be of type string or a complex object with primitive properties. Complex properties with non-primitive types are not supported.

To insert a list, use the following code sample:

using System.ComponentModel;
using Progress.Sitefinity.Renderer.Entities.Content;
using Progress.Sitefinity.Renderer.Designers.Attributes;
namespace SitefinityWebApp
{
public class DemoList
{
public IList<string> List { get; set; }
public IList<ComplexObject> ListComplexObject { get; set; }
}
}
view raw DemoList.cs hosted with ❤ by GitHub

Other types

All other types are displayed using a text field where you can type your values.

Want to learn more?

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?

Next article

Customize autogenerated fields