Skip to main content
All docs
V21.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

SnapSingleListItemEntity.EmptyFieldDataAlias Property

Specifies the text to show in a document instead of a blank space if a Snap field receives an empty data source record.

Namespace: DevExpress.Snap.Core.API

Assembly: DevExpress.Snap.v21.2.Core.dll

NuGet Package: DevExpress.Snap.Core

#Declaration

string EmptyFieldDataAlias { get; set; }

#Property Value

Type Description
String

A String value, specifying the empty field data alias.

#Remarks

Use the SnapSingleListItemEntity.EnableEmptyFieldDataAlias property to display the alias specified by the EmptyFieldDataAlias option.

Tip

Use the SnapImage.ShowPlaceholder property to show a placeholder instead of the blank space. This property has effect only if the SnapSingleListItemEntity.EnableEmptyFieldDataAlias property is set to false.

The table below lists scenarios when the EmptyFieldDataAlias value is displayed for different fields.

Field Name

Empty Data Source Scenario

SNTEXT

The data source does not contain the required entry

The required data entry is null or DBNull.Value

The required data entry returns an empty string.

SNHYPERLINK

The data source does not contain the data entry bound to the SnapSingleListItemEntity.DataFieldName property.

The data entry bound to the SnapSingleListItemEntity.DataFieldName property returns an empty string.

See Also