Compartilhar via

Nomes de exibição de classe e atributo

  • Artigo

O especificador de exibição de 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 DisplayNames é 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írgulas:

<attribute name>,<display text>

Neste exemplo, "<nome do atributo>" é o lDAPDisplayName do atributo e "<exibir texto>" é 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ívocas 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 "Contato fabrikam".

Se um fornecedor estender uma classe existente com novos atributos, ele deverá identificar novamente exclusivamente o nome de exibição do atributo para que nenhum conflito ocorra 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 Fabrikam estender a classe de usuário com um novo atributo de RH, 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 compatível com o 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 Atributos de Nomenclatura e Classes.