_PropertyAccessor.SetProperties(Object, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Interop.Outlook

Ensamblado:

Microsoft.Office.Interop.Outlook.dll

Establece las propiedades especificadas por la matriz SchemaNames en los valores especificados por la matriz 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

Parámetros

SchemaNames

Object

Matriz de nombres de propiedades cuyos valores se van a establecer de la forma especificada por el parámetro Values. El espacio de nombres hace referencia a estas propiedades. Para obtener más información, vea Hacer referencia a propiedades por espacio de nombres.

Values

Object

Matriz de valores que se van a establecer para las propiedades especificadas por el parámetro SchemaNames.

Devoluciones

Object

Objeto que es Nothing (una referencia nula (Nothing en Visual Basic) en C#) si la operación se realiza correctamente. Si se produce un error antes de que se establecen las propiedades, por ejemplo, el número de elementos de la matriz de SchemaNames no coincide con en la matriz de Values, y se devolverá un valor Err. Si se produce un error durante la configuración de las propiedades, el valor devuelto es una matriz de objetos Err, el número de elementos de esta matriz es el mismo que el de la matriz SchemaNames. Se asigna un valor Err de la matriz en el resultado de error de configuración de la propiedad correspondiente en el parámetro SchemaNames.

Comentarios

Si la propiedad no existe y el SchemaNames elemento contiene un especificador de propiedad válido, SetProperties crea la propiedad y asigna la propiedad con el valor especificado por Values. El tipo de la propiedad será el tipo del elemento pasado en Values. Si la propiedad existe, SetProperties asigna a la propiedad el valor especificado por Values.

Tenga en cuenta que no se admite en una vista personalizada una propiedad personalizada creada usando PropertyAccessor. Si desea ver una propiedad personalizada en un elemento, cree la propiedad mediante el Add(String, OlUserPropertyType, Object, Object) método .

Si el objeto primario de PropertyAccessor admite una operación Save explícita, las propiedades se deben guardar en el objeto con una llamada explícita al método Save . Si el objeto no admite explícita operación de Guardar y, a continuación, las propiedades se guardan en el objeto cuando se llame a SetProperties.

Tenga cuidado y asegúrese de que se controlan todas las excepciones correctamente. Las condiciones en las que el establecimiento de las propiedades genera un error incluyen las siguientes:

Para obtener más información sobre cómo establecer propiedades mediante el objeto PropertyAccessor, consulte Procedimientos recomendados para obtener y establecer propiedades.