userProfile | NN nicht zutreffend IE 4(Win) DOM nicht zutreffend | |||
Das userProfile-Objekt spiegelt die verschiedenen Informationen wider, die im Benutzerprofil des Browser für den aktuellen Benutzer gespeichert sind. Diese Objekt hat vier Methoden, mit denen Sie: |
||||
Nachdem die Informationen abgerufen wurden (mit Genehmigung des Benutzers), können sie zur Übertragung an den Server in Formularelemente eingefügt werden (entweder sichtbar oder unsichtbar). Wird laut den Kompatiblitätslisten nur in IE für Windows unterstützt. Während IE für Macintosh die Methodenaufrufe ohne Rückgabe eines Fehlers akzeptiert, haben diese Methoden hier keine Funktion. Weitere Informationen zum Benutzerprofil finden Sie auf der Microsoft-Website unter http://msdn.microsoft.com/workshop/management/profile/profile_assistant.asp. |
||||
Beispiel | ||||
navigator.userProfile.addReadRequest("vcard.displayname"); navigator.userProfile.doReadRequest("3", "MegaCorp Customer Service"); var custName = navigator.userProfile.getAttribute("vcard.displayname"); navigator.userProfile.clearRequest( ); if (custName) { ... } |
||||
Objektmodellreferenz | ||||
navigator.userProfile |
||||
Objektspezifische Eigenschaften | ||||
Keine. |
||||
Objektspezifische Methoden | ||||
|
||||
Objektspezifische Ereignisbehandlungsroutineneigenschaften | ||||
Keine. |
addReadRequest( ) | NN nicht zutreffend IE 4(Win) DOM nicht zutreffend | |||||||||||||||||||||||||||||
addReadRequest("attributeName") | ||||||||||||||||||||||||||||||
Fügt eine Anfrage zur Überprüfung eines bestimmten Benutzerprofilattributs zu einer Warteschlange hinzu, die separat ausgeführt werden muss (über die Methoden doReadRequest( ) und getAttribute( )). Der Warteschlange hinzugefügte Elemente werden dem Benutzer angezeigt, damit er oder sie die Elemente auswählen kann, die an einen Server übertragen werden sollen. Bei mehreren Attributen verwenden Sie mehrere Aufrufe der addReadRequest( )-Methode. |
||||||||||||||||||||||||||||||
Parameter | ||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
Zurückgegebener Wert | ||||||||||||||||||||||||||||||
Boolescher Wert: true (erfolgreich) | false (nicht erfolgreich). |
clearRequest( ) | NN nicht zutreffend IE 4(Win) DOM nicht zutreffend |
Entfernt den Inhalt aus der Warteschlange mit den abzurufenden Attributnamen. Verwenden Sie diese Funktion, nachdem Ihr Skript die benötigten Informationen abgerufen hat. Hiermit bereiten Sie die Warteschlange auf die nächste Liste vor. |
|
Parameter | |
Keine. |
|
Zurückgegebener Wert | |
Keiner. |
doReadRequest( ) | NN nicht zutreffend IE 4(Win) DOM nicht zutreffend | |||||||||||||||||||||||||||
doReadRequest(usageCode[, "friendlyName"[, "domain"[, "path"[, "expiration"]]]]) | ||||||||||||||||||||||||||||
Basierend auf den Elementen in der Warteschlange prüft diese Methode im Browser, ob der Benutzer bereits in der Vergangenheit die Genehmigung zur Überprüfung dieser Attribute erteilt hat. Hat der Benutzer diese Genehmigung (für einige oder alle Attribute) noch nicht erteilt, zeigt die Methode ein Dialogfeld an (das Profilassistentfenster), in dem Benutzer die Elemente deaktivieren können, die dem Server nicht offen gelegt werden sollen. Parameter liefern Informationen für das Dialogfeld und die Verwaltung der Genehmigung (ähnlich der Verwaltung von Cookies). Es ist nur eine doReadRequest( )-Methode erforderlich, ungeachtet der Anzahl von Attributen in der Warteschlange. |
||||||||||||||||||||||||||||
Parameter | ||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||
Zurückgegebener Wert | ||||||||||||||||||||||||||||
Unter Windows gibt diese Methode keinen Wert zurück, ungeachtet der Art und Weise, wie der Benutzer im Profilassistentenfenster reagiert. Auf dem Macintosh (der dieses Objekt nicht voll unterstützt) zeigt die Methode kein Profilassistentenfenster an und gibt false zurück. |
getAttribute( ) | NN nicht zutreffend IE 4 DOM nicht zutreffend |
getAttribute("attributeName") | |
Gibt den Wert des Attributs zurück, sofern der Benutzer die Erlaubnis dazu erteilt hat. Liegt diese Erlaubnis nicht vor, gibt die Methode den Wert null zurück. Verwenden Sie für jeden Attributwert, den Sie abfragen möchten, eine eigene getAttribute( )-Methode. |
|
Parameter | |
|
|
Zurückgegebener Wert | |
Zeichenfolgenwert oder null |
getAttribute( ) | NN 6 IE 4 DOM 1 |
getAttribute(attributeName) getAttribute(attributeName[,caseSensitivity]) | |
Gibt den Wert des benannten Attributs innerhalb des aktuellen Elements zurück. Wenn das Attribut im Objektmodell als Eigenschaft widergespiegelt wird, gibt diese Methode denselben Wert zurück wie das Auslesen der entsprechenden Eigenschaft des Objekts. Hierbei handelt es sich um die laut W3C-DOM bevorzugte Methode zum Lesen eines Objektattributwerts (also eines Eigenschaftswerts). |
|
Bei dem Attributnamen, den Sie als Parameter übergeben, spielt die Groß- und Kleinschreibung in den aktuellen Browsern keine Rolle. IE stellt allerdings einen optionalen zweiten Parameter bereit, mit dem Sie die Berücksichtigung der Groß-/Kleinschreibung in Attributnamen erzwingen können. Dies könnte dazu verleiten, Attributnamen in unterschiedlicher Schreibweise mehrmals zu verwenden – eine Praxis, von der dringend abgeraten wird. |
|
Informationen zum Zuweisen von Werten zu Attributen und zum Erstellen neuer Attribut-/Wertpaare finden Sie in der Abhandlung der Methode setAttribute( ). |
|
Parameter | |
|
|
Zurückgegebener Wert | |
Das W3C-DOM und Netscape 6 verwalten Attributwerte ausschließlich als Zeichenfolgendatentypen (Strings). IE hingegen kann einen Attributwert in Form einer Zeichenfolge, eines Zahlenwerts oder eines Booleschen Werts zurückgeben. |