Enables the object to persist data in user data. dhtml语法 XML |
<Prefix:
CustomTag ID=sID STYLE="behavior:url('#default#userdata')" />
|
---|
HTML |
<ELEMENT STYLE="behavior:url('#default#userData')" ID=sID> |
---|
Scripting | object.style.behavior = "url('#default#userdata')" |
---|
object.addbehavior ("#default#userdata") |
dhtml可能的值 prefix | prefix that associates the CustomTag with an XML namespace. This prefix is
set using the xmlns attribute of the HTML
tag.
| CustomTag | User-defined tag. | sID | String that specifies a unique identifier for the object. | |
Members Table
The following table lists the members exposed by the
userData
object. Click a tab on the left to choose the type of member you want to view. Attributes/Properties Property | Description |
---|
expires |
Sets or retrieves the expiration date of data persisted with the userData behavior. | XMLDocument |
Retrieves a reference to the XML Document Object Model (DOM) exposed by the object. |
Methods Method | Description |
---|
getAttribute |
Retrieves the value of the specified attribute. | load |
Loads an object participating in userData persistence from a UserData store. | removeAttribute |
Removes the specified attribute from the object. | save |
Saves an object participating in userData persistence to a UserData store. | setAttribute |
Sets the value of the specified attribute. |
Remarks Security Alert For security reasons, a UserData store is available only in the same directory and with the same protocol used to persist the store. Security Alert Using this behavior incorrectly can compromise the security of your application. Data in a UserData store is not encrypted and therefore not secure. Any application that has access to the drive where UserData is saved has access to the data. Therefore, it is recommended that you not persist sensitive data like credit card numbers. For more information, see Security Considerations: DHTML and Default Behaviors. The userData behavior persists information across sessions by writing to a UserData store. This provides a data structure that is more dynamic and has a greater capacity than cookies. The capacity of the UserData store depends on the security zone of the domain. The following table shows the maximum amount of UserData storage that is available for an individual document and also the total available for an entire domain, based on the security zone.
Security Zone | Document Limit (KB) | Domain Limit (KB) |
---|
Local Machine | 128 | 1024 | Intranet | 512 | 10240 | Trusted Sites | 128 | 1024 | Internet | 128 | 1024 | Restricted | 64 | 640 |
The userData behavior persists data across sessions, using one UserData store for each object. The UserData store is persisted in the cache using the save and load methods. once the userdata store has been saved, it can be reloaded even if microsoft® internet explorer has been closed and reopened. setting the userdata behavior class on the html, head, title, or style object causes an error when the save or load method is called. The required style can be set inline or in the document header, as follows:
<STYLE>
.storeuserData {behavior:url(#default#userData);}
</STYLE> An id is optional for userdata, but including one improves performance. the userdata behavior is available as of internet explorer 5, in the microsoft win32® and unix platforms.
Examples
This example uses the userData behavior to preserve information in a UserData Store. <HTML>
<HEAD>
<STYLE>
.storeuserData {behavior:url(#default#userData);}
</STYLE>
<SCRIPT>
function fnSaveInput(){
var oPersist=oPersistForm.oPersistInput;
oPersist.setAttribute("sPersist",oPersist.value);
oPersist.save("oXMLBranch");
}
function fnLoadInput(){
var oPersist=oPersistForm.oPersistInput;
oPersist.load("oXMLBranch");
oPersist.value=oPersist.getAttribute("sPersist");
}
</SCRIPT>
</HEAD>
<BODY>
<FORM ID="oPersistForm">
<INPUT CLASS="storeuserData" TYPE="text" ID="oPersistInput">
<INPUT TYPE="button" VALUE="Load" onclick="fnLoadInput()">
<INPUT TYPE="button" VALUE="Save" onclick="fnSaveInput()">
</FORM>
</BODY>
</HTML> This feature requires Microsoft® Internet Explorer 5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
The following example uses the userData behavior in a custom tag to preserve information in a UserData Store. <HTML XMLNS:sdk>
<HEAD>
<STYLE>
sdk\:cacher {behavior:url(#default#userData);}
</STYLE>
<SCRIPT>
function fnSaveInput(){
cachetag.setAttribute("sPersist",txt1.value);
cachetag.save("cache");
}
function fnLoadInput(){
cachetag.load("cache");
cachetag.value=cachetag.getAttribute("sPersist");
}
</SCRIPT>
</HEAD>
<BODY>
<sdk:cacher id="cachetag"></sdk:cacher>
<INPUT TYPE="button" VALUE="Load" onclick="fnLoadInput()">
<INPUT TYPE="button" VALUE="Save" onclick="fnSaveInput()">
<INPUT TYPE="text" ID="txt1" VALUE="some value">
</BODY>
</HTML>
Applies To |
A,
ACRONYM,
ADDRESS,
AREA,
B,
BIG,
BLOCKQUOTE,
BUTTON,
CAPTION,
CENTER,
CITE,
CODE,
DD,
DEL,
DFN,
DIR,
DIV,
DL,
DT,
EM,
FONT,
FORM,
hn,
HR,
I,
IMG,
INPUT type=button,
INPUT type=checkbox,
INPUT type=file,
INPUT type=hidden,
INPUT type=image,
INPUT type=password,
INPUT type=radio,
INPUT type=reset,
INPUT type=submit,
INPUT type=text,
KBD,
LABEL,
LI,
LISTING,
MAP,
MARQUEE,
MENU,
OBJECT,
OL,
OPTION,
P,
PLAINTEXT,
PRE,
Q,
S,
SAMP,
SELECT,
SMALL,
SPAN,
STRIKE,
STRONG,
SUB,
SUP,
TABLE,
TEXTAREA,
TT,
U,
UL,
VAR,
XMP | |
更多语法参考 introduction to dhtml behaviors, Introduction to Persistence
|