Klassen- und Attributanzeigenamen

  • Artikel

Der Anzeigespezifizierer für eine Objektklasse enthält die folgenden Attribute, mit denen die lokalisierten Anzeigenamen angegeben werden können, die auf der Benutzeroberfläche für Objekte dieser Klasse verwendet werden:

  • Das classDisplayName-Attribut ist eine einwertige Unicode-Zeichenfolge, die den Anzeigenamen der Klasse angibt.
  • Das attributDisplayNames-Attribut ist eine mehrwertige Eigenschaft, die die Namen angibt, die auf der Benutzeroberfläche für Attribute der Objektklasse verwendet werden sollen.

Die AttributeDisplayNames-Werte sind Unicode-Zeichenfolgen; Jedes Element besteht aus einem durch Trennzeichen getrennten Namenspaar:

<attribute name>,<display text>

In diesem Beispiel ist "<Attributname>" der lDAPDisplayName des Attributs und "<Anzeigetext>" der Text, der als Name dieses Attributs auf der Benutzeroberfläche angezeigt werden soll.

Richtlinien für Klassen- und Attributanzeigenamen

Da viele Anbieter Klassen mit neuen Attributen erweitern oder völlig neue Klassen erstellen können, ist es wichtig, dass die Anzeigenamen der Klasse und der Attribute eindeutig sind und keine Konflikte verursachen.

Jeder Anbieter sollte dem Anzeigenamen der Klasse einen eindeutigen benutzerfreundlichen Bezeichner basierend auf dem Namen des Anbieters vorangestellt. Wenn das fiktive Unternehmen Fabrikam Inc. beispielsweise eine neue Klasse erstellt, die von der "contact"-Klasse abgeleitet ist, kann es einen eindeutigen Klassenanzeigenamen "Fabrikam Contact" aufweisen.

Wenn ein Anbieter eine vorhandene Klasse um neue Attribute erweitert, sollte er den Anzeigenamen des Attributs erneut eindeutig identifizieren, damit keine Konflikte mit anderen Attributanzeigenamen auftreten. Auch hier empfiehlt es sich, dem Anzeigenamen des Attributs einen eindeutigen benutzerfreundlichen Bezeichner basierend auf dem Anbieternamen voran zu setzen. Wenn das Fabrikam-Unternehmen beispielsweise die Benutzerklasse um ein neues HR-Attribut erweitert, könnte das Attribut eindeutig als "Fabrikam HR Information" angezeigt werden.

Darüber hinaus sollte jeder Anbieter aus Lokalisierungssicht die Anzeigenamen der Klasse und des Attributs in jeder sprache lokalisieren, die von Windows 2000 unterstützt wird.

Hinzufügen eines Werts zum AttributDisplayNames-Attribut

So fügen Sie dem Attribut attributeDisplayNames einen Namenszuordnungswert hinzu

  1. Ermitteln Sie, ob der Namenszuordnungswert für das Attribut vorhanden ist. Wenn ein Namezuordnungswert ersetzt werden soll, löschen Sie zuerst den vorhandenen Wert mithilfe der IADs::P utEx-Methode , wobei der Parameter lnControlCode auf ADS_PROPERTY_DELETE und der vProp-Parameter auf den zu entfernenden Wert festgelegt ist. Verwenden Sie nicht ADS_PROPERTY_CLEAR oder ADS_PROPERTY_UPDATE für lnControlCode.
  2. Erstellen Sie die Zeichenfolge, die den Anzeigenamen des Attributs darstellt. Ein Beispiel finden Sie im obigen Format.
  3. Verwenden Sie die IADs::P utEx-Methode mit dem lnControlCode-Parameter , der auf ADS_PROPERTY_APPEND festgelegt ist, um den neuen Wert hinzuzufügen.
  4. Rufen Sie IADs::SetInfo auf, um die Änderungen in das Verzeichnis zu committen.

Weitere Informationen zum Benennen neuer Klassen und Attribute finden Sie unter Benennen von Attributen und Klassen.