_PropertyAccessor.SetProperties(Object, Object) Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Définit les propriétés spécifiées par le tableau SchemaNames sur les valeurs spécifiées par le tableau Values.

public:
 System::Object ^ SetProperties(System::Object ^ SchemaNames, System::Object ^ Values);

public object SetProperties (object SchemaNames, object Values);

Public Function SetProperties (SchemaNames As Object, Values As Object) As Object

Paramètres

SchemaNames

Object

Tableau de noms de propriétés dont les valeurs doivent être définies comme spécifié par le paramètre Valeurs. Ces propriétés sont référencées par un espace de noms. Pour plus d’informations, consultez Référencement des propriétés par espace de noms

Values

Object

Tableau de valeurs qui doivent être définies pour les propriétés spécifiées par le paramètre NomsSchémas.

Retours

Object

Objet qui a la valeur Nothing (référence null (Nothing en Visual Basic) en C#) si l’opération réussit. Si une erreur se produit avant que des propriétés soient définies, par exemple, lorsque le nombre d’éléments dans le tableau NomsSchémas ne correspond pas à celui du tableau Valeurs et une valeur Err est renvoyée. En cas d’erreur lors de la définition des propriétés, la valeur de retour est un tableau d’objets Err , le nombre d’éléments de ce tableau étant identique à celui du tableau SchemaNames. Une valeur Err dans le tableau indique l’erreur résultant de la définition de la propriété correspondante dans le paramètre NomsSchémas.

Remarques

Si la propriété n’existe pas et que l’élément SchemaNames contient un spécificateur de propriété valide, SetProperties crée la propriété et affecte la propriété avec la valeur spécifiée par Values. Le type de la propriété est le type de l’élément passé dans Values. Si la propriété existe, SetProperties attribue à la propriété la valeur spécifiée par Values.

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 du PropertyAccessor prend en charge une opération Save explicite, les propriétés doivent être enregistrées dans l’objet avec un appel de méthode Save explicite. 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