Files
mono/mcs/class/System.Web/System.Web.UI/ClientScriptManager.cs
T
Igor Zelmanovich 047bfafcfe 2006-11-26 Igor Zelmanovich <[email protected]>
* Page.cs:
	* ClientScriptManager.cs:
	implemented RegisterExpandoAttribute feature	


svn path=/trunk/mcs/; revision=68473
2006-11-26 11:38:54 +00:00

636 lines
20 KiB
C#

//
// System.Web.UI.ClientScriptManager.cs
//
// Authors:
// Duncan Mak ([email protected])
// Gonzalo Paniagua ([email protected])
// Andreas Nahr ([email protected])
// Lluis Sanchez ([email protected])
//
// (C) 2002,2003 Ximian, Inc. (http://www.ximian.com)
// (c) 2003 Novell, Inc. (http://www.novell.com)
//
//
// Permission is hereby granted, free of charge, to any person obtaining
// a copy of this software and associated documentation files (the
// "Software"), to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify, merge, publish,
// distribute, sublicense, and/or sell copies of the Software, and to
// permit persons to whom the Software is furnished to do so, subject to
// the following conditions:
//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
using System;
using System.Collections;
#if NET_2_0
using System.Collections.Generic;
#endif
using System.Text;
using System.Collections.Specialized;
using System.Web.Util;
namespace System.Web.UI
{
#if NET_2_0
public sealed
#else
internal
#endif
class ClientScriptManager
{
Hashtable registeredArrayDeclares;
ScriptEntry clientScriptBlocks;
ScriptEntry startupScriptBlocks;
Hashtable hiddenFields;
ScriptEntry submitStatements;
ScriptEntry scriptIncludes;
Hashtable expandoAttributes;
Page page;
#if NET_2_0
List <int> eventValidationValues;
#endif
internal ClientScriptManager (Page page)
{
this.page = page;
}
#if !NET_2_0
public string GetPostBackClientEvent (Control control, string argument)
{
return GetPostBackEventReference (control, argument);
}
#endif
public string GetPostBackClientHyperlink (Control control, string argument)
{
return "javascript:" + GetPostBackEventReference (control, argument);
}
#if NET_2_0
public string GetPostBackClientHyperlink (Control control, string argument, bool registerForEventValidation)
{
if (registerForEventValidation)
RegisterForEventValidation (control.UniqueID, argument);
return "javascript:" + GetPostBackEventReference (control, argument);
}
#endif
#if !NET_2_0
internal
#else
public
#endif
string GetPostBackEventReference (Control control, string argument)
{
if (control == null)
throw new ArgumentNullException ("control");
page.RequiresPostBackScript ();
return String.Format ("__doPostBack('{0}','{1}')", control.UniqueID, argument);
}
#if NET_2_0
public string GetPostBackEventReference (Control control, string argument, bool registerForEventValidation)
{
if (control == null)
throw new ArgumentNullException ("control");
if (registerForEventValidation)
RegisterForEventValidation (control.UniqueID, argument);
return GetPostBackEventReference (control, argument);
}
public string GetPostBackEventReference (PostBackOptions options, bool registerForEventValidation)
{
if (options == null)
throw new ArgumentNullException ("options");
if (registerForEventValidation)
RegisterForEventValidation (options);
return GetPostBackEventReference (options);
}
public string GetPostBackEventReference (PostBackOptions options)
{
if (options == null)
throw new ArgumentNullException ("options");
if (options.ActionUrl == null && options.ValidationGroup == null && !options.TrackFocus &&
!options.AutoPostBack && !options.PerformValidation)
{
if (!options.ClientSubmit)
return null;
if (options.RequiresJavaScriptProtocol)
return GetPostBackClientHyperlink (options.TargetControl, options.Argument);
else
return GetPostBackEventReference (options.TargetControl, options.Argument);
}
if (!IsClientScriptIncludeRegistered (typeof(Page), "webform")) {
RegisterClientScriptInclude (typeof(Page), "webform", GetWebResourceUrl (typeof(Page), "webform.js"));
}
if (options.ActionUrl != null)
RegisterHiddenField (Page.PreviousPageID, page.Request.FilePath);
if (options.ClientSubmit || options.ActionUrl != null)
page.RequiresPostBackScript ();
return String.Format ("{0}WebForm_DoPostback({1},{2},{3},{4},{5},{6},{7},{8})",
options.RequiresJavaScriptProtocol ? "javascript:" : "",
ClientScriptManager.GetScriptLiteral (options.TargetControl.UniqueID),
ClientScriptManager.GetScriptLiteral (options.Argument),
ClientScriptManager.GetScriptLiteral (options.ActionUrl),
ClientScriptManager.GetScriptLiteral (options.AutoPostBack),
ClientScriptManager.GetScriptLiteral (options.PerformValidation),
ClientScriptManager.GetScriptLiteral (options.TrackFocus),
ClientScriptManager.GetScriptLiteral (options.ClientSubmit),
ClientScriptManager.GetScriptLiteral (options.ValidationGroup)
);
}
public string GetCallbackEventReference (Control control, string argument, string clientCallback, string context)
{
return GetCallbackEventReference (control, argument, clientCallback, context, null, false);
}
public string GetCallbackEventReference (Control control, string argument, string clientCallback, string context, bool useAsync)
{
return GetCallbackEventReference (control, argument, clientCallback, context, null, useAsync);
}
public string GetCallbackEventReference (Control control, string argument, string clientCallback, string context, string clientErrorCallback, bool useAsync)
{
if (control == null)
throw new ArgumentNullException ("control");
if(!(control is ICallbackEventHandler))
throw new InvalidOperationException ("The control must implement the ICallbackEventHandler interface and provide a RaiseCallbackEvent method.");
return GetCallbackEventReference (control.UniqueID, argument, clientCallback, context, clientErrorCallback, useAsync);
}
public string GetCallbackEventReference (string target, string argument, string clientCallback, string context, string clientErrorCallback, bool useAsync)
{
page.RequiresPostBackScript ();
if (!IsClientScriptIncludeRegistered (typeof(Page), "callback"))
RegisterClientScriptInclude (typeof(Page), "callback", GetWebResourceUrl (typeof(Page), "callback.js"));
return string.Format ("WebForm_DoCallback('{0}',{1},{2},{3},{4},{5})", target, argument, clientCallback, context, ((clientErrorCallback == null) ? "null" : clientErrorCallback), (useAsync ? "true" : "false"));
}
#endif
#if NET_2_0
public
#else
internal
#endif
string GetWebResourceUrl(Type type, string resourceName)
{
if (type == null)
throw new ArgumentNullException ("type");
if (resourceName == null || resourceName.Length == 0)
throw new ArgumentNullException ("type");
return System.Web.Handlers.AssemblyResourceLoader.GetResourceUrl (type, resourceName);
}
public bool IsClientScriptBlockRegistered (string key)
{
return IsScriptRegistered (clientScriptBlocks, GetType(), key);
}
public bool IsClientScriptBlockRegistered (Type type, string key)
{
return IsScriptRegistered (clientScriptBlocks, type, key);
}
public bool IsStartupScriptRegistered (string key)
{
return IsScriptRegistered (startupScriptBlocks, GetType(), key);
}
public bool IsStartupScriptRegistered (Type type, string key)
{
return IsScriptRegistered (startupScriptBlocks, type, key);
}
public bool IsOnSubmitStatementRegistered (string key)
{
return IsScriptRegistered (submitStatements, GetType(), key);
}
public bool IsOnSubmitStatementRegistered (Type type, string key)
{
return IsScriptRegistered (submitStatements, type, key);
}
public bool IsClientScriptIncludeRegistered (string key)
{
return IsScriptRegistered (scriptIncludes, GetType(), key);
}
public bool IsClientScriptIncludeRegistered (Type type, string key)
{
return IsScriptRegistered (scriptIncludes, type, key);
}
bool IsScriptRegistered (ScriptEntry scriptList, Type type, string key)
{
while (scriptList != null) {
if (scriptList.Type == type && scriptList.Key == key)
return true;
scriptList = scriptList.Next;
}
return false;
}
public void RegisterArrayDeclaration (string arrayName, string arrayValue)
{
if (registeredArrayDeclares == null)
registeredArrayDeclares = new Hashtable();
if (!registeredArrayDeclares.ContainsKey (arrayName))
registeredArrayDeclares.Add (arrayName, new ArrayList());
((ArrayList) registeredArrayDeclares[arrayName]).Add(arrayValue);
}
void RegisterScript (ref ScriptEntry scriptList, Type type, string key, string script, bool addScriptTags)
{
ScriptEntry last = null;
ScriptEntry entry = scriptList;
while (entry != null) {
if (entry.Type == type && entry.Key == key)
return;
last = entry;
entry = entry.Next;
}
if (addScriptTags)
script = "<script language=javascript>\n<!--\n" + script + "\n// -->\n</script>";
entry = new ScriptEntry (type, key, script);
if (last != null) last.Next = entry;
else scriptList = entry;
}
internal void RegisterClientScriptBlock (string key, string script)
{
RegisterScript (ref clientScriptBlocks, GetType(), key, script, false);
}
public void RegisterClientScriptBlock (Type type, string key, string script)
{
RegisterClientScriptBlock (type, key, script, false);
}
public void RegisterClientScriptBlock (Type type, string key, string script, bool addScriptTags)
{
if (type == null)
throw new ArgumentNullException ("type");
RegisterScript (ref clientScriptBlocks, type, key, script, addScriptTags);
}
public void RegisterHiddenField (string hiddenFieldName, string hiddenFieldInitialValue)
{
if (hiddenFields == null)
hiddenFields = new Hashtable ();
if (!hiddenFields.ContainsKey (hiddenFieldName))
hiddenFields.Add (hiddenFieldName, hiddenFieldInitialValue);
}
internal void RegisterOnSubmitStatement (string key, string script)
{
RegisterScript (ref submitStatements, GetType (), key, script, false);
}
public void RegisterOnSubmitStatement (Type type, string key, string script)
{
if (type == null)
throw new ArgumentNullException ("type");
RegisterScript (ref submitStatements, type, key, script, false);
}
internal void RegisterStartupScript (string key, string script)
{
RegisterScript (ref startupScriptBlocks, GetType(), key, script, false);
}
public void RegisterStartupScript (Type type, string key, string script)
{
RegisterStartupScript (type, key, script, false);
}
public void RegisterStartupScript (Type type, string key, string script, bool addScriptTags)
{
if (type == null)
throw new ArgumentNullException ("type");
RegisterScript (ref startupScriptBlocks, type, key, script, addScriptTags);
}
public void RegisterClientScriptInclude (string key, string url)
{
RegisterClientScriptInclude (GetType (), key, url);
}
public void RegisterClientScriptInclude (Type type, string key, string url)
{
if (type == null)
throw new ArgumentNullException ("type");
if (url == null || url.Length == 0)
throw new ArgumentException ("url");
RegisterScript (ref scriptIncludes, type, key, url, false);
}
#if NET_2_0
public void RegisterClientScriptResource (Type type, string resourceName)
{
RegisterScript (ref scriptIncludes, type, "resource-" + resourceName, GetWebResourceUrl (type, resourceName), false);
}
public void RegisterExpandoAttribute (string controlId, string attributeName, string attributeValue)
{
RegisterExpandoAttribute (controlId, attributeName, attributeValue, true);
}
public void RegisterExpandoAttribute (string controlId, string attributeName, string attributeValue, bool encode)
{
if (controlId == null)
throw new ArgumentNullException ("controlId");
if (attributeName == null)
throw new ArgumentNullException ("attributeName");
if (expandoAttributes == null)
expandoAttributes = new Hashtable ();
ListDictionary list = (ListDictionary)expandoAttributes [controlId];
if (list == null) {
list = new ListDictionary ();
expandoAttributes [controlId] = list;
}
list.Add (attributeName, encode ? StrUtils.EscapeQuotesAndBackslashes (attributeValue) : attributeValue);
}
// Implemented following the description in http://odetocode.com/Blogs/scott/archive/2006/03/20/3145.aspx
private int CalculateEventHash (string uniqueId, string argument)
{
int uniqueIdHash = uniqueId.GetHashCode ();
int argumentHash = String.IsNullOrEmpty (argument) ? 0 : argument.GetHashCode ();
return (uniqueIdHash ^ argumentHash);
}
public void RegisterForEventValidation (PostBackOptions options)
{
// MS.NET does not check for options == null, so we won't too...
RegisterForEventValidation (options.TargetControl.UniqueID, options.Argument);
}
public void RegisterForEventValidation (string uniqueId)
{
RegisterForEventValidation (uniqueId, null);
}
public void RegisterForEventValidation (string uniqueId, string argument)
{
if (!page.EnableEventValidation)
return;
if (uniqueId == null || uniqueId.Length == 0)
return;
if (page.LifeCycle < PageLifeCycle.Render)
throw new InvalidOperationException ("RegisterForEventValidation may only be called from the Render method");
if (eventValidationValues == null)
eventValidationValues = new List <int> ();
int hash = CalculateEventHash (uniqueId, argument);
if (eventValidationValues.BinarySearch (hash) < 0)
eventValidationValues.Add (hash);
}
public void ValidateEvent (string uniqueId)
{
ValidateEvent (uniqueId, null);
}
public void ValidateEvent (string uniqueId, string argument)
{
if (uniqueId == null || uniqueId.Length == 0)
throw new ArgumentException ("must not be null or empty", "uniqueId");
if (!page.EnableEventValidation)
return;
if (eventValidationValues == null)
goto bad;
int hash = CalculateEventHash (uniqueId, argument);
if (eventValidationValues.BinarySearch (hash) < 0)
goto bad;
return;
bad:
throw new ArgumentException ("Invalid postback or callback argument. Event validation is enabled using <pages enableEventValidation=\"true\"/> in configuration or <%@ Page EnableEventValidation=\"true\" %> in a page. For security purposes, this feature verifies that arguments to postback or callback events originate from the server control that originally rendered them. If the data is valid and expected, use the ClientScriptManager.RegisterForEventValidation method in order to register the postback or callback data for validation.");
}
#endif
void WriteScripts (HtmlTextWriter writer, ScriptEntry scriptList)
{
while (scriptList != null) {
writer.WriteLine (scriptList.Script);
scriptList = scriptList.Next;
}
}
#if NET_2_0
internal void RestoreEventValidationState (string fieldValue)
{
if (!page.EnableEventValidation || fieldValue == null || fieldValue.Length == 0)
return;
LosFormatter fmt = page.GetFormatter ();
eventValidationValues = (List <int>)fmt.Deserialize (fieldValue);
}
internal void SaveEventValidationState ()
{
if (!page.EnableEventValidation || eventValidationValues == null || eventValidationValues.Count == 0)
return;
eventValidationValues.Sort ();
LosFormatter fmt = page.GetFormatter ();
RegisterHiddenField (EventStateFieldName, fmt.SerializeToBase64 (eventValidationValues));
}
internal string EventStateFieldName
{
get { return "__EVENTVALIDATION"; }
}
internal void WriteExpandoAttributes (HtmlTextWriter writer)
{
if (expandoAttributes == null)
return;
writer.WriteLine ();
writer.WriteLine ("<script type=\"text/javascript\">");
writer.WriteLine ("<!--");
foreach (string controlId in expandoAttributes.Keys) {
writer.WriteLine ("var {0} = document.all ? document.all [\"{0}\"] : document.getElementById (\"{0}\");", controlId);
ListDictionary attrs = (ListDictionary) expandoAttributes [controlId];
foreach (string attributeName in attrs.Keys) {
writer.WriteLine ("{0}.{1} = \"{2}\";", controlId, attributeName, attrs [attributeName]);
}
}
writer.WriteLine ("// -->");
writer.WriteLine ("</script>");
writer.WriteLine ();
}
#endif
internal void WriteHiddenFields (HtmlTextWriter writer)
{
if (hiddenFields == null)
return;
foreach (string key in hiddenFields.Keys) {
string value = hiddenFields [key] as string;
writer.WriteLine ("\n<input type=\"hidden\" name=\"{0}\" id=\"{0}\" value=\"{1}\" />", key, value);
}
hiddenFields = null;
}
internal void WriteClientScriptIncludes (HtmlTextWriter writer)
{
ScriptEntry entry = scriptIncludes;
while (entry != null) {
writer.WriteLine ("\n<script src=\"{0}\" type=\"text/javascript\"></script>", entry.Script);
entry = entry.Next;
}
}
internal void WriteClientScriptBlocks (HtmlTextWriter writer)
{
WriteScripts (writer, clientScriptBlocks);
}
internal void WriteStartupScriptBlocks (HtmlTextWriter writer)
{
WriteScripts (writer, startupScriptBlocks);
}
internal void WriteArrayDeclares (HtmlTextWriter writer)
{
if (registeredArrayDeclares != null) {
writer.WriteLine();
writer.WriteLine("<script language=\"javascript\">");
writer.WriteLine("<!--");
IDictionaryEnumerator arrayEnum = registeredArrayDeclares.GetEnumerator();
while (arrayEnum.MoveNext()) {
writer.Write("\tvar ");
writer.Write(arrayEnum.Key);
writer.Write(" = new Array(");
IEnumerator arrayListEnum = ((ArrayList) arrayEnum.Value).GetEnumerator();
bool isFirst = true;
while (arrayListEnum.MoveNext()) {
if (isFirst)
isFirst = false;
else
writer.Write(", ");
writer.Write(arrayListEnum.Current);
}
writer.WriteLine(");");
}
writer.WriteLine("// -->");
writer.WriteLine("</script>");
writer.WriteLine();
}
}
#if NET_2_0
internal string GetClientValidationEvent (string validationGroup) {
return "if (typeof(Page_ClientValidate) == 'function') Page_ClientValidate('" + validationGroup + "');";
}
#endif
internal string GetClientValidationEvent ()
{
return "if (typeof(Page_ClientValidate) == 'function') Page_ClientValidate();";
}
internal string WriteSubmitStatements ()
{
if (submitStatements == null) return null;
StringBuilder sb = new StringBuilder ();
ScriptEntry entry = submitStatements;
while (entry != null) {
sb.Append (entry.Script);
entry = entry.Next;
}
return sb.ToString ();
}
internal static string GetScriptLiteral (object ob)
{
if (ob == null)
return "null";
else if (ob is string) {
string s = (string)ob;
s = s.Replace ("\"", "\\\"");
return "\"" + s + "\"";
} else if (ob is bool) {
return ob.ToString().ToLower();
} else {
return ob.ToString ();
}
}
class ScriptEntry
{
public Type Type;
public string Key;
public string Script;
public ScriptEntry Next;
public ScriptEntry (Type type, string key, string script)
{
Key = key;
Type = type;
Script = script;
}
}
#if NET_2_0
// helper method
internal static string EnsureEndsWithSemicolon (string value) {
if (value != null && value.Length > 0 && !value.EndsWith (";"))
return value += ";";
return value;
}
#endif
}
}