Table of Contents

Class EnumXmlConverter<T>

Namespace
NanoByte.Common.Values.Design
Assembly
NanoByte.Common.dll

Type converter for Enums annotated with XmlEnumAttributes.

public class EnumXmlConverter<T> : TypeConverter where T : struct, Enum

Type Parameters

T

The type the converter is used for.

Inheritance
object
EnumXmlConverter<T>
Inherited Members
Extension Methods

Examples

Add this attribute to the Enum:

[TypeConverter(typeof(XmlEnumConverter<NameOfEnum>))]

Remarks

Name is used as the case-insensitive string representation (falls back to element name).

Methods

CanConvertFrom(ITypeDescriptorContext?, Type)

Returns whether this converter can convert an object of the given type to the type of this converter, using the specified context.

public override bool CanConvertFrom(ITypeDescriptorContext? context, Type sourceType)

Parameters

context ITypeDescriptorContext

An ITypeDescriptorContext that provides a format context.

sourceType Type

A Type that represents the type you want to convert from.

Returns

bool

true if this converter can perform the conversion; otherwise, false.

ConvertFrom(ITypeDescriptorContext?, CultureInfo?, object)

Converts the given object to the type of this converter, using the specified context and culture information.

public override object ConvertFrom(ITypeDescriptorContext? context, CultureInfo? culture, object value)

Parameters

context ITypeDescriptorContext

An ITypeDescriptorContext that provides a format context.

culture CultureInfo

The CultureInfo to use as the current culture.

value object

The object to convert.

Returns

object

An object that represents the converted value.

Exceptions

NotSupportedException

The conversion cannot be performed.

ConvertTo(ITypeDescriptorContext?, CultureInfo?, object?, Type)

Converts the given value object to the specified type, using the specified context and culture information.

public override object ConvertTo(ITypeDescriptorContext? context, CultureInfo? culture, object? value, Type destinationType)

Parameters

context ITypeDescriptorContext

An ITypeDescriptorContext that provides a format context.

culture CultureInfo

A CultureInfo. If null is passed, the current culture is assumed.

value object

The object to convert.

destinationType Type

The Type to convert the value parameter to.

Returns

object

An object that represents the converted value.

Exceptions

ArgumentNullException

The destinationType parameter is null.

NotSupportedException

The conversion cannot be performed.

GetStandardValues(ITypeDescriptorContext?)

Returns a collection of standard values for the data type this type converter is designed for when provided with a format context.

public override TypeConverter.StandardValuesCollection GetStandardValues(ITypeDescriptorContext? context)

Parameters

context ITypeDescriptorContext

An ITypeDescriptorContext that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null.

Returns

TypeConverter.StandardValuesCollection

A TypeConverter.StandardValuesCollection that holds a standard set of valid values, or null if the data type does not support a standard set of values.

GetStandardValuesExclusive(ITypeDescriptorContext?)

Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list of possible values, using the specified context.

public override bool GetStandardValuesExclusive(ITypeDescriptorContext? context)

Parameters

context ITypeDescriptorContext

An ITypeDescriptorContext that provides a format context.

Returns

bool

true if the TypeConverter.StandardValuesCollection returned from GetStandardValues() is an exhaustive list of possible values; false if other values are possible.

GetStandardValuesSupported(ITypeDescriptorContext?)

Returns whether this object supports a standard set of values that can be picked from a list, using the specified context.

public override bool GetStandardValuesSupported(ITypeDescriptorContext? context)

Parameters

context ITypeDescriptorContext

An ITypeDescriptorContext that provides a format context.

Returns

bool

true if GetStandardValues() should be called to find a common set of values the object supports; otherwise, false.