Edit

Share via


XamlValueConverter<TConverterBase> Class

Definition

Provides a common API surface for techniques that generate initialization or serialization values for XAML based on input other than the eventual destination type. This includes markup extensions and type converters.

generic <typename TConverterBase>
 where TConverterBase : classpublic ref class XamlValueConverter : IEquatable<System::Xaml::Schema::XamlValueConverter<TConverterBase> ^>
public class XamlValueConverter<TConverterBase> : IEquatable<System.Xaml.Schema.XamlValueConverter<TConverterBase>> where TConverterBase : class
type XamlValueConverter<'ConverterBase (requires 'ConverterBase : null)> = class
    interface IEquatable<XamlValueConverter<'ConverterBase>>
Public Class XamlValueConverter(Of TConverterBase)
Implements IEquatable(Of XamlValueConverter(Of TConverterBase))

Type Parameters

TConverterBase

The CLR base class for the particular converter that this XamlValueConverter<TConverterBase> represents. Typically this is one of the following: TypeConverter; MarkupExtension; ValueSerializer.

Inheritance
XamlValueConverter<TConverterBase>
Implements
IEquatable<XamlValueConverter<TConverterBase>>

Remarks

Instances of this type are returned by methods of the XAML schema API such as LookupTypeConverter. The generic implementation of XamlValueConverter<TConverterBase> provides indirection for the System.Xaml assembly so that the basic XAML schema and type system does not have to take dependencies on different value conversion techniques that are typically implementations in other assemblies.

A XamlValueConverter<TConverterBase> can be constructed with a null implementation type, but such a XamlValueConverter<TConverterBase> will return null for CreateInstance.

Constructor signatures for XamlValueConverter<TConverterBase> use a converterType parameter that references the specific type that implements the conversion behavior. For a properly functioning XamlValueConverter<TConverterBase> (one that has a nonnull ConverterInstance), the converterType type is expected to be castable to the TConverterBase constraint. A mismatch condition is not enforced by constructors, but might produce an InvalidCastException at run time.

Constructors

XamlValueConverter<TConverterBase>(Type, XamlType)

Initializes a new instance of the XamlValueConverter<TConverterBase> class, based on a converter implementing Type and the target/destination type of the XamlValueConverter<TConverterBase>.

XamlValueConverter<TConverterBase>(Type, XamlType, String)

Initializes a new instance of the XamlValueConverter<TConverterBase> class, based on a converter implementing Type the target/destination type of the XamlValueConverter<TConverterBase>, and a string name.

Properties

ConverterInstance

Gets a created instance of the converter implementation.

ConverterType

Gets the Type for the class that implements the converter behavior.

Name

Gets a string name for this XamlValueConverter<TConverterBase>.

TargetType

Gets the target/destination XamlType of the XamlValueConverter<TConverterBase>.

Methods

CreateInstance()

Returns an instance of the converter implementation.

Equals(Object)

Determines whether this instance of XamlValueConverter<TConverterBase> and a specified object, which must also be a XamlValueConverter<TConverterBase> object, have the same value.

Equals(XamlValueConverter<TConverterBase>)

Determines whether this instance of XamlValueConverter<TConverterBase> and another XamlValueConverter<TConverterBase> object have the same value.

GetHashCode()

Returns the hash code for this XamlValueConverter<TConverterBase>.

GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Returns a String that represents this XamlValueConverter<TConverterBase>.

Operators

Equality(XamlValueConverter<TConverterBase>, XamlValueConverter<TConverterBase>)

Determines whether two specified XamlValueConverter<TConverterBase> objects have the same value.

Inequality(XamlValueConverter<TConverterBase>, XamlValueConverter<TConverterBase>)

Determines whether two specified XamlValueConverter<TConverterBase> objects have different values.

Applies to