Ref 類別與結構 (C++/CX)

發行項
11/21/2024

C++/CX 支援使用者定義的 ref 類別 和 ref 結構，以及使用者定義的 實值類別 和 值結構。這些數據結構是C++/CX支援 Windows 執行階段類型系統的主要容器。其內容會根據特定規則發出至元數據，這可讓這些內容在 Windows 執行階段元件與以C++或其他語言撰寫的通用 Windows 平台應用程式之間傳遞。

ref 類別或 ref 結構具有這些必要功能：

您必須在命名空間中 (在命名空間範圍) 宣告此類別，且此類別在該命名空間中可以具有公用或私用存取範圍。只有公用型別會發出至中繼資料。不允許巢狀公用類別定義，包括巢狀公用列舉類別。如需詳細資訊，請參閱命名空間和類型可見性。
它可以包含為成員C++/CX，包括 ref 類別、值類別、ref 結構、值結構或可為 Null 的值結構。它也可能包含純量類型，例如 float64、 bool等等。它也可以包含標準 C++ 類型 (例如 std::vector ) 或自訂類別，只要這些不是公用項目即可。 C++/CX 建構可能有 public、、protected、 internalprivate或 protected private 輔助功能。所有 public 或 protected 成員都會發出至中繼資料。標準 C++ 類型必須包含 private、 internal或 protected private 存取範圍，以避免發出至中繼資料。
可以實作一個或多個「 介面類別 」(Interface Class) 或「 介面結構」(Interface Struct)。
可以繼承自一個基底類別，而基底類別本身會有其他限制。公用 ref 類別階層中的繼承比私用 ref 類別中的繼承有更多限制。
不可以宣告為泛型。如果具有私用存取範圍，可以是範本。
其存留期會由自動參考計數來管理。

宣告

下列程式碼片段會宣告 Person ref 類別。請注意，在私用成員中使用標準C++std::map型別，而 Windows 執行階段 IMapView 介面則用於公用介面中。同時也請注意，參考類型的宣告附加了 "^"。

// #include <map>
namespace WFC = Windows::Foundation::Collections;
namespace WFM = Windows::Foundation::Metadata;

[WFM::WebHostHidden]
ref class Person sealed
{
public:
    Person(Platform::String^ name);
    void AddPhoneNumber(Platform::String^ type, Platform::String^ number);
    property WFC::IMapView<Platform::String^, Platform::String^>^ PhoneNumbers
    { 
        WFC::IMapView<Platform::String^, Platform::String^>^ get();
    }
private:
    Platform::String^ m_name;
    std::map<Platform::String^, Platform::String^> m_numbers;
};

實作

此程式碼範例示範 Person ref 類別的實作：

#include <collection.h>
using namespace Windows::Foundation::Collections;
using namespace Platform;
using namespace Platform::Collections;

Person::Person(String^ name): m_name(name) { }
void Person::AddPhoneNumber(String^ type, String^ number)
{
    m_numbers[type] = number;
}
IMapView< String^, String^>^ Person::PhoneNumbers::get()
{
    // Simple implementation. 
    return ref new MapView< String^, String^>(m_numbers);
}

使用方式

下一個程式碼範例則說明用戶端程式碼如何使用 Person ref 類別。

using namespace Platform;

Person^ p = ref new Person("Clark Kent");
p->AddPhoneNumber("Home", "425-555-4567");
p->AddPhoneNumber("Work", "206-555-9999");
String^ workphone = p->PhoneNumbers->Lookup("Work");

您也可以使用堆疊語意宣告區域 ref 類別變數。即使記憶體仍是以動態方式配置的，這類物件的行為還是會類似於堆疊式變數。一個重要的差異在於，您無法將追蹤參考 (%) 指派給使用堆疊語意宣告的變數，這可以確保參考計數在函式結束時將會減為零。下列範例示範基本 ref 類別 Uri，以及將其與堆疊語意搭配使用的函式：

void DoSomething()
{
    Windows::Foundation::Uri docs("http://docs.microsoft.com");
    Windows::Foundation::Uri^ devCenter = docs.CombineUri("/windows/");
    // ... 
} // both variables cleaned up here.

記憶體管理

您可以使用 ref new 關鍵字，在動態記憶體中配置 ref 類別。

MyRefClass^ myClass = ref new MyRefClass();

句柄到物件運算符 ^ 稱為 hat ，基本上是C++智慧型指標。它所指向的記憶體在最後一個 Hat 超出範圍或明確設定為 nullptr時，即會自動終結。

根據定義，ref 類別具有參考語意。當您指派 ref 類別變數時，所指派的會是複製的控制代碼，而不是物件本身。在下一個範例中，進行指派後， myClass 和 myClass2 會指向相同的記憶體位置。

MyRefClass^ myClass = ref new MyRefClass();
MyRefClass^ myClass2 = myClass;

具現化 C++/CX ref 類別時，會在呼叫其建構函式之前，將其記憶體初始設定為零；因此，不需要對個別成員進行歸零初始設定作業 (包括屬性)。如果 C++/CX 類別衍生自 Windows Runtime C++ Library (WRL) 類別，只會對 C++/CX 衍生類別部分進行歸零初始設定。

成員

ref 類別可包含 public、 protected和 private 函式成員，其中只有 public 和 protected 成員會發出至中繼資料。允許巢狀類別和 ref 類別，但不可以是 public。不允許公用欄位；公用資料成員必須宣告為屬性。私用或受保護的內部資料成員可以是欄位。根據預設，在 ref 類別中，所有成員的存取範圍都是 private。

ref 結構與 ref 類別相同，差別在於前者的成員依預設具有 public 存取範圍。

public ref 類別或 ref 結構會在元數據中發出，但要從其他通用 Windows 平台應用程式和 Windows 執行階段元件使用，它至少必須有一個公用或受保護的建構函式。具有公用建構函式的公用 ref 類別也必須宣告為 sealed ，以避免透過應用程式二進位介面 (ABI) 而進一歩衍生。

公用成員可能不會宣告為 const ，因為 Windows 執行階段類型系統不支援 const。您可以使用靜態屬性來宣告具有常數值的公用資料成員。

當您定義公用 ref 類別或結構時，編譯器會將必要的屬性套用至類別，並將該資訊存放在應用程式的 .winmd 檔案中。不過，當您定義公用未密封的 ref 類別時，請手動套用 Windows::Foundation::Metadata::WebHostHidden 屬性，以確保通用 Windows 平台以 JavaScript 撰寫的應用程式看不到類別。

ref 類別可以在任何 const 、 private或 internal成員中使用標準 C++ 類型，包括 protected private 類型。

不允許具有型別參數的公用 ref 類別。不允許使用者定義的泛型 ref 類別。私用、內部或受保護的私用 ref 類別可以是範本。

解構函式

在 C++/CX 中， delete 呼叫公用解構函式會叫用解構函式，而不論對象的參考計數為何。這個行為可讓您定義解構函式，該解構函式會以非常確定的方式執行非 RAII 資源的自訂清除。不過，即使在這個情況下，物件本身還是不會從記憶體中刪除。只有當參考計數到達零時，才會釋放此物件的記憶體。

如果類別的解構函式非公用，則只有當參考計數到達零時才會叫用它。如果您在具有私用解構函式的物件上呼叫 delete ，編譯程式會引發警告 C4493，該警告指出「刪除表達式沒有作用，因為類型名稱>的<解構函式沒有 'public' 輔助功能。」

Ref 類別解構函式只能宣告如下：

公用和虛擬 (適用於密封或非密封類型)
受保護的私用和非虛擬 (適用於非密封類型)
私用和非虛擬 (僅適用於密封類型)

不允許存取範圍、虛擬及密封的其他任何組合。如果您未明確宣告解構函式，則編譯器會在類型的基底類別或任何成員具有公用解構函式時，產生公用虛擬解構函式。否則，編譯器會為非密封類型產生受保護的私用非虛擬解構函式，或為密封類型產生私用非虛擬解構函式。

如果您嘗試存取的類別成員已執行其解構函式，則表示此行為是未定義的；這很有可能會導致程式當機。針對沒有公用解構函式的類型呼叫 delete t 沒有作用。針對在類型或基底類別的類型階層中，已知有 delete this 或 private 解構函式的類型或基底類別呼叫 protected private 也沒有作用。

當您宣告公用解構函式時，編譯器會產生程式碼，讓 ref 類別實作 Platform::IDisposable ，且解構函式實作 Dispose 方法。 Platform::IDisposable 是的C++/CX 投影 Windows::Foundation::IClosable。絕對不要明確實作這些介面。

繼承

Platform::Object 是所有 ref 類別的通用基底類別。所有 ref 類別都會隱含轉換為 Platform::Object，而且也都能覆寫 Object::ToString。不過，Windows 執行階段繼承模型不是作為一般繼承模型;在 C++/CX 中，這表示使用者定義的公用 ref 類別無法做為基類。

如果您要建立 XAML 使用者控制項，而且物件參與相依性屬性系統，則您可以使用 Windows::UI::Xaml::DependencyObject 做為基底類別。

定義繼承自 MyBase 的未密封類別 DependencyObject之後，元件或應用程式中的其他公用或私用 ref 類別則可以繼承自 MyBase。您應該只有在為了支援虛擬方法、多型識別及封裝的覆寫時，才執行公用 ref 類別中的繼承。

您不需要從現有的未密封類別衍生私用基底 ref 類別。如果您需要物件階層建立您自己的程式結構模型，或允許重複使用程式碼，則使用私用或內部 ref 類別，或最好使用 Standard C++ 類別。您可以透過公用密封 ref 類別包裝函式，公開私用物件階層的功能。

在 C++/CX 中具有公用或受保護建構函式的 ref 類別，必須宣告為密封。這項限制表示無法讓以 C# 或 Visual Basic 等其他語言撰寫的類別繼承自您在以 C++/CX 撰寫之 Windows 執行階段元件中宣告的類型。

以下是 C++/CX 中繼承的基本規則：

ref 類別最多可直接繼承自一個基底 ref 類別，但可以實作任意數目的介面。
如果類別具有公用建構函式，也必須宣告為密封類別，以避免進一歩衍生。
您可以建立具有內部或受保護的私用建構函式之公用未密封基底類別，但是前提是此基底類別直接或間接衍生自現有的未密封基底類別，例如 Windows::UI::Xaml::DependencyObject。不支援跨 .winmd 檔案繼承使用者定義的 ref 類別；但是，ref 類別可以繼承自其他 .winmd 檔案中定義的介面。您只能在相同的 Windows 執行階段元件或通用 Windows 平台應用程式中，從使用者定義的基底 ref 類別建立衍生類別。

針對 ref 類別，只支援公用繼承。

ref class C{};
public ref class D : private C //Error C3628
{};

下列範例示範如何公開衍生自繼承階層中其他 ref 類別的公用 ref 類別。

namespace InheritanceTest2 
{
    namespace WFM = Windows::Foundation::Metadata;

    // Base class. No public constructor.
    [WFM::WebHostHidden]
    public ref class Base : Windows::UI::Xaml::DependencyObject
    {
    internal:
        Base(){}
    protected:
        virtual void DoSomething (){}
        property Windows::UI::Xaml::DependencyProperty^ WidthProperty;
    };

    // Class intended for use by client code across ABI.
    // Declared as sealed with public constructor.
    public ref class MyPublicClass sealed : Base
    {
    public:
        MyPublicClass(){}
        //...
    };
}

另請參閱

類型系統
 實值類別與結構
 C++/CX 語言參考
 命名空間參考

共用方式為

Ref 類別與結構 (C++/CX)

宣告

實作

使用方式

記憶體管理

成員

解構函式

繼承

另請參閱

意見反應

其他資源