ComponentChangingEventArgs 클래스

아티클
08/21/2007

ComponentChanging 이벤트에 대한 데이터를 제공합니다. 이 클래스는 상속될 수 없습니다.

네임스페이스: System.ComponentModel.Design
어셈블리: System(system.dll)

구문

‘선언
<ComVisibleAttribute(True)> _
Public NotInheritable Class ComponentChangingEventArgs
    Inherits EventArgs
‘사용 방법
Dim instance As ComponentChangingEventArgs

[ComVisibleAttribute(true)] 
public sealed class ComponentChangingEventArgs : EventArgs

[ComVisibleAttribute(true)] 
public ref class ComponentChangingEventArgs sealed : public EventArgs

/** @attribute ComVisibleAttribute(true) */ 
public final class ComponentChangingEventArgs extends EventArgs

ComVisibleAttribute(true) 
public final class ComponentChangingEventArgs extends EventArgs

설명

ComponentChangingEventArgs에서는 ComponentChanging 이벤트에 대한 데이터를 제공합니다. ComponentChanging 이벤트는 IComponentChangeService와 등록된 이벤트 처리기에게 현재 디자인 문서의 특정 구성 요소가 변경될 예정임을 알려 줍니다. 해당 이벤트에서는 구성 요소를 변경하지 않고 일반적으로 액세스할 수 있는 메서드를 제공합니다.

구성 요소를 변경하기 전에 ComponentChanging 이벤트가 발생합니다. 이 이벤트에서는 디자이너가 변경을 중지할 수 있는 기회를 제공합니다. 일반적으로 구성 요소 디자이너는 ComponentChanging 이벤트를 자동으로 발생시킵니다. 속성을 변경할 수 없는 경우 이벤트를 처리하는 메서드에서 예외를 throw할 수 있습니다. 예를 들어, 디자이너 파일을 소스 코드 컨트롤에 체크 인한 경우 사용자가 파일의 체크 아웃을 거부하면 일반적으로 이 이벤트 처리기에서 예외를 throw합니다.

ComponentChangingEventArgs는 다음 정보를 제공합니다.

수정할 구성 요소를 나타내는 Component 속성입니다.
변경될 멤버를 나타내는 Member 속성입니다.

참고

이 클래스에 적용되는 HostProtectionAttribute 특성의 Resources 속성 값은 SharedState입니다. HostProtectionAttribute는 대개 아이콘을 두 번 클릭하거나, 명령을 입력하거나, 브라우저에서 URL을 입력하여 시작되는 데스크톱 응용 프로그램에 영향을 미치지 않습니다. 자세한 내용은 HostProtectionAttribute 클래스나 SQL Server 프로그래밍 및 호스트 보호 특성을 참조하십시오.

상속자 참고 사항 이 클래스가 다른 클래스의 기본 클래스로 지정되면 컴파일러 오류가 발생합니다.

예제

다음 예제에서는 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 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

// 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;
}

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;
} //CreateComponentChangingEventArgs

상속 계층 구조

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

스레드로부터의 안전성

이 형식의 모든 public static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

플랫폼

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

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

참고 항목

참조

ComponentChangingEventArgs 멤버
System.ComponentModel.Design 네임스페이스
ComponentChanging
ComponentChanged
ComponentChangingEventHandler
IComponentChangeService

다음을 통해 공유