ObjectExtensionsConvert(Object, Type, CultureInfo) Method

Converts an Object specified in the obj parameter to the desired targetType.
See the Examples section of the generic ConvertTTarget(Object, CultureInfo) overload for an example.

Definition

Namespace: KGySoft.CoreLibraries
Assembly: KGySoft.CoreLibraries (in KGySoft.CoreLibraries.dll) Version: 9.0.0-preview.1

C#

public static Object? Convert(
	this Object? obj,
	Type targetType,
	CultureInfo culture = null
)

VB

<ExtensionAttribute>
Public Shared Function Convert ( 
	obj As Object,
	targetType As Type,
	Optional culture As CultureInfo = Nothing
) As Object

C++

public:
[ExtensionAttribute]
static Object^ Convert(
	Object^ obj, 
	Type^ targetType, 
	CultureInfo^ culture = nullptr
)

F#

[<ExtensionAttribute>]
static member Convert : 
        obj : Object * 
        targetType : Type * 
        ?culture : CultureInfo 
(* Defaults:
        let _culture = defaultArg culture null
*)
-> Object

Parameters

obj Object: The object to convert.
targetType Type: The desired type of the return value.
culture CultureInfo (Optional): The culture to use for the conversion. If , then the InvariantCulture will be used. This parameter is optional.
Default value: .

Return Value

Object
An object of targetType, which is the result of the conversion.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type Object. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Remarks

The method firstly tries to use registered direct conversions between source and target types, then attempts to perform the conversion via IConvertible types and registered TypeConverters. If these attempts fail, then the registered conversions tried to be used for intermediate steps, if possible. As an ultimate fallback, the String type is attempted to be used as intermediate conversion.

New conversions can be registered by the RegisterConversion extension methods.

Tip

The registered conversions are tried to be used for intermediate conversion steps if possible. For example, if a conversion is registered from DateTime to Int64, then conversions from DateTime to Double becomes automatically available using the Int64 type as an intermediate conversion step.

targetType can be even a collection type if obj is also an IEnumerable implementation. The target collection type must have either a default constructor or a constructor that can accept a list, array or dictionary as an initializer collection.

Exceptions

ArgumentException

obj cannot be converted to targetType.