Skip to content

IBindingFallbackConverter interface

Defined in

Namespace: ReactiveUI Assembly: ReactiveUI.Core.dll Full name: ReactiveUI.IBindingFallbackConverter Modifiers: public abstract

Summary

        Represents a converter that can handle runtime type pairs not covered by typed converters.
        Fallback converters are consulted only after all typed converters fail to match.

Applies to

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

Class hierarchy 
classDiagram
class IBindingFallbackConverter
class IEnableLogger {
    <>
}
IEnableLogger <|.. IBindingFallbackConverter

Implements: IEnableLogger

Remarks

Fallback converters exist for scenarios where conversion logic depends on runtime type characteristics that cannot be expressed as compile-time generic pairs.

Common use cases:

  • Component model type descriptors (reflection-based)
  • Platform-specific type conversions
  • IConvertible-based conversions

Affinity Guidelines:

  • 1. 0 = Not supported
  • 2. 1 = Last resort (ComponentModel/TypeDescriptor)
  • 3. 3 = Broad runtime conversion (IConvertible/numeric widening)
  • 4. 5 = Strong structural match (enum parsing, nullable unwrapping)

Do not return affinity ≥10 to avoid competing with typed converters.

Methods

NameSummary
GetAffinityForObjectsCalculates affinity for the specified runtime type pair.
TryConvertAttempts to convert the value to the target type.