다음을 통해 공유

Partial 클래스(C++/CX)

  • 아티클

partial 클래스는 사용자가 클래스 정의의 한 부분을 수정할 때 자동 코드 생성 소프트웨어(예: XAML 디자이너)도 동일한 클래스의 코드를 수정하는 시나리오를 지원하는 생성자입니다. partial 클래스를 사용하면 디자이너가 코드를 덮어쓰지 않게 할 수 있습니다. Visual Studio 프로젝트에서는 생성된 파일에 partial 한정자가 자동으로 적용됩니다.

구문

partial 클래스를 정의하려면 클래스 키 바로 앞에 partial 키워드를 사용합니다. 그렇지 않으면 일반 클래스 정의가 됩니다. partial ref class 와 같은 키워드는 공백 문자를 포함하는 컨텍스트 키워드입니다. 부분 정의는 다음 생성자에서 지원됩니다.

  • class 또는 struct

  • ref class 또는 ref struct

  • value class 또는 value struct

  • enum 또는 enum class

  • ref interface, interface class, interface struct 또는 __interface

  • union

이 예제에서는 partial ref class를 보여 줍니다.

partial ref class MyClass {/* ... */};

콘텐츠

partial 클래스 정의에서 partial 키워드를 생략할 경우 전체 클래스 정의에 포함될 수 있는 모든 내용이 포함될 수 있습니다. 여기에는 한 가지 경우를 제외하고, 기본 클래스, 데이터 멤버, 멤버 함수, 열거형, friend 선언 및 특성과 같은 모든 유효한 생성자가 포함됩니다. 정적 데이터 멤버의 인라인 정의가 허용됩니다.

한 가지 예외는 클래스 액세스 가능성입니다. 예를 들어 public partial class MyInvalidClass {/* ... */}; 구문은 오류입니다. MyInvalidClass의 partial 클래스 정의에 사용되는 액세스 지정자는 MyInvalidClass의 후속 부분 또는 전체 클래스 정의의 기본 액세스 가능성에 영향을 미치지 않습니다.

다음 코드 조각에서 액세스 가능성을 보여 줍니다. 첫 번째 partial 클래스에서 Method1 은 액세스 가능성이 public이므로 공용입니다. 두 번째 partial 클래스에서 기본 클래스 액세스 가능성이 private이므로 Method2 는 전용입니다.

partial ref class N 
{
public:
    int Method1(); // Method1 is public.

};
ref class N 
{   
    void Method2(); // Method2 is private.
};

선언

클래스의 부분 정의(예: MyClass MyClass 선언)입니다. 즉, 이름 MyClass만 소개합니다. MyClass클래스 정의가 필요한 방식으로 사용할 수 없습니다. 예를 들어 기본 또는 멤버MyClass의 MyClass 크기를 알거나 사용합니다. MyClass 는 컴파일러에서 부분 정의가 아닌 MyClass경우 정의되는 것으로 간주됩니다.

다음 예제에서는 partial 클래스의 선언 동작을 보여 줍니다. 선언 #1 MyClass 후에는 전달 선언 ref class MyClass;으로 작성된 것처럼 사용할 수 있습니다. 선언 #2는 선언 #1과 같습니다. 선언 #3은 클래스에 대한 전달 선언이므로 유효합니다. 그러나 Declaration #4는

MyClass 가 완전히 정의되지 않았습니다.

선언 #5는 키워드를 partial 사용하지 않으며 선언은 완전히 정의합니다 MyClass. 따라서 Declaration #6은 유효합니다.

// Declaration #1
partial ref class MyClass {};

// Declaration #2
partial ref class MyClass;

// Declaration #3
MyClass^ pMc; // OK, forward declaration.

// Declaration #4
MyClass mc; // Error, MyClass is not defined.

// Declaration #5
ref class MyClass { };

// Declaration #6
MyClass mc; // OK, now MyClass is defined.

번호 및 순서 지정

클래스의 모든 전체 정의에는 0개 이상의 부분 클래스 정의가 있을 수 있습니다.

클래스의 모든 부분 클래스 정의는 어휘적으로 해당 클래스의 전체 정의보다 앞에 나와야 하지만 클래스의 정방향 선언보다 앞에 나올 필요는 없습니다. 클래스의 전체 정의가 없는 경우 부분 클래스 선언만 정방향 선언이 될 수 있습니다.

class 및 struct 와 같은 모든 클래스 키가 일치해야 합니다. 예를 들어, partial class X {}; struct X {};만 생성합니다.

다음 예제에서는 번호 및 순서 지정을 보여 줍니다. 클래스가 이미 정의되어 있으므로 마지막 partial 선언은 실패합니다.

ref class MyClass;  // OK
partial ref class MyClass{};  //OK
partial ref class MyClass{}; // OK
partial ref class MyClass{}; // OK
ref class MyClass{}; // OK
partial ref class MyClass{}; // C3971, partial definition cannot appear after full definition.

전체 정의

클래스 X의 전체 정의 지점에서는 X 정의가 모든 기본 클래스, 멤버 등을 partial 클래스에서 발견되고 정의된 순서대로 선언한 것처럼 동작이 동일합니다. 즉, partial 클래스의 내용은 클래스의 전체 정의 지점에 작성된 것처럼 처리되고, 이름 조회 및 다른 언어 규칙은 partial 클래스의 내용이 제자리에 작성된 것처럼 클래스의 전체 정의 지점에 적용됩니다.

다음의 두 코드 예제는 의미와 효과가 동일합니다. 첫 번째 예에서는 partial 클래스를 사용하고 두 번째 예에서는 그렇지 않습니다.

ref class Base1 { public: property int m_num; int GetNumBase();};
interface class Base2 { int GetNum(); };
interface class Base3{ int GetNum2();};

partial ref class N : public Base1 
{
public:
    /*...*/

};

partial ref class N : public Base2
{
public:
    virtual int GetNum();
    // OK, as long as OtherClass is
    //declared before the full definition of N
    void Method2( OtherClass^ oc );       
};

ref class OtherClass;

ref class N : public Base3
{    
public:
    virtual int GetNum2();
};

 

ref class OtherClass;
ref class N : public Base1, public Base2, public Base3 
{
public:    
    virtual int GetNum();
    virtual int GetNum2();
private:    
    void Method2(OtherClass^ oc);

};

템플릿

partial 클래스는 템플릿이 될 수 없습니다.

제한 사항

partial 클래스는 번역 단위를 벗어날 수 없습니다.

partial 키워드는 ref class 키워드 또는 value class 키워드와 함께만 사용할 수 있습니다.

예제

다음 예제는 두 코드 파일에 걸쳐 Address 클래스를 정의합니다. 디자이너가 Address.details.h 를 수정하고 사용자가 Address.h를 수정합니다. 첫 번째 파일의 클래스 정의만 partial 키워드를 사용합니다.

// Address.Details.h
partial ref class Address
{
private:
  Platform::String^ street_;
  Platform::String^ city_;
  Platform::String^ state_;
  Platform::String^ zip_;
  Platform::String^ country_;
  void ValidateAddress(bool normalize = true);
};

 

// Address.h
#include "Address.details.h"
ref class Address
{
public:
  Address(Platform::String^ street, Platform::String^ city, Platform::String^ state,
    Platform::String^ zip, Platform::String^ country);
  property Platform::String^ Street { Platform::String^ get(); }
  property Platform::String^ City { Platform::String^ get(); }
  property Platform::String^ State { Platform::String^ get(); }
  property Platform::String^ Zip { Platform::String^ get(); }
  property Platform::String^ Country { Platform::String^ get(); }
};

참고 항목

형식 시스템
C++/CX 언어 참조
네임스페이스 참조