Skip to content

RxConverters class

Defined in

Namespace: ReactiveUI Assembly: ReactiveUI.dll Full name: ReactiveUI.RxConverters Modifiers: public static

Summary

View source

        Provides static access to the ReactiveUI converter service.
        

Applies to

net10.0, net10.0-android36.0, net10.0-ios26.0, net10.0-macos26.0, net10.0-windows10.0.19041, net10.0-tvos26.0, net10.0-maccatalyst26.0, net10.0-desktop1.0, net10.0-browserwasm1.0, net9.0, net9.0-tvos18.0, net9.0-maccatalyst18.0, net9.0-windows10.0.19041, net9.0-desktop1.0, net9.0-browserwasm1.0, net9.0-macos15.0, net9.0-ios18.0, net9.0-android35.0, net8.0, net8.0-macos14.5, net8.0-macos14.2, net8.0-maccatalyst17.5, net8.0-ios17.5, net8.0-tvos18.0, net8.0-macos15.0, net8.0-ios18.0, net8.0-windows10.0.19041, net8.0-maccatalyst18.0, net8.0-tvos17.2, netstandard2.1, net481, net462

Remarks

This class provides a global access point to the ConverterService instance used by ReactiveUI for binding type conversions. It is initialized during application startup via the ReactiveUIBuilder pattern.

Recommended Usage:

In most cases, you don't need to access converters directly - the binding system uses them automatically. However, if you need to manually resolve a converter or register custom converters after initialization, use this class.

Initialization:

The converter service is initialized when you call ReactiveUIBuilder.BuildApp():

RxAppBuilder.CreateReactiveUIBuilder()
 .WithCoreServices()
 .WithPlatformServices()
 .BuildApp();

Custom Converter Registration:

Register custom converters during builder configuration (recommended):

RxAppBuilder.CreateReactiveUIBuilder()
 .WithConverter(new MyCustomConverter())
 .BuildApp();

Or register after initialization (not recommended, but supported):

RxConverters.Current.TypedConverters.Register(new MyCustomConverter());

Examples

Example: Manually resolving a converter

var converter = RxConverters.Current.ResolveConverter(typeof(int), typeof(string));
 if (converter is IBindingTypeConverter<int, string> typedConverter)
 {
 if (typedConverter.TryConvert(42, null, out var result))
 {
 Console.WriteLine(result); // "42"
 }
 }

Properties

NameSummary
static CurrentGets the current converter service instance.
Inherited members