_PropertyAccessor.SetProperty(String, Object) Méthode

Définition

Définit la propriété spécifiée par SchemaName sur la valeur spécifiée par Value.

public:
 void SetProperty(System::String ^ SchemaName, System::Object ^ Value);
public void SetProperty (string SchemaName, object Value);
Public Sub SetProperty (SchemaName As String, Value As Object)

Paramètres

SchemaName
String

Nom d’une propriété dont la valeur doit être définie comme spécifié par Value. La propriété est référencée par un espace de noms. Pour plus d’informations, consultez Référencement des propriétés par espace de noms

Value
Object

Valeur à définir pour la propriété spécifiée par SchemaName.

Remarques

Si la propriété n’existe pas et que contient SchemaName un spécificateur de propriété valide, SetProperty crée la propriété et affecte la valeur spécifiée par Value. Si la propriété existe et SchemaName est valide, SetProperty affecte la propriété avec la valeur spécifiée par Value.

Notez que la création d’une propriété personnalisée à l’aide de PropertyAccessor n’est pas prise en charge dans un affichage personnalisé. Si vous souhaitez afficher une propriété personnalisée sur un élément, créez la propriété à l’aide de la Add(String, OlUserPropertyType, Object, Object) méthode .

Si l’objet parent de l’objet PropertyAccessor prend en charge une opération Save explicite, les propriétés doivent être enregistrées dans l’objet avec un appel explicite de la méthode Save. Si l’objet ne prend pas en charge une opération Save explicite, les propriétés sont enregistrées dans l’objet lorsque la méthode SetProperties est appelée.

Procédez avec précaution et assurez-vous que toutes les exceptions sont traitées correctement. La définition d'une propriété échoue lorsque :

Pour plus d’informations sur la définition de propriétés à l’aide de l’objet PropertyAccessor , consultez Meilleures pratiques pour obtenir et définir des propriétés

S’applique à