TypeConverter.CreateInstance Méthode
Définition
Surcharges
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.Creates an instance of the type that this TypeConverter is associated with, using the specified context, given a set of property values for the object. |
CreateInstance(IDictionary) |
Recrée un Object en fonction d'un jeu de valeurs de propriétés de l'objet.Re-creates an Object given a set of property values for the object. |
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.Creates an instance of the type that this TypeConverter is associated with, using the specified context, given a set of property values for the object.
public:
virtual System::Object ^ CreateInstance(System::ComponentModel::ITypeDescriptorContext ^ context, System::Collections::IDictionary ^ propertyValues);
public virtual object CreateInstance (System.ComponentModel.ITypeDescriptorContext context, System.Collections.IDictionary propertyValues);
abstract member CreateInstance : System.ComponentModel.ITypeDescriptorContext * System.Collections.IDictionary -> obj
override this.CreateInstance : System.ComponentModel.ITypeDescriptorContext * System.Collections.IDictionary -> obj
Public Overridable Function CreateInstance (context As ITypeDescriptorContext, propertyValues As IDictionary) As Object
Paramètres
- context
- ITypeDescriptorContext
ITypeDescriptorContext qui fournit un contexte de format.An ITypeDescriptorContext that provides a format context.
- propertyValues
- IDictionary
IDictionary de nouvelles valeurs de propriétés.An IDictionary of new property values.
Retours
Object représentant le IDictionary donné, ou null
si l’objet ne peut pas être créé.An Object representing the given IDictionary, or null
if the object cannot be created. Cette méthode retourne toujours la valeur null
.This method always returns null
.
Remarques
Utilisez cette méthode pour les objets immuables, mais pour lesquels vous souhaitez fournir des propriétés modifiables.Use this method for objects that are immutable, but for which you want to provide changeable properties.
Notes pour les héritiers
Substituez cette méthode si le type que vous souhaitez convertir doit recréer l’objet pour modifier sa valeur.Override this method if the type you want to convert must re-create the object to change its value.
Utilisez le paramètre context
pour extraire des informations supplémentaires sur l'environnement à partir duquel ce convertisseur est appelé.Use the context
parameter to extract additional information about the environment from which this converter is invoked. Ce paramètre peut être null
, donc toujours le vérifier.This parameter can be null
, so always check it. En outre, les propriétés de l'objet de contexte peuvent retourner null
.Also, properties on the context object can return null
.
Le dictionnaire fourni par le propertyValues
paramètre possède une série de paires nom/valeur, une pour chaque propriété retournée par GetProperties(Object) .The dictionary provided by the propertyValues
parameter has a series of name/value pairs, one for each property returned from GetProperties(Object).
Voir aussi
S’applique à
CreateInstance(IDictionary)
public:
System::Object ^ CreateInstance(System::Collections::IDictionary ^ propertyValues);
public object CreateInstance (System.Collections.IDictionary propertyValues);
member this.CreateInstance : System.Collections.IDictionary -> obj
Public Function CreateInstance (propertyValues As IDictionary) As Object
Paramètres
- propertyValues
- IDictionary
IDictionary représentant un dictionnaire de nouvelles valeurs de propriétés.An IDictionary that represents a dictionary of new property values.
Retours
Object représentant le IDictionary donné, ou null
si l’objet ne peut pas être créé.An Object representing the given IDictionary, or null
if the object cannot be created. Cette méthode retourne toujours la valeur null
.This method always returns null
.
Remarques
Utilisez cette méthode pour les objets immuables, mais pour lesquels vous souhaitez fournir des propriétés modifiables.Use this method for objects that are immutable, but for which you want to provide changeable properties.
Le dictionnaire fourni par le propertyValues
paramètre possède une série de paires nom/valeur, une pour chaque propriété retournée par GetProperties .The dictionary provided by the propertyValues
parameter has a series of name/value pairs, one for each property returned from GetProperties.