This documentation is archived and is not being maintained.

TemplateField.ConvertEmptyStringToNull Property

Gets or sets a value indicating whether the value that the TemplateField object is bound to should be converted to a null reference (Nothing in Visual Basic) if it is Empty.

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

public virtual bool ConvertEmptyStringToNull { get; set; }
/** @property */
public boolean get_ConvertEmptyStringToNull ()

/** @property */
public void set_ConvertEmptyStringToNull (boolean value)

public function get ConvertEmptyStringToNull () : boolean

public function set ConvertEmptyStringToNull (value : boolean)

Not applicable.

Property Value

true if the value that the TemplateField is bound to should be converted to a null reference (Nothing in Visual Basic) when it is Empty; otherwise, false. The default value is false.

This property applies to two-way data-binding statements made in the template. The conversion is done after extracting the values from the two-way bound template, and before passing the values to the data source for an update or insertion operation.

For example, a user might enter an empty string ("") for a field value when updating or inserting records. Use the ConvertEmptyStringToNull property to specify whether an empty string value is automatically converted to a null reference (Nothing in Visual Basic) when the data field is updated in the data source.

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Show: