This documentation is archived and is not being maintained.

Unit Constructor (String)

Initializes a new instance of the Unit structure with the specified length.

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

public:
Unit(
	String^ value
)

Parameters

value
Type: System::String
A string that represents the length of the Unit.

ExceptionCondition
ArgumentOutOfRangeException

The specified length is not between -32768 and 32767.

FormatException

value is not a valid CSS-compliant unit expression.

Use this constructor to create and initialize a new instance of the Unit structure using the specified length. The length is specified in two parts, the length's value and the length's unit type. For example, "200Cm" represents a length of 200 centimeters. You can use any valid CSS-compliant unit expression.

The following table lists the common unit types.

Unit type

Description

Pixel

Length in pixels.

Point

Length in points. A point represents 1/72 of an inch.

Inch

Length in inches.

Mm

Length in millimeters.

Cm

Length in centimeters.

Percentage

Length as a percentage of the parent element.

The following table shows initial property values for an instance of Unit.

Property

Initial Value

Type

The unit type specified in value.

Value

The value specified in value.

Caution noteCaution

If value is not between -32768 and 32767, an exception is thrown.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: