ObjectExtensions.Convert Method (Object, Type, CultureInfo)


ObjectExtensionsConvert Method (Object, Type, CultureInfo)	KGy SOFT Core Libraries Help

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.

Namespace: KGySoft.CoreLibraries
Assembly: KGySoft.CoreLibraries (in KGySoft.CoreLibraries.dll) Version: 7.0.0-preview.3

Syntax

C++

Copy

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

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

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

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

Parameters

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

Return Value

Type: 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).

Exceptions

Exception	Condition
ArgumentException	obj cannot be converted to targetType.

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.

Reference

ObjectExtensions Class

Convert Overload

KGySoft.CoreLibraries Namespace

ObjectExtensionsAddLanguageSpecificTextSet("LST9EC90B79_0?cpp=::|nu=.");Convert Method (Object, Type, CultureInfo)

Parameters

Return Value

Usage Note

Reference

ObjectExtensionsConvert Method (Object, Type, CultureInfo)