IComponentChangeService.OnComponentChanging(Object, MemberDescriptor) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Avertit le service de modification du composant qu'un composant particulier est en cours de modification.
public:
void OnComponentChanging(System::Object ^ component, System::ComponentModel::MemberDescriptor ^ member);
public void OnComponentChanging (object component, System.ComponentModel.MemberDescriptor member);
public void OnComponentChanging (object component, System.ComponentModel.MemberDescriptor? member);
abstract member OnComponentChanging : obj * System.ComponentModel.MemberDescriptor -> unit
Public Sub OnComponentChanging (component As Object, member As MemberDescriptor)
Paramètres
- component
- Object
Composant sur le point d'être modifié.
- member
- MemberDescriptor
Membre en cours de modification. Il est null
si cette modification n'est pas liée à un membre unique.
Remarques
Cette méthode déclenche l’événement ComponentChanging .
La plupart des concepteurs inclus avec l’SDK Windows, ainsi que l’environnement au moment de la conception de Visual Studio, déclenchent généralement cet événement automatiquement . Ainsi, la plupart du temps, vous n’avez pas besoin d’appeler explicitement cette méthode. Les événements appropriés IComponentChangeService sont automatiquement déclenchés lorsqu’un PropertyDescriptor est utilisé pour modifier une valeur de propriété ou que des composants sont ajoutés ou supprimés du IDesignerHost conteneur.
Notes pour les responsables de l’implémentation
Cette méthode lève une exception si la propriété ne peut pas être modifiée. Cela n’est pas destiné à valider les valeurs d’une propriété particulière. Au lieu de cela, il est destiné à fournir une méthode globale pour empêcher la modification d’un composant. Par exemple, si un fichier de concepteur est archivé dans le contrôle de code source, le gestionnaire de cet événement lève généralement une exception si l’utilisateur refuse d’case activée le fichier.