Partager via

__value

  • Article

Notes

Cette rubrique s'applique uniquement à la version 1 des extensions managées pour C++.Cette syntaxe doit être utilisée uniquement pour conserver le code de la version 1.Consultez Classes et structures (géré) pour plus d'informations sur l'utilisation de la fonctionnalité équivalente dans la nouvelle syntaxe.

Déclare une classe pour qu'elle soit de type __value.

__value class-specifier 
__value struct-specifier 
__nogc array-specifier 
__nogc pointer-specifier

Notes

Le type __value diffère des types __gc dans le sens où les variables de type __value contiennent directement leurs données, alors que les variables gérées pointent vers leurs données, qui sont stockées sur le tas Common Langage Runtime.

Les conditions suivantes s'appliquent aux types __value :

  • Le mot clé __value ne peut pas être appliqué à une interface.

  • Un type __value peut hériter d'un nombre illimité d'interfaces mais ne peut pas hériter d'autres types ou de types __value.

  • Un type __value est sealed par définition. Pour plus d'informations, consultez __sealed.

  • Il est possible d'utiliser un type __value partout où un type managé est autorisé.

Notes

Vous ne pouvez pas utiliser le mot clé __value avec le mot clé __abstract.

Un type __value peut être explicitement connecté à un pointeur System::Object. Il s'agit du boxing.

Les indications suivantes s'appliquent à l'incorporation d'un type valeur à l'intérieur d'un type __nogc :

  • Le type valeur doit être LayoutSequential ou LayoutExplicit.

  • Il ne peut pas comporter de membres de pointeurs gc.

  • Le type valeur ne peut pas contenir des données membres privées.

Dans les Extensions managées pour C++, les équivalents pour C# class et C# struct sont les suivants :

Extensions managées pour C++

C#

Pour plus d'informations

__gc struct

ou

__gc class

class

mot clé class

__value struct

ou

__value class

struct

mot clé struct

Exemple

Dans l'exemple suivant, un type __value (V) est déclaré puis deux instances du type __value sont manipulées :

// keyword__value.cpp
// compile with: /clr:oldSyntax
#using <mscorlib.dll>

__value struct V { 
   int m_i;
};

int main() {
   V v1, v2;
   v1.m_i = 5;
   v2 = v1;   // copies all fields of v1 to v2
   v2.m_i = 6;   // does not affect v1.m_I
}