Condividi tramite


Nomi visualizzati di classi e attributi

L'identificatore di visualizzazione per una classe oggetto contiene gli attributi seguenti che possono essere usati per specificare i nomi visualizzati localizzati usati nell'interfaccia utente per gli oggetti di tale classe:

  • L'attributo classDisplayName è una stringa Unicode a valore singolo che specifica il nome visualizzato della classe.
  • L'attributo attributeDisplayNames è una proprietà multivalore che specifica i nomi da usare nell'interfaccia utente per gli attributi della classe oggetto.

I valori attributeDisplayNames sono stringhe Unicode. Ogni elemento è costituito da una coppia di nomi delimitati da virgole:

<attribute name>,<display text>

In questo esempio "<attribute name>" è lDAPDisplayNamedell'attributo e "<display text" è il testo> da visualizzare come nome dell'attributo nell'interfaccia utente.

Linee guida per i nomi visualizzati di classi e attributi

Poiché molti fornitori possono estendere le classi con nuovi attributi o creare classi completamente nuove, è importante che la classe e i nomi visualizzati degli attributi non siano ambigui e non comportino conflitti.

Ogni fornitore deve anteporre al nome visualizzato della classe un identificatore descrittivo univoco in base al nome del fornitore. Ad esempio, se la società fittizia Fabrikam Inc., crea una nuova classe derivata dalla classe "contact", può avere un nome visualizzato univoco della classe "Contatto Fabrikam".

Se un fornitore estende una classe esistente con nuovi attributi, deve identificare nuovamente in modo univoco il nome visualizzato dell'attributo in modo che non si verifichino conflitti con altri nomi visualizzati degli attributi. Anche in questo caso, il prefisso del nome visualizzato dell'attributo con identificatore descrittivo univoco basato sul nome del fornitore è una procedura consigliata. Ad esempio, se la società Fabrikam estende la classe utente con un nuovo attributo HR, potrebbe visualizzare in modo univoco l'attributo come "Fabrikam HR Information".

Inoltre, dal punto di vista della localizzazione, ogni fornitore deve localizzare la classe e i nomi visualizzati degli attributi in ogni lingua supportata da Windows 2000.

Aggiunta di un valore all'attributo AttributeDisplayNames

Per aggiungere un valore di mapping dei nomi all'attributo AttributeDisplayNames

  1. Determinare se il valore di mapping del nome per l'attributo esiste. Se un valore di mapping dei nomi deve essere sostituito, prima di tutto eliminato il valore esistente, usando il metodo IADs::P utEx , con il parametro lnControlCode impostato su ADS_PROPERTY_DELETE e il parametro vProp impostato sul valore da rimuovere. Non usare ADS_PROPERTY_CLEAR o ADS_PROPERTY_UPDATE per lnControlCode.
  2. Creare la stringa che rappresenta il nome visualizzato dell'attributo. Per un esempio, vedere il formato precedente.
  3. Usare il metodo IADs::P utEx con il parametro lnControlCode impostato su ADS_PROPERTY_APPEND per aggiungere il nuovo valore.
  4. Chiamare IADs::SetInfo per eseguire il commit delle modifiche nella directory.

Per altre informazioni sulla denominazione di nuove classi e attributi, vedere Denominazione di attributi e classi.