Compartir a través de

Asignar categorías a un elemento

  • Artículo

En este ejemplo se muestra cómo asignar categorías a un elemento mediante su propiedad Categories.

Ejemplo

Nota:

El siguiente ejemplo de código es un fragmento de Programming Applications for Microsoft Office Outlook 2007 (Programación de aplicaciones para Microsoft Office Outlook 2007).

Para asignar categorías a un elemento use la propiedad Categories del elemento. Este ejemplo de código utiliza la clase auxiliar OutlookItem, definida en Create a Helper class to access common Outlook item members (Crear una clase auxiliar para acceder a los miembros de elementos comunes de Outlook) para llamar a la propiedad OutlookItem.Categories sin tener que convertir antes el elemento. La propiedad Categories obtiene o establece las categorías que se representan mediante una cadena delimitada por comas que puede contener un máximo de 255 caracteres. Las comas y los espacios se usan para separar los valores de categoría. Asignar una categoría que no esté en la colección Categories del objeto NameSpace provocará que una categoría no muestre un color.

En el ejemplo de código siguiente, AssignCategories crea una restricción para los elementos que contienen "ISV" en el asunto mediante una consulta DAV Searching and Locating (DASL) para filtrar los elementos de la Bandeja de entrada que contienen "ISV" en el asunto. AssignCategories recorre en iteración los elementos filtrados mediante la clase OutlookItem y, si la cadena devuelta por item. Categories no es una referencia nula o ya se asignó al ISV, la categoría ISV se asigna al elemento.

using Outlook = Microsoft.Office.Interop.Outlook;

private void AssignCategories()
{
    string filter = "@SQL=" + "\"" + "urn:schemas:httpmail:subject"
        + "\"" + " ci_phrasematch 'ISV'";
    Outlook.Items items =
        Application.Session.GetDefaultFolder(
        Outlook.OlDefaultFolders.olFolderInbox).Items.Restrict(filter);
    for (int i = 1; i <= items.Count; i++)
    {
        OutlookItem item = new OutlookItem(items[i]);
        string existingCategories = item.Categories;
        if (String.IsNullOrEmpty(existingCategories))
        {
            item.Categories = "ISV";
        }
        else
        {
            if (item.Categories.Contains("ISV") == false)
            {
                item.Categories = existingCategories + ", ISV";
            }
        }
        item.Save();
    }
}

Vea también