Welcome Sign in
Microsoft Developer Network
.NET Framework Class Library
TypeConverter..::.ConvertToInvariantString Method (Object)

Updated: November 2007

Converts the specified value to a culture-invariant string representation.

Namespace:  System.ComponentModel
Assembly:  System (in System.dll)

Visual Basic (Declaration)
Public Function ConvertToInvariantString ( _
    value As Object _
) As String
Visual Basic (Usage)
Dim instance As TypeConverter
Dim value As Object
Dim returnValue As String

returnValue = instance.ConvertToInvariantString(value)
C#
public string ConvertToInvariantString(
    Object value
)
Visual C++
public:
String^ ConvertToInvariantString(
    Object^ value
)
J#
public String ConvertToInvariantString(
    Object value
)
JScript
public function ConvertToInvariantString(
    value : Object
) : String

Parameters

value
Type: System..::.Object

The Object to convert.

Return Value

Type: System..::.String

A String that represents the converted value.

ExceptionCondition
NotSupportedException

The conversion cannot be performed.

The context parameter can be used to extract additional information about the environment from which this converter is being invoked. This can be nullNothingnullptra null reference (Nothing in Visual Basic), so always check. Also, properties on the context object can return nullNothingnullptra null reference (Nothing in Visual Basic).

Depending on the implementation of the value formatter, it might be possible to pass the returned string back into the value formatter to re-create an instance of the object.

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

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Page view tracker