BoundField.NullDisplayText Property

 

Gets or sets the caption displayed for a field when the field's value is null.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

abstract NullDisplayText : string with get, set
override NullDisplayText : string with get, set

Property Value

Type: System.String

The caption displayed for a field when the field's value is null. The default is an empty string (""), which indicates that this property is not set.

Sometimes a field's value is stored as null in the data source. You can specify a custom caption to display for fields that have a null value by setting the NullDisplayText property. If this property is not set, null field values are displayed as empty strings (""). When a record is being updated or inserted in a data-bound control, if the user enters the value specified by this property (other than an empty string) for a field in a data-bound control, that value is automatically converted to null in the data source.

System_CAPS_noteNote

To convert an empty string field value to a null value, set the ConvertEmptyStringToNull property to true.

The following code example demonstrates how to use the NullDisplayText property to specify a custom caption to display for null field values.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: