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

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

  • Статья

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

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

Значения attributeDisplayNames являются строками Юникода. Каждый элемент состоит из пары имен с разделителями-запятыми:

<attribute name>,<display text>

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

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

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

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

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

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

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

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

  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 , чтобы зафиксировать изменения в каталоге.

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