RepositoryItem.NullText Property

Gets or sets the text that presents the editor’s null value (null, System.DBNull.Value and RepositoryItemDateEdit.NullDate - for DateEdit).

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v18.2.dll

Declaration

C#

[DXCategory("Behavior")]
public virtual string NullText { get; set; }

VB.NET

<DXCategory("Behavior")>
Public Overridable Property NullText As String

Property Value

Type	Description
String	The string displayed in the edit box when the edit value equals null, System.DBNull.Value or RepositoryItemDateEdit.NullDate (for DateEdit controls).

Remarks

Use the NullText property to present the editor’s null value with custom text.

Use the RepositoryItemTextEdit.NullValuePrompt property to display a hint in an editor when its value is not set.

See the RepositoryItemTextEdit.NullValuePrompt topic to learn more about the difference between these properties.

The NullText property is not supported for a CheckedComboBoxEdit control. This control’s value cannot be set to null.

For lookup editors (LookUpEditBase descendants), the NullText property’s default value is obtained from localization resources (the localization string ID is “StringId.LookUpEditValueIsNull”). The property’s default value is “[EditValue is null]” in the English culture.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the NullText property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

lookup-editors-combobox-mode-t378371/CS/Lookup-ComboboxMode/Form1.cs#L26

lookUpEdit1.EditValueChanged += LookUpEdit1_EditValueChanged; ;
lookUpEdit1.Properties.NullText = "(select or type value)";

Reporting_how-to-provide-custom-editors-for-the-report-parameters-e390/CS/XtraReport1.cs#L27

lookUpEdit.Properties.Columns.Add(new LookUpColumnInfo("CategoryName", 0, "Category Name"));
lookUpEdit.Properties.NullText = "<Select Category>";

custom-editor-timeedit-with-a-popup-window-e4060/CS/TimeEditControl/Form1.cs#L21

lookUpEdit1.Properties.DataSource = skinList;
lookUpEdit1.Properties.NullText = "Choose skin";
lookUpEdit1.EditValueChanged += lookUpEdit1_EditValueChanged;

how-to-implement-incremental-search-for-an-edit-form-via-the-lookupedit-e707/CS/Form1.cs#L295

lookUpEdit1.Properties.Buttons.Clear();
lookUpEdit1.Properties.NullText = "[Type a contact to find]";
lookUpEdit1.Properties.AllowNullInput = DevExpress.Utils.DefaultBoolean.True;

objectdatasource-how-to-provide-a-custom-parameter-editor-t246429/CS/CustomRepositoryItem/MyRepositoryItemsProvider.cs#L39

lookUpEdit.ValueMember = "Value";
lookUpEdit.NullText = Resources.MyRepositoryItemsProvider_GetRepositoryItem_Nobody;
lookUpEdit.AllowNullInput = DefaultBoolean.True;

VB.NET

lookup-editors-combobox-mode-t378371/VB/Lookup-ComboboxMode/Form1.vb#L29

lookUpEdit1.Properties.NullText = "(select or type value)"

Reporting_how-to-provide-custom-editors-for-the-report-parameters-e390/VB/XtraReport1.vb#L28

lookUpEdit.Properties.Columns.Add(New LookUpColumnInfo("CategoryName", 0, "Category Name"))
lookUpEdit.Properties.NullText = "<Select Category>"

custom-editor-timeedit-with-a-popup-window-e4060/VB/TimeEditControl/Form1.vb#L20

lookUpEdit1.Properties.DataSource = skinList
lookUpEdit1.Properties.NullText = "Choose skin"
AddHandler lookUpEdit1.EditValueChanged, AddressOf lookUpEdit1_EditValueChanged

how-to-implement-incremental-search-for-an-edit-form-via-the-lookupedit-e707/VB/Form1.vb#L280

lookUpEdit1.Properties.Buttons.Clear()
lookUpEdit1.Properties.NullText = "[Type a contact to find]"
lookUpEdit1.Properties.AllowNullInput = DevExpress.Utils.DefaultBoolean.True

objectdatasource-how-to-provide-a-custom-parameter-editor-t246429/VB/CustomRepositoryItem/MyRepositoryItemsProvider.vb#L54

lookUpEdit.ValueMember = "Value"
lookUpEdit.NullText = My.Resources.MyRepositoryItemsProvider_GetRepositoryItem_Nobody
lookUpEdit.AllowNullInput = DefaultBoolean.True