ExpandableObjectConverter Classe

Définition

Fournit un convertisseur de type pour des objets extensibles vers et à partir d'autres représentations.

public ref class ExpandableObjectConverter : System::ComponentModel::TypeConverter
public class ExpandableObjectConverter : System.ComponentModel.TypeConverter
type ExpandableObjectConverter = class
    inherit TypeConverter
Public Class ExpandableObjectConverter
Inherits TypeConverter
Héritage
ExpandableObjectConverter
Dérivé

Exemples

L’exemple de code suivant convertit une variable de type Margins en variable de chaîne.

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))

L’exemple de code suivant montre comment utiliser la NotifyParentPropertyAttribute classe et ExpandableObjectConverter pour créer une propriété extensible sur un contrôle personnalisé. Cet exemple de code fait partie d’un exemple plus grand fourni pour la NotifyParentPropertyAttribute classe .

[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

Remarques

Cette classe ajoute la prise en charge des propriétés d’un objet aux méthodes et propriétés fournies par TypeConverter. Pour rendre un type de propriété extensible dans , spécifiez-le PropertyGridTypeConverter pour les implémentations standard de GetPropertiesSupported et GetProperties. Marquez les propriétés enfants avec pour garantir un NotifyParentPropertyAttribute comportement correct dans un PropertyGrid contrôle.

Notes

Vous ne devez jamais accéder directement à un convertisseur de type. Au lieu de cela, appelez le convertisseur approprié à l’aide de TypeDescriptor. Pour plus d’informations, consultez les exemples de la classe de TypeConverter base.

Pour plus d’informations sur les convertisseurs de type, consultez la TypeConverter classe de base et Guide pratique pour implémenter un convertisseur de type.

Constructeurs

ExpandableObjectConverter()

Initialise une nouvelle instance de la classe ExpandableObjectConverter.

Méthodes

CanConvertFrom(ITypeDescriptorContext, Type)

Retourne une valeur indiquant si ce convertisseur peut convertir un objet du type donné en objet du type de ce convertisseur à l’aide du contexte spécifié.

(Hérité de TypeConverter)
CanConvertFrom(Type)

Retourne une valeur indiquant si ce convertisseur peut convertir un objet du type donné en objet du type de ce convertisseur.

(Hérité de TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)

Retourne une valeur indiquant si ce convertisseur peut convertir l’objet en objet du type spécifié, à l’aide du contexte spécifié.

(Hérité de TypeConverter)
CanConvertTo(Type)

Retourne une valeur indiquant si ce convertisseur peut convertir l'objet en objet du type spécifié.

(Hérité de TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)

Convertit l'objet donné au type de ce convertisseur, en utilisant le contexte et les informations de culture spécifiés.

(Hérité de TypeConverter)
ConvertFrom(Object)

Convertit la valeur donnée en valeur du type de ce convertisseur.

(Hérité de TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)

Convertit la chaîne donnée au type de ce convertisseur, à l'aide des informations de culture indifférente et du contexte spécifiés.

(Hérité de TypeConverter)
ConvertFromInvariantString(String)

Convertit la chaîne donnée en représentation sous forme de chaîne du type de ce convertisseur, à l'aide de la culture dite indifférente.

(Hérité de TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)

Convertit le texte donné en objet, à l'aide du contexte et des informations de culture spécifiés.

(Hérité de TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)

Convertit le texte donné en objet, à l'aide du contexte spécifié.

(Hérité de TypeConverter)
ConvertFromString(String)

Convertit le texte spécifié en objet.

(Hérité de TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Convertit l'objet valeur donné au type spécifié, en utilisant le contexte et les informations de culture spécifiés.

(Hérité de TypeConverter)
ConvertTo(Object, Type)

Convertit l'objet de valeur donné en objet du type spécifié, à l'aide des arguments.

(Hérité de TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)

Convertit la valeur spécifiée en représentation sous forme de chaîne de culture dite indifférente, à l'aide du contexte déterminé.

(Hérité de TypeConverter)
ConvertToInvariantString(Object)

Convertit la valeur spécifiée en représentation sous forme de chaîne de culture dite indifférente.

(Hérité de TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)

Convertit la valeur donnée en représentation sous forme de chaîne, à l'aide du contexte et des informations de culture spécifiés.

(Hérité de TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)

Convertit la valeur donnée en représentation sous forme de chaîne, à l'aide du contexte déterminé.

(Hérité de TypeConverter)
ConvertToString(Object)

Convertit la valeur spécifiée en représentation sous forme de chaîne.

(Hérité de TypeConverter)
CreateInstance(IDictionary)

Recrée un Object en fonction d'un jeu de valeurs de propriétés de l'objet.

(Hérité de TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)

Crée une instance du type auquel ce TypeConverter est associé, en utilisant le contexte spécifié, en fonction d’un ensemble de valeurs de propriétés de l’objet.

(Hérité de TypeConverter)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetConvertFromException(Object)

Retourne une exception à lever quand une conversion ne peut pas être effectuée.

(Hérité de TypeConverter)
GetConvertToException(Object, Type)

Retourne une exception à lever quand une conversion ne peut pas être effectuée.

(Hérité de TypeConverter)
GetCreateInstanceSupported()

Retourne une valeur indiquant si la modification d'une valeur de cet objet nécessite un appel à la méthode CreateInstance(IDictionary) pour créer une nouvelle valeur.

(Hérité de TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)

Retourne une valeur indiquant si la modification d’une valeur de cet objet nécessite un appel à CreateInstance(IDictionary) pour créer une valeur, en utilisant le contexte spécifié.

(Hérité de TypeConverter)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetProperties(ITypeDescriptorContext, Object)

Retourne une collection de propriétés pour le type de tableau spécifié par le paramètre de valeur, à l'aide du contexte déterminé.

(Hérité de TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])

Obtient une collection de propriétés pour le type d'objet spécifié par le paramètre de valeur.

GetProperties(Object)

Retourne une collection de propriétés pour le type de tableau spécifié par le paramètre de valeur.

(Hérité de TypeConverter)
GetPropertiesSupported()

Retourne une valeur indiquant si l'objet prend en charge les propriétés.

(Hérité de TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)

Obtient une valeur indiquant si cet objet prend en charge les propriétés, en utilisant le contexte spécifié.

GetStandardValues()

Retourne une collection de valeurs standard à partir du contexte par défaut du type de données pour lequel ce convertisseur de type est conçu.

(Hérité de TypeConverter)
GetStandardValues(ITypeDescriptorContext)

Retourne une collection de valeurs standard pour le type de données compatible avec ce convertisseur de type quand un contexte de format est fourni.

(Hérité de TypeConverter)
GetStandardValuesExclusive()

Retourne une valeur indiquant si la collection de valeurs standard retournée par GetStandardValues() est une liste exclusive.

(Hérité de TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)

Retourne une valeur indiquant si la collection de valeurs standard retournée par GetStandardValues() est une liste exclusive des valeurs possibles, à l’aide du contexte spécifié.

(Hérité de TypeConverter)
GetStandardValuesSupported()

Retourne une valeur indiquant si cet objet prend en charge un jeu standard de valeurs qui peuvent être sélectionnées dans une liste.

(Hérité de TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)

Retourne une valeur indiquant si cet objet prend en charge un jeu de valeurs standard pouvant être sélectionnées dans une liste, à l'aide du contexte spécifié.

(Hérité de TypeConverter)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
IsValid(ITypeDescriptorContext, Object)

Indique par retour si l’objet de valeur donné est valide pour ce type et pour le contexte spécifié.

(Hérité de TypeConverter)
IsValid(Object)

Retourne une valeur indiquant si l'objet de valeur donné est valide pour ce type.

(Hérité de TypeConverter)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
SortProperties(PropertyDescriptorCollection, String[])

Trie une collection de propriétés.

(Hérité de TypeConverter)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi