LanguagePrimitives.ConvertTo Method

public:
 static System::Object ^ ConvertTo(System::Object ^ valueToConvert, Type ^ resultType);

public:
 static Platform::Object ^ ConvertTo(Platform::Object ^ valueToConvert, Platform::Type ^ resultType);

public static object ConvertTo (object valueToConvert, Type resultType);

static member ConvertTo : obj * Type -> obj

Public Shared Function ConvertTo (valueToConvert As Object, resultType As Type) As Object

Parameters

Returns

Object

converted value

Exceptions

Remarks

A null valueToConvert can be converted to :

string          -   returns "" 

char            -   returns '\0'

numeric types   -   returns 0 converted to the appropriate type

boolean         -   returns LanguagePrimitives.IsTrue(null)

PSObject       -   returns new PSObject()) 

array           -   returns an array with null in array[0]

non value types -   returns null

The following conversions are considered language standard and cannot be customized:

- from derived to base class            -   returns valueToConvert intact

- to PSObject                          -   returns PSObject.AsPSObject(valueToConvert)

- to void                               -   returns AutomationNull.Value

- from array/IEnumerable to array       -   tries to convert array/IEnumerable elements

- from object of type X to array of X   -   returns an array with object as its only element

- to bool                               -   returns LanguagePrimitives.IsTrue(valueToConvert)

- to string                             -   returns a string representation of the object. 

                                            In the particular case of a number to string, 

                                            the conversion is culture invariant.

- from IDictionary to Hashtable         -   uses the Hashtable constructor

- to XmlDocument                        -   creates a new XmlDocument with the 

                                            string representation of valueToConvert

- from string to char[]                 -   returns ((string)valueToConvert).ToCharArray()

- from string to RegEx                  -   creates a new RegEx with the string

- from string to Type                   -   looks up the type in the minishell's assemblies

- from empty string to numeric          -   returns 0 converted to the appropriate type

- from string to numeric                -   returns a culture invariant conversion

- from ScriptBlock to Delegate          -   returns a delegate wrapping that scriptblock.

- from Integer to Enumeration           -   Uses Enum.ToObject

- to WMI                                -   Instantiate a WMI instance using 

                                            System.Management.ManagementObject

- to WMISearcher                        -   returns objects from running WQL query with the

                                            string representation of valueToConvert. The

                                            query is run using ManagementObjectSearcher Class.

- to WMIClass                           -   returns ManagementClass represented by the

                                            string representation of valueToConvert.

- to ADSI                               -   returns DirectoryEntry  represented by the

                                            string representation of valueToConvert.

- to ADSISearcher                       -   return DirectorySearcher representd by the

                                            string representation of valueToConvert.

If none of the cases above is true, the following is considered in order:

1. TypeConverter and PSTypeConverter

2. the Parse methods if the valueToConvert is a string

3. Constructors in resultType that take one parameter with type valueToConvert.GetType()

4. Implicit and explicit cast operators

5. IConvertible

If any operation above throws an exception, this exception will be wrapped into a

PSInvalidCastException and thrown resulting in no further conversion attempt.

public:
 static System::Object ^ ConvertTo(System::Object ^ valueToConvert, Type ^ resultType, IFormatProvider ^ formatProvider);

public static object ConvertTo (object valueToConvert, Type resultType, IFormatProvider formatProvider);

static member ConvertTo : obj * Type * IFormatProvider -> obj

Public Shared Function ConvertTo (valueToConvert As Object, resultType As Type, formatProvider As IFormatProvider) As Object

Parameters

Returns

Object

converted value

Exceptions

Remarks

A null valueToConvert can be converted to :

string          -   returns "" 

char            -   returns '\0'

numeric types   -   returns 0 converted to the appropriate type

boolean         -   returns LanguagePrimitives.IsTrue(null)

PSObject       -   returns new PSObject()) 

array           -   returns an array with null in array[0]

non value types -   returns null

The following conversions are considered language standard and cannot be customized:

- from derived to base class            -   returns valueToConvert intact

- to PSObject                          -   returns PSObject.AsPSObject(valueToConvert)

- to void                               -   returns AutomationNull.Value

- from array/IEnumerable to array       -   tries to convert array/IEnumerable elements

- from object of type X to array of X   -   returns an array with object as its only element

- to bool                               -   returns LanguagePrimitives.IsTrue(valueToConvert)

- to string                             -   returns a string representation of the object. 

                                            In the particular case of a number to string, 

                                            the conversion is culture invariant.

- from IDictionary to Hashtable         -   uses the Hashtable constructor

- to XmlDocument                        -   creates a new XmlDocument with the 

                                            string representation of valueToConvert

- from string to char[]                 -   returns ((string)valueToConvert).ToCharArray()

- from string to RegEx                  -   creates a new RegEx with the string

- from string to Type                   -   looks up the type in the minishell's assemblies

- from empty string to numeric          -   returns 0 converted to the appropriate type

- from string to numeric                -   returns a culture invariant conversion

- from ScriptBlock to Delegate          -   returns a delegate wrapping that scriptblock.

- from Integer to Enumeration           -   Uses Enum.ToObject

If none of the cases above is true, the following is considered in order:

1. TypeConverter and PSTypeConverter

2. the Parse methods if the valueToConvert is a string

3. Constructors in resultType that take one parameter with type valueToConvert.GetType()

4. Implicit and explicit cast operators

5. IConvertible

If any operation above throws an exception, this exception will be wrapped into a

PSInvalidCastException and thrown resulting in no further conversion attempt.

public:
generic <typename T>
 static T ConvertTo(System::Object ^ valueToConvert);

public:
generic <typename T>
 static T ConvertTo(Platform::Object ^ valueToConvert);

template <typename T>
 static T ConvertTo(winrt::Windows::Foundation::IInspectable const & valueToConvert);

public static T ConvertTo<T> (object valueToConvert);

static member ConvertTo : obj -> 'T

Public Shared Function ConvertTo(Of T) (valueToConvert As Object) As T

Type Parameters

Parameters

Returns

T