Поделиться через

Отображаемые имена классов и атрибутов

  • Статья

Описатель отображения для класса объектов содержит следующие атрибуты, которые можно использовать для указания локализованных имен отображения, используемых в пользовательском интерфейсе для объектов этого класса:

  • Атрибут classDisplayName — это строка Юникода с одним значением, указывающая отображаемое имя класса.
  • Атрибут атрибутDisplayNames — это свойство с несколькими значениями, указывающее имена, используемые в пользовательском интерфейсе для атрибутов класса объектов.

Значения атрибута DisplayNames являются строками Юникода; каждый элемент состоит из пары имен с разделителями-запятыми:

<attribute name>,<display text>

В этом примере "<имя атрибута>" — это lDAPDisplayName атрибута и "<отображаемого текста>" — это текст, отображаемый в качестве имени этого атрибута в пользовательском интерфейсе.

Рекомендации по отображаемым именам классов и атрибутов

Так как многие поставщики могут расширять классы с новыми атрибутами или создавать совершенно новые классы, важно, чтобы отображаемые имена классов и атрибутов были однозначно и не приводят к конфликтам.

Каждый поставщик должен префиксировать отображаемое имя класса с уникальным понятным идентификатором на основе имени поставщика. Например, если вымышленная компания Fabrikam Inc., создает новый класс, производный от класса contact, он может иметь уникальное отображаемое имя класса Fabrikam Contact.

Если поставщик расширяет существующий класс с новыми атрибутами, он снова должен однозначно определить отображаемое имя атрибута, чтобы не возникали конфликты с другими отображаемыми именами атрибутов. Опять же, префикс отображаемого имени атрибута с уникальным понятным идентификатором на основе имени поставщика рекомендуется. Например, если компания Fabrikam расширяет класс пользователя с новым атрибутом HR, они могут уникально отображать атрибут как "Fabrikam HR Information".

Кроме того, с точки зрения локализации каждый поставщик должен локализовать имена классов и атрибутов на каждом языке, поддерживаемом Windows 2000.

Добавление значения в атрибут AttributeDisplayNames

Добавление значения сопоставления имен в атрибут DisplayNames атрибута

  1. Определите, существует ли значение сопоставления имен для атрибута. Если необходимо заменить значение сопоставления имен, сначала удалите существующее значение с помощью метода IADs::P utEx с параметром lnControlCode значение ADS_PROPERTY_DELETE и параметр vProp, заданный для удаления значения. Не используйте ADS_PROPERTY_CLEAR или ADS_PROPERTY_UPDATE для lnControlCode.
  2. Создайте строку, представляющую отображаемое имя атрибута. Пример см. в приведенном выше формате.
  3. Используйте метод IADs::P utEx с параметром lnControlCode значением ADS_PROPERTY_APPEND, чтобы добавить новое значение.
  4. Вызовите IADs::SetInfo для фиксации изменений в каталоге.

Дополнительные сведения об именовании новых классов и атрибутов см. в разделе Атрибуты именования и классы.