IComponentChangeService.OnComponentChanging(Object, MemberDescriptor) Método

Definición

Anuncia al servicio de cambio de componentes que un determinado componente está cambiando.Announces to the component change service that a particular component is changing.

public:
 void OnComponentChanging(System::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)

Parámetros

component
Object

Componente que va a cambiar.The component that is about to change.

member
MemberDescriptor

Miembro que se va a cambiar.The member that is changing. Es null si este cambio no está relacionado con un solo miembro.This is null if this change is not related to a single member.

Comentarios

Este método genera el ComponentChanging evento.This method raises the ComponentChanging event.

La mayoría de los diseñadores incluidos con el Windows SDK, así como el entorno en tiempo de diseño de Visual Studio, normalmente generan este evento automáticamente. por lo tanto, la mayoría de las veces no es necesario llamar explícitamente a este método.Most designers included with the Windows SDK, as well as the Visual Studio design-time environment, typically raise this event automatically; so most of the time, you do not need to explicitly call this method. Los eventos IComponentChangeService correspondientes se generan automáticamente cuando se PropertyDescriptor utiliza un para cambiar un valor de propiedad o cuando se IDesignerHost agregan o quitan componentes del contenedor.The appropriate IComponentChangeService events are automatically raised when a PropertyDescriptor is used to change a property value or components are added or removed from the IDesignerHost container.

Notas a los implementadores

Este método produce una excepción si no se puede cambiar la propiedad.This method throws an exception if the property cannot be changed. Esto no pretende validar los valores de una propiedad determinada.This is not intended to validate the values of a particular property. En su lugar, está pensado para proporcionar un método global para evitar que un componente cambie.Instead, it is intended to provide a global method of preventing a component from changing. Por ejemplo, si se protege un archivo de diseñador en el control de código fuente, el controlador de este evento producirá normalmente una excepción si el usuario rechazó desproteger el archivo.For example, if a designer file is checked into source code control, this event's handler would typically throw an exception if the user refused to check out the file.

Se aplica a

Consulte también: