Cette documentation est archivée et n’est pas conservée.

PropertyDescriptor.SetValue, méthode

Mise à jour : novembre 2007

En cas de substitution dans une classe dérivée, affecte une autre valeur au composant.

Espace de noms :  System.ComponentModel
Assembly :  System (dans System.dll)

public abstract void SetValue(
	Object component,
	Object value
)
public abstract void SetValue(
	Object component,
	Object value
)
public abstract function SetValue(
	component : Object, 
	value : Object
)

Paramètres

component
Type : System.Object

Composant dont la valeur de la propriété doit être définie.

value
Type : System.Object

Nouvelle valeur.

Généralement, cette méthode est implémentée par réflexion.

Cette méthode crée automatiquement un DesignerTransaction dans l'ordre suivant :

  1. La méthode appelle la méthode IDesignerHost.CreateTransaction pour créer un DesignerTransaction afin de représenter les modifications.

  2. La méthode appelle la méthode IComponentChangeService.OnComponentChanging pour indiquer que la transaction a commencé et que les modifications sont imminentes.

  3. La méthode rétablit la valeur de la propriété déterminée par l'ordre de vérification de cette méthode.

  4. La méthode appelle la méthode IComponentChangeService.OnComponentChanged pour indiquer que les modifications ont été apportées.

  5. La méthode appelle DesignerTransaction.Commit pour indiquer que la transaction est terminée.

La transaction a pour objectif la prise en charge des fonctionnalités Undo et Redo.

Remarques à l'attention des héritiers :

Lorsque vous substituez cette méthode, elle doit définir la valeur de la propriété en appelant la méthode « SetMyProperty » appropriée que vous devez implémenter. Si la valeur spécifiée n'est pas valide, le composant doit lever une exception, qui est passée. Vous devez concevoir la propriété de telle sorte qu'une méthode « GetMyProperty » (que vous avez implémentée) suivant une méthode « SetMyProperty » retourne la valeur passée lorsque la méthode « SetMyProperty » ne lève pas une exception.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 2.0, 1.0
Afficher: