Utilisation des propriétés d'activité

Il existe deux types de propriétés d'activité : les propriétés de métadonnées et les propriétés d'instance. Une propriété de métadonnées est immuable au moment de l'exécution. Par conséquent, la propriété doit avoir une valeur littérale au moment de la conception. Une propriété d'instance peut être définie au moment de la conception ou elle peut être liée aux données d'instance, auquel cas la valeur réelle n'est pas déterminée jusqu'au moment de l'exécution. Les propriétés d'instance peuvent également être modifiées directement pendant l'exécution du workflow.

Lorsque vous implémentez une propriété d'instance, vous pouvez l'implémenter comme une propriété de classe de .NET Framework normale ou en utilisant une propriété de dépendance. C'est uniquement lorsque vous choisissez de l'implémenter en utilisant une propriété de dépendance que vous pouvez lui affecter la valeur de classe ActivityBind pour créer une liaison avec la valeur réelle accédée au moment de l'exécution. Pour plus d'informations sur les propriétés de dépendance, consultez Utilisation des propriétés de dépendance.

Remarque :
Si les propriétés proviennent d'une interface, utilisez une implémentation explicite sinon le compilateur lève une exception d'appel cible. Notez que lorsqu'une propriété est implémentée de façon explicite, elle n'est pas accessible via une instance de classe mais uniquement via une instance de l'interface.

Remarque :
Tous les types utilisés dans les propriétés d'activité doivent être marqués comme étant sérialisables.

Attributs de propriété

Le développeur d'activité personnalisé doit tenir compte d'un ensemble d'attributs lors de la définition de propriétés sur une classe d'activité. Le type ValidationOptionAttribute de Windows Workflow Foundation est utilisé pour faciliter la validation automatique des valeurs de propriété de métadonnées pour une activité. Cela signifie également que toutes valeurs ValidationOptionAttribute définies pour les propriétés de dépendance basées sur des instances sont ignorées par le DependencyObjectValidator.

La table suivante répertorie les attributs .NET Framework pertinents dans l'espace de noms System.Workflow.ComponentModel.

Attribut	Description
BrowsableAttribute	Spécifie si une propriété doit être affichée dans une fenêtre Propriétés (en général, dans Visual Studio).
DefaultValueAttribute	Indique comment la valeur de la propriété doit être interprétée. Cela ne signifie pas que la propriété sera initialisée automatiquement à la valeur spécifiée par l'attribut. Par exemple, dans votre activité personnalisée, chaque fois que la valeur de la propriété est la valeur par défaut, la propriété n'est pas sérialisée dans le code ou la balise.
DesignerSerializationVisibilityAttribute	Permet d'indiquer si la valeur d'une propriété est Visible et doit être rendue persistante, Hidden et ne doit pas être rendue persistante ou si elle se compose de Content dont le code d'initialisation doit être généré pour chaque propriété publique (non cachée) de l'objet assigné à la propriété.
EditorAttribute	Lors de la modification de la propriété, un concepteur visuel doit créer une nouvelle instance de l'éditeur spécifié à l'aide d'une boîte de dialogue ou d'une fenêtre déroulante.
ParenthesizePropertyNameAttribute	Indique à la fenêtre Propriétés si le nom de propriété associé doit être mis entre parenthèses. La fenêtre Propriétés affiche le nom d'une propriété entre parenthèses au début de la liste si l'ordre alphabétique est utilisé ou au début de sa catégorie si la fenêtre Propriétés est répartie en catégories.
MergablePropertyAttribute	Les propriétés marquées true peuvent être combinées avec des propriétés appartenant à d'autres objets dans une fenêtre Propriétés ; les propriétés marquées false doivent être affichées séparément. La valeur par défaut est true.
RefreshPropertiesAttribute	Indique comment un concepteur est actualisé lorsque les valeurs de propriété associées sont modifiées.
TypeConverterAttribute	Spécifie le type à utiliser comme convertisseur de l'objet auquel cet attribut est lié.

Attention :
Les propriétés d'activité du type Hashtable ne sont pas prises en charge dans les workflows séparés par code.

Dans cette section

Utilisation des propriétés de dépendance

Voir aussi

Concepts

Création d'activités personnalisées
Création d'activités personnalisées

Copyright ©2007 par Microsoft Corporation. Tous droits réservés.