PropertyEditor.NullText Property

Specifies the text that a Property Editor displays when its value is null or String.Empty. WinForms Property Editors also show this text if their value is DBNull.Value.

Namespace: DevExpress.ExpressApp.Editors

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public virtual string NullText { get; set; }

VB.NET

Public Overridable Property NullText As String

Property Value

Type	Description
String	A text that a Property Editor displays when its value is null, String.Empty, or DBNull.Value (WinForms only).

Remarks

The following platform-agnostic View Controller shows how to specify this property for the “Address1” Property Editor in the Contact Detail View.

C#

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Editors;
// ...
public class CustomizeNullTextValueController : ObjectViewController<DetailView, Contact> {
    protected override void OnActivated() {
        base.OnActivated();
        PropertyEditor propertyEditor = View.FindItem("Address1") as PropertyEditor;
        if (propertyEditor != null) {
            propertyEditor.NullText = "Type your text here...";
        }
    }
}

VB.NET

Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Editors
' ...
Public Class CustomizeNullTextValueController
    Inherits ObjectViewController(Of DetailView, Contact)
    Protected Overrides Sub OnActivated()
        MyBase.OnActivated()
        Dim propertyEditor As PropertyEditor = TryCast(View.FindItem("Address1"), PropertyEditor)
        If propertyEditor IsNot Nothing Then
            propertyEditor.NullText = "Type your text here..."
        End If
    End Sub
End Class

The following image illustrates the result.

Note

You can also set the NullText property in the Model Editor.