<Property, élément (.NET Native)>

Applique la stratégie de réflexion runtime à une propriété.

Syntaxe

<Property Name="property_name"
          Browse="policy_type"
          Dynamic="policy_type"
          Serialize="policy_type" />

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Name (attribut)

Tous les autres attributs

Éléments enfants

Aucune.

Éléments parents

Notes

Si la stratégie d'une propriété n'est pas définie explicitement, elle hérite la stratégie runtime de son élément parent.

Exemple

L'exemple suivant utilise la réflexion pour instancier un objet Book et afficher les valeurs de ses propriétés. Le fichier default.rd.xml d'origine du projet se présente comme suit :

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
   <Application>
      <Namespace Name="LibraryApplications"  Browse="Required Public" >
         <Type Name="Book"   Activate="All" />
      </Namespace>
   </Application>
</Directives>

Le fichier applique la valeur All à la stratégie Activate pour la classe Book, ce qui permet d'accéder aux constructeurs de classe par réflexion. La stratégie Browse pour la classe Book est héritée de son espace de noms parent. Cette option est définie sur Required Public, ce qui rend les métadonnées disponibles au moment de l'exécution.

Voici le code source de l'exemple. La outputBlock variable représente un TextBlock contrôle.

namespace LibraryApplications
{
   public sealed class Example
   {
      public void Execute()
      {
         TextBlock outputBlock = MainPage.outputBlock;
         Type t = typeof(Book);
         Object obj = Activator.CreateInstance(t, new Object[] { "A Tale of 2 Cities", "Charles Dickens", "" });
         outputBlock.Text += "\n\n\n";
         foreach (var p in t.GetRuntimeProperties())
         {
            outputBlock.Text += String.Format("{0}: {1}\n", p.Name, p.GetValue(obj));
         }
      }
   }

   public class Book
   {
      private string bookTitle = "";
      private string bookAuthor = "";
      private string bookISBN = "";

      public Book(string title, string author, string isbn)
      {
         bookTitle = title;
         bookAuthor = author;
         bookISBN = isbn;
      }

      public string Title
      {
         get { return bookTitle; }
         set { bookTitle = value; }
      }

      public string Author
      {
         get { return bookAuthor; }
         set { bookTitle = value; }
      }

      public string ISBN
      {
         get { return bookISBN; }
      }

      public override string ToString()
      {
         return String.Format("{0}, {1}", Author, Title);
      }
   }
}

public class TextUtilities
{
   public static string ConvertNumberToWord(int value)
   {
      switch (value)
      {
         case 1:
            return "One";
         case 2:
            return "Two";
         case 3:
            return "Three";
         case 4:
            return "Four";
         case 5:
            return "Five";
         case 6:
            return "Six";
         case 7:
            return "Seven";
         case 8:
            return "Eight";
         case 9:
            return "Nine";
         default:
            return value.ToString();
      }
   }
}

Cependant, la compilation et l’exécution de cet exemple lèvent une exception MissingRuntimeArtifactException. Bien que les métadonnées soient disponibles pour le type Book, nous n'avons pas pu rendre les implémentations des accesseurs Get de propriété disponibles dynamiquement. Nous pouvons corriger cette erreur de deux manières :

• en définissant la Dynamic stratégie pour le Book type dans son <élément Type> .

• En ajoutant un élément Property> imbriqué <pour chaque propriété dont getter nous aimerions appeler, comme le fait le fichier default.rd.xml suivant.

  <Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
     <Application>
        <Namespace Name="LibraryApplications"  Browse="Required Public" >
           <Type Name="Book"   Activate="All" >
              <Property Name="Title" Dynamic="Required" />
              <Property Name="Author" Dynamic="Required" />
                <Property Name="ISBN" Dynamic="Required" />
           </Type>
        </Namespace>
     </Application>
  </Directives>
  

Voir aussi

• Guide de référence du fichier de configuration des directives runtime (rd.xml)
• Éléments de directive runtime
• Paramètres de stratégie de directive runtime