Note Note

This topic applies only to version 1 of Managed Extensions for C++. This syntax should only be used to maintain version 1 code. See property (C++ Component Extensions) for information on using the equivalent functionality in the new syntax.

Declares either a scalar or indexed property for the managed class.

__property function-declarator

The __property keyword introduces the declaration of a property and can appear in a class, interface, or value type. A property can have a getter function (read only), a setter function (write only), or both (read-write).

Note Note

A property name cannot match the name of the managed class containing it. The return type of the getter function must match the type of the last parameter of a corresponding setter function.

In the following example, a scalar property (Size) is added to the MyClass declaration. The property is then implicitly set and retrieved using the get_Size and set_Size functions:

// keyword__property.cpp
// compile with: /clr:oldSyntax
#using <mscorlib.dll>
using namespace System;

__gc class MyClass {
   MyClass() : m_size(0) {}
   __property int get_Size() { return m_size; }
   __property void set_Size(int value) { m_size = value; }
   // compiler generates pseudo data member called Size
   int m_size;

int main() {
   MyClass* class1 = new MyClass;
   int curValue;

   class1->Size = 4;   // calls the set_Size function with value==4

   curValue = class1->Size;   // calls the get_Size function

Community Additions