This topic documents a feature of Binary Behaviors, which are obsolete as of Internet Explorer 10.
Enables the object to persist data in user data.
Syntax
XML <Prefix: CustomTag ID=sIDSTYLE=" behavior:url('#default#userData')"/>HTML <ELEMENT STYLE="behavior:url('#default#userData')"ID=sID>Scripting object . style.behavior = "url('#default#userData')"object . addBehavior ("#default#userData")
Possible Values
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.
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 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.
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 See URLACTION_HTML_USERDATA_SAVE for information on how the userData behavior is regulated. See About URL Security Zones Templates for further information on the default URL policy settings for each of the five security zone templates.
The userData behavior persists data across sessions, using one UserData store for each object. The UserData store is persisted in the cache using thesave and load methods. Once the UserData store has been saved, it can be reloaded even if the document 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 Microsoft 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 type="text/css">
.storeuserData {
behavior: url(#default#userData);
}
</style>
<script type="text/javascript">
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>Code example: http://samples.msdn.microsoft.com/workshop/samples/author/persistence/userData_1.htm
The following example uses the userData behavior in a custom tag to preserve information in a UserData Store.
<html xmlns:sdk="">
<head>
<style type="text/css">
sdk:cacher {
behavior: url(#default#userData);
}
</style>
<script type="text/javascript">
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, ABBR, 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
See Also