Compartilhar via

Nomes de exibição de classe e atributo

  • Artigo

O especificador de exibição para uma classe de objeto contém os seguintes atributos que podem ser usados para especificar os nomes de exibição localizados usados na interface do usuário para objetos dessa classe:

  • O atributo classDisplayName é uma cadeia de caracteres Unicode de valor único que especifica o nome de exibição da classe.
  • O atributo attributeDisplayNames é uma propriedade de vários valores que especifica os nomes a serem usados na interface do usuário para atributos da classe de objeto.

Os valores attributeDisplayNames são cadeias de caracteres Unicode, cada elemento consiste em um par de nomes delimitado por vírgula:

<attribute name>,<display text>

Neste exemplo, "nome> do atributo" é o lDAPDisplayName do atributo e "texto> de exibição"<< é o texto a ser exibido como o nome desse atributo na interface do usuário.

Diretrizes para nomes de exibição de classe e atributo

Como muitos fornecedores podem estender classes com novos atributos ou criar classes totalmente novas, é importante que os nomes de exibição de classe e atributo sejam inequívocos e não resultem em conflitos.

Cada fornecedor deve prefixar o nome de exibição da classe com um identificador amigável exclusivo com base no nome do fornecedor. Por exemplo, se a empresa fictícia, Fabrikam Inc., criar uma nova classe derivada da classe "contact", ela poderá ter um nome de exibição de classe exclusivo "Fabrikam Contact".

Se um fornecedor estender uma classe existente com novos atributos, ele deverá novamente identificar exclusivamente o nome de exibição do atributo para que não ocorram conflitos com outros nomes de exibição de atributo. Novamente, prefixar o nome de exibição do atributo com identificador amigável exclusivo com base no nome do fornecedor é uma boa prática. Por exemplo, se a empresa da Fabrikam estender a classe de usuário com um novo atributo HR, ela poderá exibir exclusivamente o atributo como "Informações de RH da Fabrikam".

Além disso, de uma perspectiva de localização, cada fornecedor deve localizar os nomes de exibição de classe e atributo em cada idioma com suporte no Windows 2000.

Adicionando um valor ao atributo attributeDisplayNames

Para adicionar um valor de mapeamento de nome ao atributo attributeDisplayNames

  1. Determine se o valor de mapeamento de nome para o atributo existe. Se um valor de mapeamento de nome for substituído, primeiro exclua o valor existente, usando o método IADs::P utEx, com o parâmetro lnControlCode definido como ADS_PROPERTY_DELETE e o parâmetro vProp definido como o valor a ser removido. Não use ADS_PROPERTY_CLEAR ou ADS_PROPERTY_UPDATE para lnControlCode.
  2. Crie a cadeia de caracteres que representa o nome de exibição do atributo. Para obter um exemplo, consulte o formato acima.
  3. Use o método IADs::P utEx com o parâmetro lnControlCode definido como ADS_PROPERTY_APPEND para adicionar o novo valor.
  4. Chame IADs::SetInfo para confirmar as alterações no diretório.

Para obter mais informações sobre como nomear novas classes e atributos, consulte Nomeando atributos e classes.