Tip
KGy SOFT Core Libraries Help
Type
Definition
Namespace: KGySoft.CoreLibraries
Assembly: KGySoft.CoreLibraries (in KGySoft.CoreLibraries.dll) Version: 9.0.0-preview.1
Assembly: KGySoft.CoreLibraries (in KGySoft.CoreLibraries.dll) Version: 9.0.0-preview.1
C#
public static void RegisterConversion(
this Type sourceType,
Type targetType,
Conversion conversion
)VB
<ExtensionAttribute>
Public Shared Sub RegisterConversion (
sourceType As Type,
targetType As Type,
conversion As Conversion
)C++
public:
[ExtensionAttribute]
static void RegisterConversion(
Type^ sourceType,
Type^ targetType,
Conversion^ conversion
)F#
[<ExtensionAttribute>]
static member RegisterConversion :
sourceType : Type *
targetType : Type *
conversion : Conversion -> unit Parameters
- sourceType Type
- The source Type for which the conversion can be called.
- targetType Type
- The result Type that conversion produces.
- conversion Conversion
- A Conversion delegate, which is able to perform the conversion.
Usage Note
In Visual Basic and C#, you can call this method as an instance method on any object of type Type. 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
After calling this method the Convert/TryConvert Object extension methods and Parse/TryParse String extension methods will be able to use the registered conversion between sourceType and targetType.
Calling the RegisterConversion methods for the same source and target types multiple times will override the old registered conversion with the new one.
sourceType and targetType can be interface, abstract or even a generic type definition.
Preregistered conversions:
The UnregisterConversion methods can be used to remove a registered conversion. Registered conversions can be removed in any order but always the lastly set will be the active one.
Note
If you want to permanently set a custom conversion, then it is recommended to register it at the start of your application
or service. It is also possible to register a conversion temporarily, and then restore the previous one by calling
the UnregisterConversion methods but then you must make sure there is no
running concurrent operation on a different thread that suppose to use different conversion for the same type.
- KeyValuePairTKey, TValue to another KeyValuePairTKey, TValue
- KeyValuePairTKey, TValue to DictionaryEntry
- DictionaryEntry to KeyValuePairTKey, TValue
- IEnumerableT of char to IEnumerableT of Rune (.NET Core 3.0 and above)
- IEnumerableT of Rune to IEnumerableT of char (.NET Core 3.0 and above)