XamlValueConverter<TConverterBase> Class
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.
Assembly: System.Xaml (in System.Xaml.dll)
public class XamlValueConverter<TConverterBase> : IEquatable<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;
The XamlValueConverter<TConverterBase> type exposes the following members.
| Name | Description | |
|---|---|---|
 | 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. |
| Name | Description | |
|---|---|---|
| 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>. |
| Name | Description | |
|---|---|---|
| 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. (Overrides Object.Equals(Object).) |
| Equals(XamlValueConverter<TConverterBase>) | Determines whether this instance of XamlValueConverter<TConverterBase> and another XamlValueConverter<TConverterBase> object have the same value. |
| Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
| GetHashCode | Returns the hash code for this XamlValueConverter<TConverterBase>. (Overrides Object.GetHashCode().) |
| 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>. (Overrides Object.ToString().) |
| Name | Description | |
|---|---|---|
| Equality | Determines whether two specified XamlValueConverter<TConverterBase> objects have the same value. |
| Inequality | Determines whether two specified XamlValueConverter<TConverterBase> objects have different values. |
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.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.