NullText Property (UltraDateTimeEditor)

Returns or sets the text to be used by the control when the value is null.

Syntax

Visual Basic

'Declaration
 
Public Property NullText As String

C#

public string NullText {get; set;}

Remarks

When the control's value is null (Nothing in VB), the control displays an empty string by default. The NullText property enables the end developer to change the text that is displayed for null values (for example, '(NULL)' or '(none)').

Example

This example configures the control to support a null value

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinEditors

    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click

        '	Set the Nullable property to true so the control's Value property
        '	can be set to Nothing
        Me.UltraDateTimeEditor1.Nullable = True

        '	Set the NullText property so the end user knows that there is
        '	no valid date selected
        Me.UltraDateTimeEditor1.NullText = "[no date selected]"

    End Sub

C#

using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinEditors;

		private void button1_Click(object sender, System.EventArgs e)
		{
			//	Set the Nullable property to true so the control's Value property
			//	can be set to null
			this.ultraDateTimeEditor1.Nullable = true;

			//	Set the NullText property so the end user knows that there is
			//	no valid date selected
			this.ultraDateTimeEditor1.NullText = "[no date selected]";
		}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2