XamlValueConverter<TConverterBase> Class

Definition

Namespace:

System.Xaml.Schema

Assembly:

System.Xaml.dll

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.

C#

public class XamlValueConverter<TConverterBase> : IEquatable<System.Xaml.Schema.XamlValueConverter<TConverterBase>> where TConverterBase : class

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

Object

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, 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.
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>.

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>.
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