Skip to main content
You are viewing help content for a version that is no longer maintained/updated.
All docs
V21.2
  • 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