Esta documentación está archivada y no tiene mantenimiento.

ComponentChangingEventArgs (Clase)

Actualización: noviembre 2007

Proporciona datos del evento ComponentChanging. No se puede heredar esta clase.

Espacio de nombres:  System.ComponentModel.Design
Ensamblado:  System (en System.dll)

[ComVisibleAttribute(true)]
[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public sealed class ComponentChangingEventArgs : EventArgs
/** @attribute ComVisibleAttribute(true) */
/** @attribute PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust") */
/** @attribute HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true) */
public final class ComponentChangingEventArgs extends EventArgs
public final class ComponentChangingEventArgs extends EventArgs

d9tshh6z.alert_note(es-es,VS.90).gifNota:

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el siguiente valor de la propiedad Resources: SharedState. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación de SQL Server y atributos de protección del host.

ComponentChangingEventArgs proporciona datos acerca de un evento ComponentChanging. El evento ComponentChanging notifica a IComponentChangeService y a los controladores de eventos registrados que se va a cambiar un componente concreto del documento de diseño actual. Este evento proporciona un método muy accesible para impedir el cambio de un componente.

Se provoca un evento ComponentChanging antes de que se cambie un componente. Este evento ofrece al diseñador la oportunidad de anular el cambio. Normalmente, los diseñadores de componentes provocan el evento ComponentChanging automáticamente. Si una propiedad no se puede cambiar, el método que controla el evento puede producir una excepción. Por ejemplo, si un archivo de diseñador está protegido en el control de código fuente, el controlador de este evento produce normalmente una excepción si el usuario se niega a desproteger el archivo.

ComponentChangingEventArgs proporciona la siguiente información:

  • Propiedad Component que indica el componente que se va a cambiar.

  • Propiedad Member que indica el miembro que se va a cambiar.

Notas para los herederos:

Si esta clase se especifica como clase base de otra clase, se produce un error del compilador.

En el ejemplo siguiente se muestra cómo crear ComponentChangingEventArgs.

// This example method creates a ComponentChangingEventArgs using the specified arguments.
// Typically, this type of event args is created by a design mode subsystem.  
public ComponentChangingEventArgs CreateComponentChangingEventArgs(object component, MemberDescriptor member)
{
    ComponentChangingEventArgs args = new ComponentChangingEventArgs(component, member);

    // The component that is about to change:       args.Component
    // The member that is about to change:          args.Member

    return args;
}


// This example method creates a ComponentChangingEventArgs
// using the specified arguments.
// Typically, this type of event args is created by a design mode subsystem.
public ComponentChangingEventArgs CreateComponentChangingEventArgs(
    Object component, MemberDescriptor member)
{
    ComponentChangingEventArgs args = new 
        ComponentChangingEventArgs(component, member);
    // The component that is about to change:       args.Component
    // The member that is about to change:          args.Member
    return args;
} //CreateComponentChangingEventArgs


System.Object
  System.EventArgs
    System.ComponentModel.Design.ComponentChangingEventArgs

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0
Mostrar: