XamlValueConverter<TConverterBase> Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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. |