OutputFormat Property

Gets or sets the mask string used to format the Value property before placing it in the Text property.

Syntax

Visual Basic
C#

'Declaration
 
Public Property OutputFormat As String

public string OutputFormat {get; set;}

Remarks

The formatting mask can only be used to format numbers and dates. There is no support for formatting alphanumeric strings.

Setting the OutputFormat in the Format event of a control's section does not catch the first record. The reason for this behaviour is that the database values are applied to the the control BEFORE the Format event. If you change the OutputFormat in the Format event, set Control.Value=Control.Value so that the OutputFormat gets reapplied.

The OutputFormat property of the TextBox control includes four sections delimited by a semicolon. Each section contains the format specifications for a different type of number:

The first section provides the format for positive numbers.
The second section provides the format for negative numbers.
The third section provides the format for Zero values.
The fourth section provides the format for Null or System.DBNull values.

Example

private void detail_Format(object sender, System.EventArgs eArgs)
{
    this.txtShippedDate.OutputFormat = "MMMM";
    this.txtShippedDate.Value = this.txtShippedDate.Value;
}

Visual Basic

Private Sub Detail1_Format(ByVal sender As Object, ByVal e As System.EventArgs) Handles Detail1.Format
    Me.txtShippedDate.OutputFormat = "MMMM"
    Me.txtShippedDate.Value = Me.txtShippedDate.Value
End Sub

Requirements

Target Platforms: 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

Reference

TextBox Class
TextBox Members

Concepts

Date, Time, and Number Formatting