ComponentChangingEventArgs Класс

Определение

Пространство имен:

System.ComponentModel.Design

Сборка:

System.dll

Предоставляет данные для события ComponentChanging. Этот класс не наследуется.

public ref class ComponentChangingEventArgs sealed : EventArgs

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ComponentChangingEventArgs : EventArgs

[<System.Runtime.InteropServices.ComVisible(true)>]
type ComponentChangingEventArgs = class
    inherit EventArgs

Public NotInheritable Class ComponentChangingEventArgs
Inherits EventArgs

Наследование

Object

EventArgs

ComponentChangingEventArgs

Атрибуты

ComVisibleAttribute

Примеры

В следующем примере показано создание ComponentChangingEventArgs.

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

// 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 Function CreateComponentChangingEventArgs(ByVal component As Object, ByVal member As MemberDescriptor) As ComponentChangingEventArgs
    Dim args As New ComponentChangingEventArgs(component, member)

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

    Return args
End Function

Комментарии

ComponentChangingEventArgs предоставляет данные о событии ComponentChanging . Событие ComponentChanging уведомляет IComponentChangeService и зарегистрированные обработчики событий о том, что определенный компонент в текущем документе конструктора будет изменен. Это событие предоставляет широко доступный метод, чтобы предотвратить изменение компонента.

Событие ComponentChanging возникает перед изменением компонента. Это событие дает возможность конструктору прервать изменение. Конструкторы компонентов обычно автоматически вызывают ComponentChanging событие. Если свойство нельзя изменить, метод, обрабатывающий событие, может вызвать исключение. Например, если файл конструктора проверяется в элементе управления исходным кодом, обработчик этого события обычно вызывает исключение, если пользователь отказывается проверить файл.

Ответ ComponentChangingEventArgs содержит следующие сведения:

• Свойство Component , указывающее компонент, который будет изменен.

• Свойство Member , указывающее элемент, который будет изменен.

Примечания для тех, кто наследует этот метод

Ошибка компилятора возникает, если этот класс указан как базовый класс другого класса.

Конструкторы

Имя	Описание
ComponentChangingEventArgs(Object, MemberDescriptor)	Инициализирует новый экземпляр класса ComponentChangingEventArgs.

Свойства

Имя	Описание
Component	Возвращает компонент, который будет изменен или компонент, который является родительским контейнером элемента, который будет изменен.
Member	Возвращает элемент, который будет изменен.

Методы

Имя	Описание
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• ComponentChanging
• ComponentChanged
• ComponentChangingEventHandler
• IComponentChangeService