ExpandableObjectConverter Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Stellt einen Typkonverter bereit, um erweiterbare Objekte in andere und aus anderen Darstellungen zu konvertieren.

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 System.Drawing.Printing.Margins(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 Sie die NotifyParentPropertyAttribute und die ExpandableObjectConverter Klasse verwenden, um eine erweiterbare Eigenschaft für ein benutzerdefiniertes Steuerelement zu erstellen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die NotifyParentPropertyAttribute Klasse bereitgestellt wird.

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

    [Browsable(true),
    NotifyParentProperty(true),
    EditorBrowsable(EditorBrowsableState.Always),
    DefaultValue(1)]
    public int BorderSize
    {
        get
        {
            return 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
        {
            return 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 dies TypeConverter für Standardimplementierungen und GetPropertiesGetPropertiesSupported -implementierungen an, um eine Art von Eigenschaft PropertyGriderweiterbar zu 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 und vorgehensweise: Implementieren eines Typkonverters.

Konstruktoren

ExpandableObjectConverter()

Initialisiert eine neue Instanz der ExpandableObjectConverter-Klasse.

Methoden

CanConvertFrom(ITypeDescriptorContext, Type)	Gibt zurück, ob dieser Konverter ein Objekt vom angegebenen Typ unter Verwendung 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 umwandeln 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 mit dem 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 unter Verwendung der invarianten Kultur und des angegebenen Kontexts in den Typ dieses Konverters. (Geerbt von TypeConverter)
ConvertFromInvariantString(String)	Konvertiert die angegebene Zeichenfolge unter Verwendung der invarianten Kultur in einen Typ dieses Konverters. (Geerbt von TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Konvertiert den angegebenen Text unter Verwendung des angegebenen Kontexts und der angegebenen Kulturinformationen in ein Objekt. (Geerbt von TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Konvertiert den angegebenen Text unter Verwendung 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 in den angegebenen Typ mit dem angegebenen Kontext und Kulturinformationen. (Geerbt von TypeConverter)
ConvertTo(Object, Type)	Konvertiert das angegebene Wertobjekt unter Verwendung der Argumente in den angegebenen Typ. (Geerbt von TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Konvertiert den angegebenen Wert unter Verwendung des angegebenen Kontexts in eine Zeichenfolgendarstellung mit invarianter Kultur. (Geerbt von TypeConverter)
ConvertToInvariantString(Object)	Konvertiert den angegebenen Wert in eine Zeichenfolgendarstellung mit invarianter Kultur. (Geerbt von TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Konvertiert den angegebenen Wert unter Verwendung des angegebenen Kontexts und der angegebenen Kulturinformationen in eine Zeichenfolgendarstellung. (Geerbt von TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Konvertiert den angegebenen Wert unter Verwendung des angegebenen Kontexts in eine Zeichenfolgendarstellung. (Geerbt von TypeConverter)
ConvertToString(Object)	Konvertiert den angegebenen Wert in eine Zeichenfolgendarstellung. (Geerbt von TypeConverter)
CreateInstance(IDictionary)	Erstellt eine Object-Klasse mit einer angegebenen Menge von Eigenschaftswerten für das Objekt neu. (Geerbt von TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Erstellt über den angegebenen Kontext, der aus einer angegebenen Menge von Eigenschaftswerten für das Objekt besteht, eine Instanz des Typs, der dieser TypeConverter-Klasse zugeordnet 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, wenn eine Konvertierung nicht erfolgen kann. (Geerbt von TypeConverter)
GetConvertToException(Object, Type)	Gibt eine Ausnahme zurück, wenn eine Konvertierung nicht erfolgen kann. (Geerbt von TypeConverter)
GetCreateInstanceSupported()	Gibt zurück, ob zum Ändern eines Werts für dieses Objekt ein Aufruf der CreateInstance(IDictionary)-Methode erforderlich ist. (Geerbt von TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Gibt zurück, ob bei Ändern eines Werts für dieses Objekt ein Aufruf von CreateInstance(IDictionary) zum Erstellen eines neuen Werts mit dem angegebenen Kontext erforderlich ist. (Geerbt von TypeConverter)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetProperties(ITypeDescriptorContext, Object)	Gibt unter Verwendung des angegebenen Kontexts eine Auflistung der Eigenschaften für den Typ von Array zurück, der durch den Wertparameter angegeben ist. (Geerbt von TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Ruft eine Auflistung von Eigenschaften für den durch den Wertparameter angegebenen Typ von Objekt ab.
GetProperties(Object)	Gibt eine Auflistung von Eigenschaften für den Typ Array zurück, der durch den Wertparameter angegeben ist. (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 unter Verwendung 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 vorgesehen ist. (Geerbt von TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Gibt eine Auflistung von Standardwerten für den Datentyp zurück, auf den dieser Typkonverter ausgelegt ist, wenn ein Formatkontext bereitgestellt wird. (Geerbt von TypeConverter)
GetStandardValuesExclusive()	Gibt zurück, ob die von GetStandardValues() zurückgegebene Auflistung von Standardwerten eine exklusive Liste darstellt. (Geerbt von TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Gibt zurück, ob die Auflistung von Standardwerten, die von der GetStandardValues()-Methode unter Verwendung des angegebenen Kontexts zurückgegeben werden, eine exklusive Liste von möglichen Werten darstellt. (Geerbt von TypeConverter)
GetStandardValuesSupported()	Gibt zurück, ob dieses Objekt einen Standardsatz von Werten unterstützt, die aus einer Liste ausgewählt werden können. (Geerbt von TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Gibt zurück, ob dieses Objekt einen Standardsatz von Werten unterstützt, die unter Verwendung des angegebenen Kontexts aus einer Liste ausgewählt werden können. (Geerbt von TypeConverter)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsValid(ITypeDescriptorContext, Object)	Gibt zurück, ob das angegebene Wertobjekt für diesen Typ und den angegebenen Kontext gültig ist. (Geerbt von TypeConverter)
IsValid(Object)	Ruft ab, ob das angegebene Werteobjekt für diesen Typ gültig ist. (Geerbt von TypeConverter)
MemberwiseClone()	Erstellt eine flache Kopie des 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)

Siehe auch

• NotifyParentPropertyAttribute