MaximumChar Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The MaximumChar property returns the maximum number of characters used when a value of the data type is converted to a character string.

Syntax

object.MaximumChar

Parts

  • object
    An expression that evaluates to an object in the Applies To list

Data Type

Long

Modifiable

Read-only

Prototype (C/C++)

HRESULT GetMaximumChar(LPLONG pRetVal);

Remarks

Characters such as string terminators are not included in the character count.

The MaximumChar property returns a character count, not the number of bytes required to store a string of that length. The MaximumLength property can return the number of bytes required to store a value for a data type.

For example, for the SystemDatatype object that references the nchar data type, MaximumChar returns 4,000. The MaximumLength property for the object returns 8,000, because each nchar character requires two bytes for storage.

Applies To: