共用方式為


實值類別與結構 (C++/CX)

實值結構實值類別是 Windows 執行階段 相容的 POD(「純舊數據結構」)。 具有固定的大小,且只包含欄位;不同於 ref 類別,此類別沒有屬性。

下列範例示範如何宣告和初始化實值結構。

// in mainpage.xaml.h:
    value struct TestStruct
    {
        Platform::String^ str;
        int i;
    };

    value struct TestStruct2
    {
        TestStruct ts;
        Platform::String^ str;
        int i;
    };

// in mainpage.cpp:
    // Initialize a value struct with an int and String
    TestStruct ts = {"I am a TestStruct", 1};

    // Initialize a value struct that contains
    // another value struct, an int and a String
    TestStruct2 ts2 = {{"I am a TestStruct", 1}, "I am a TestStruct2", 2};

    // Initialize value struct members individually.
    TestStruct ts3;
    ts3.i = 108;
    ts3.str = "Another way to init a value struct.";

當實值類型的變數指派給另一個變數時,值會被複製,使這兩個變數都具有各自的資料複本。 「 值結構 」(Value Struct) 是一種大小固定的結構,會透過 value struct 關鍵字進行宣告,且僅包含公用資料欄位。

實值類別 」(Value Class) 與 value struct 類似,差別在於其欄位必須明確指定為公用存取範圍。 其宣告可透過 value class 關鍵字來執行。

實值結構或實值類別只能以字段的形式包含基本數值類型、列舉類別或 Platform::String^Platform::IBox <T^,其中 T> 是數值類型或列舉類別或實值類別或結構。 IBox<T>^ 欄位可以有 nullptr值,這是 C++ 實作「 可為 Null 的實值類型」(Nullable Value Type) 這個概念的方式。

包含 Platform::String^IBox<T>^ 類型做為成員的實值類別或實值結構,不具備 memcpy功能。

由於 value classvalue struct 的所有成員都是公用成員,且會發出至中繼資料,因此不允許標準 C++ 類型做為成員。 這與 ref 類別不同,ref 類別可以包含 privateinternal 標準 C++ 類型。

下列程式碼片段會將 CoordinatesCity 型別宣告為值結構。 請注意,其中一個 City 資料成員是 GeoCoordinates 型別。 value struct 可包含其他實值結構做為成員。

public enum class Continent 
{  
    Africa,
    Asia,
    Australia,
    Europe,
    NorthAmerica,
    SouthAmerica,
    Antarctica 
};

value struct GeoCoordinates
{
    double Latitude; //or float64 if you prefer
    double Longitude;
};

value struct City
{
    Platform::String^ Name;
    int Population;
    double AverageTemperature;
    GeoCoordinates Coordinates;
    Continent continent;
};

參數傳遞以取得實值類型

如果您有作為函式或方法參數的實值類型,它通常依值傳遞。 對於較大的物件,這會造成效能問題。 在 Visual Studio 2013 和更早版本中,C++/CX 中的實值類型一律會以傳值方式傳遞。 在 Visual Studio 2015 及更新的版本中,您可依參考或值傳遞實值類型。

若要宣告依值傳遞實值類型的參數,請使用下列程式碼:

void Method1(MyValueType obj);

若要宣告依參考傳遞實值類型的參數,請使用參考符號 (&),如下所示:

void Method2(MyValueType& obj);

Method2 內的類型是 MyValueType 的參考,工作方式與 Standard C++ 的參考類型相同。

當您從另一種語言 (例如 C#) 呼叫 Method1 時,不必使用 refout 關鍵字。 呼叫 Method2 時,請使用 ref 關鍵字。

Method2(ref obj);

您也可以使用指標符號 (*) 依參考傳遞實值類型。 對其他語言中的呼叫端而言,行為是相同的 (呼叫端在 C# 使用 ref 關鍵字),但在方法中,類型對實值類型就是個指標。

可為 Null 的實值型別

如先前所述,實值類別或值結構可以有 Platform::IBox T^類型的字段,IBox<int>^例如 。>< 這類欄位可以有 int 類型的任何有效數值,也可以有 nullptr值。 您可以將可為 null 的欄位當做引數傳遞至其參數宣告為選擇性的方法,或傳遞至實值型別不需要有值的其他地方。

下列範例會示範如何初始化具有可為 Null 之欄位的結構。

public value struct Student
{
    Platform::String^ Name;
    int EnrollmentYear;
    Platform::IBox<int>^ GraduationYear; // Null if not yet graduated.
};
//To create a Student struct, one must populate the nullable type.
MainPage::MainPage()
{
    InitializeComponent();

    Student A;
    A.Name = "Alice";
    A.EnrollmentYear = 2008;
    A.GraduationYear = ref new Platform::Box<int>(2012);

    Student B;
    B.Name = "Bob";
    B.EnrollmentYear = 2011;
    B.GraduationYear = nullptr;

    IsCurrentlyEnrolled(A);
    IsCurrentlyEnrolled(B);
}
bool MainPage::IsCurrentlyEnrolled(Student s)
{
    if (s.GraduationYear == nullptr)
    {
        return true;
    }
    return false;
}

實值結構本身可以透過相同方式成為可為 Null 的結構,如下所示:

public value struct MyStruct
{
public:
    int i;
    Platform::String^ s;
};

public ref class MyClass sealed
{
public:
    property Platform::IBox<MyStruct>^ myNullableStruct;
};

另請參閱

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