ExpandableObjectConverter Klasse

Definition

Namespace:

System.ComponentModel

Assemblys:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Quelle:

ExpandableObjectConverter.cs

Stellt einen Typkonverter zum Konvertieren erweiterbarer Objekte in und aus verschiedenen anderen Darstellungen bereit.

public ref class ExpandableObjectConverter : System::ComponentModel::TypeConverter

public class ExpandableObjectConverter : System.ComponentModel.TypeConverter

type ExpandableObjectConverter = class
    inherit TypeConverter

Public Class ExpandableObjectConverter
Inherits TypeConverter

Vererbung

Object

TypeConverter

ExpandableObjectConverter

Abgeleitet

System.Drawing.IconConverter

System.Drawing.Printing.MarginsConverter

System.Windows.Forms.ColumnHeaderConverter

System.Windows.Forms.ListViewItemConverter

System.Windows.Xps.Serialization.ColorTypeConverter

System.Windows.Xps.Serialization.FontTypeConverter

System.Windows.Xps.Serialization.ImageSourceTypeConverter

Beispiele

Im folgenden Codebeispiel wird eine Variable vom Typ Margins in eine Zeichenfolgenvariable konvertiert.

String^ strM = "1,2,3,4";
System::Drawing::Printing::Margins^ m = gcnew System::Drawing::Printing::Margins( 1,2,3,4 );
Console::WriteLine( TypeDescriptor::GetConverter( strM )->CanConvertTo( System::Drawing::Printing::Margins::typeid ) );
Console::WriteLine( TypeDescriptor::GetConverter( m )->ConvertToString( m ) );

string strM = "1,2,3,4";
System.Drawing.Printing.Margins m = new(1, 2, 3, 4);
Console.WriteLine(TypeDescriptor.GetConverter(strM).CanConvertTo(typeof(System.Drawing.Printing.Margins)));
Console.WriteLine(TypeDescriptor.GetConverter(m).ConvertToString(m));

Dim strM As String
strM = "1,2,3,4"
            Dim m As New System.Drawing.Printing.Margins(1, 2, 3, 4)
Console.WriteLine(TypeDescriptor.GetConverter(strM).CanConvertTo(GetType(System.Drawing.Printing.Margins)))
Console.WriteLine(TypeDescriptor.GetConverter(m).ConvertToString(m))

Im folgenden Codebeispiel wird veranschaulicht, wie die Klasse und die NotifyParentPropertyAttributeExpandableObjectConverter Klasse zum Erstellen einer erweiterbaren Eigenschaft für ein benutzerdefiniertes Steuerelement verwendet werden. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die NotifyParentPropertyAttribute Klasse bereitgestellt wird.

[TypeConverter(typeof(BorderAppearanceConverter))]
public class BorderAppearance
{
    int borderSizeValue = 1;
    Color borderColorValue = Color.Empty;

    [Browsable(true),
    NotifyParentProperty(true),
    EditorBrowsable(EditorBrowsableState.Always),
    DefaultValue(1)]
    public int BorderSize
    {
        get => borderSizeValue;
        set
        {
            if (value < 0)
            {
                throw new ArgumentOutOfRangeException(
                    "BorderSize",
                    value,
                    "must be >= 0");
            }

            if (borderSizeValue != value)
            {
                borderSizeValue = value;
            }
        }
    }

    [Browsable(true)]
    [NotifyParentProperty(true)]
    [EditorBrowsable(EditorBrowsableState.Always)]
    [DefaultValue(typeof(Color), "")]
    public Color BorderColor
    {
        get => borderColorValue;
        set
        {
            if (value.Equals(Color.Transparent))
            {
                throw new NotSupportedException("Transparent colors are not supported.");
            }

            if (borderColorValue != value)
            {
                borderColorValue = value;
            }
        }
    }
}

<TypeConverter(GetType(BorderAppearanceConverter))>  _
Public Class BorderAppearance
    Private borderSizeValue As Integer = 1
    Private borderColorValue As Color = Color.Empty
    
    
    <Browsable(True), NotifyParentProperty(True), EditorBrowsable(EditorBrowsableState.Always), DefaultValue(1)>  _
    Public Property BorderSize() As Integer 
        Get
            Return borderSizeValue
        End Get
        Set
            If value < 0 Then
                Throw New ArgumentOutOfRangeException("BorderSize", value, "must be >= 0")
            End If
            
            If borderSizeValue <> value Then
                borderSizeValue = value
            End If
        End Set
    End Property
    
    
    <Browsable(True), NotifyParentProperty(True), EditorBrowsable(EditorBrowsableState.Always), DefaultValue(GetType(Color), "")>  _
    Public Property BorderColor() As Color 
        Get
            Return borderColorValue
        End Get
        Set
            If value.Equals(Color.Transparent) Then
                Throw New NotSupportedException("Transparent colors are not supported.")
            End If
            
            If borderColorValue <> value Then
                borderColorValue = value
            End If
        End Set
    End Property
End Class

Hinweise

Diese Klasse fügt Unterstützung für Eigenschaften für ein Objekt zu den Methoden und Eigenschaften hinzu, die von TypeConverter. Geben Sie TypeConverter dies für Standardimplementierungen und GetPropertiesGetPropertiesSupported -implementierungen an, um einen Eigenschaftstyp erweiterbar PropertyGridzu machen. Markieren Sie untergeordnete Eigenschaften mit dem NotifyParentPropertyAttribute , um das richtige Verhalten in einem PropertyGrid Steuerelement sicherzustellen.

Hinweis

Sie sollten niemals direkt auf einen Typkonverter zugreifen. Rufen Sie stattdessen den entsprechenden Konverter mithilfe von TypeDescriptor. Weitere Informationen finden Sie in den Beispielen in der TypeConverter Basisklasse.

Weitere Informationen zu Typkonvertern finden Sie in der TypeConverter Basisklasse.

Konstruktoren

Name	Beschreibung
ExpandableObjectConverter()	Initialisiert eine neue Instanz der ExpandableObjectConverter-Klasse.

Methoden

Name	Beschreibung
CanConvertFrom(ITypeDescriptorContext, Type)	Gibt zurück, ob dieser Konverter ein Objekt des angegebenen Typs mithilfe des angegebenen Kontexts in den Typ dieses Konverters konvertieren kann. (Geerbt von TypeConverter)
CanConvertFrom(Type)	Gibt zurück, ob dieser Konverter ein Objekt des angegebenen Typs in den Typ dieses Konverters konvertieren kann. (Geerbt von TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Gibt zurück, ob dieser Konverter das Objekt mithilfe des angegebenen Kontexts in den angegebenen Typ konvertieren kann. (Geerbt von TypeConverter)
CanConvertTo(Type)	Gibt zurück, ob dieser Konverter das Objekt in den angegebenen Typ konvertieren kann. (Geerbt von TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Konvertiert das angegebene Objekt in den Typ dieses Konverters unter Verwendung der angegebenen Kontext- und Kulturinformationen. (Geerbt von TypeConverter)
ConvertFrom(Object)	Konvertiert den angegebenen Wert in den Typ dieses Konverters. (Geerbt von TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Konvertiert die angegebene Zeichenfolge in den Typ dieses Konverters, wobei die invariante Kultur und der angegebene Kontext verwendet werden. (Geerbt von TypeConverter)
ConvertFromInvariantString(String)	Konvertiert die angegebene Zeichenfolge in den Typ dieses Konverters unter Verwendung der invarianten Kultur. (Geerbt von TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Konvertiert den angegebenen Text in ein Objekt mithilfe der angegebenen Kontext- und Kulturinformationen. (Geerbt von TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Konvertiert den angegebenen Text mithilfe des angegebenen Kontexts in ein Objekt. (Geerbt von TypeConverter)
ConvertFromString(String)	Konvertiert den angegebenen Text in ein Objekt. (Geerbt von TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Konvertiert das angegebene Wertobjekt mithilfe der angegebenen Kontext- und Kulturinformationen in den angegebenen Typ. (Geerbt von TypeConverter)
ConvertTo(Object, Type)	Konvertiert das angegebene Wertobjekt mithilfe der Argumente in den angegebenen Typ. (Geerbt von TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Wandelt den angegebenen Wert mithilfe des angegebenen Kontexts in eine kulturinvariante Zeichenfolgendarstellung um. (Geerbt von TypeConverter)
ConvertToInvariantString(Object)	Konvertiert den angegebenen Wert in eine kulturinvariante Zeichenfolgendarstellung. (Geerbt von TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Konvertiert den angegebenen Wert in eine Zeichenfolgendarstellung mithilfe der angegebenen Kontext- und Kulturinformationen. (Geerbt von TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Wandelt den angegebenen Wert mithilfe des angegebenen Kontexts in eine Zeichenfolgendarstellung um. (Geerbt von TypeConverter)
ConvertToString(Object)	Konvertiert den angegebenen Wert in eine Zeichenfolgendarstellung. (Geerbt von TypeConverter)
CreateInstance(IDictionary)	Erstellt einen Object bestimmten Satz von Eigenschaftswerten für das Objekt erneut. (Geerbt von TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Erstellt eine Instanz des Typs, dem dies TypeConverter mithilfe des angegebenen Kontexts zugeordnet ist, wobei eine Reihe von Eigenschaftswerten für das Objekt angegeben ist. (Geerbt von TypeConverter)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetConvertFromException(Object)	Gibt eine Ausnahme zurück, die ausgelöst wird, wenn eine Konvertierung nicht ausgeführt werden kann. (Geerbt von TypeConverter)
GetConvertToException(Object, Type)	Gibt eine Ausnahme zurück, die ausgelöst wird, wenn eine Konvertierung nicht ausgeführt werden kann. (Geerbt von TypeConverter)
GetCreateInstanceSupported()	Gibt zurück, ob das Ändern eines Werts für dieses Objekt einen Aufruf der CreateInstance(IDictionary) Methode erfordert, um einen neuen Wert zu erstellen. (Geerbt von TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Gibt zurück, ob beim Ändern eines Werts für dieses Objekt ein Aufruf zum CreateInstance(IDictionary) Erstellen eines neuen Werts mithilfe des angegebenen Kontexts erforderlich ist. (Geerbt von TypeConverter)
GetHashCode()	Dient als die Standard-Hashfunktion (Geerbt von Object)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Ruft eine Auflistung von Eigenschaften für den Objekttyp ab, der durch den Wertparameter angegeben wird.
GetProperties(ITypeDescriptorContext, Object)	Gibt eine Auflistung von Eigenschaften für den Vom Wertparameter angegebenen Arraytyp mithilfe des angegebenen Kontexts zurück. (Geerbt von TypeConverter)
GetProperties(Object)	Gibt eine Auflistung von Eigenschaften für den Arraytyp zurück, der durch den Wertparameter angegeben wird. (Geerbt von TypeConverter)
GetPropertiesSupported()	Gibt zurück, ob dieses Objekt Eigenschaften unterstützt. (Geerbt von TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Ruft einen Wert ab, der angibt, ob dieses Objekt Eigenschaften mithilfe des angegebenen Kontexts unterstützt.
GetStandardValues()	Gibt eine Auflistung von Standardwerten aus dem Standardkontext für den Datentyp zurück, für den dieser Typkonverter entwickelt wurde. (Geerbt von TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Gibt eine Auflistung von Standardwerten für den Datentyp zurück, für den dieser Typkonverter entwickelt wurde, wenn er mit einem Formatkontext bereitgestellt wird. (Geerbt von TypeConverter)
GetStandardValuesExclusive()	Gibt zurück, ob es sich bei der Auflistung der zurückgegebenen GetStandardValues() Standardwerte um eine exklusive Liste handelt. (Geerbt von TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Gibt zurück, ob es sich bei der Auflistung der zurückgegebenen GetStandardValues() Standardwerte um eine exklusive Liste möglicher Werte handelt, wobei der angegebene Kontext verwendet wird. (Geerbt von TypeConverter)
GetStandardValuesSupported()	Gibt zurück, ob dieses Objekt einen Standardsatz von Werten unterstützt, der aus einer Liste ausgewählt werden kann. (Geerbt von TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Gibt zurück, ob dieses Objekt einen Standardsatz von Werten unterstützt, die mithilfe des angegebenen Kontexts aus einer Liste ausgewählt werden können. (Geerbt von TypeConverter)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IsValid(ITypeDescriptorContext, Object)	Gibt zurück, ob das angegebene Wertobjekt für diesen Typ und für den angegebenen Kontext gültig ist. (Geerbt von TypeConverter)
IsValid(Object)	Gibt zurück, ob das angegebene Wertobjekt für diesen Typ gültig ist. (Geerbt von TypeConverter)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
SortProperties(PropertyDescriptorCollection, String[])	Sortiert eine Auflistung von Eigenschaften. (Geerbt von TypeConverter)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• NotifyParentPropertyAttribute