ScriptManager (Clase)
Administra las bibliotecas de scripts y los archivos de script AJAX de ASP.NET, la representación parcial de página y la generación de la clase de proxy de cliente para los servicios Web y de aplicación.
Ensamblado: System.Web.Extensions (en System.Web.Extensions.dll)
El tipo ScriptManager expone los siguientes miembros.
| Nombre | Descripción | |
|---|---|---|
|
Adapter | Obtiene el adaptador específico del explorador para el control. (Se hereda de Control). |
|
AjaxFrameworkAssembly | Obtiene el ensamblado de Ajax Framework que usan los componentes de la página. |
|
AjaxFrameworkMode | Obtiene o establece un valor que especifica cómo se incluirán en el cliente los scripts de cliente de la biblioteca de cliente Microsoft Ajax. |
|
AllowCustomErrorsRedirect | Obtiene o establece un valor que determina si se utiliza la sección de errores personalizados (customErrors) del archivo Web.config durante un error en un postback asincrónico. |
|
AppRelativeTemplateSourceDirectory | Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control. (Se hereda de Control). |
|
AsyncPostBackErrorMessage | Obtiene o establece el mensaje de error que se envía al cliente cuando se produce una excepción de servidor no controlada durante un postback asincrónico. |
|
AsyncPostBackSourceElementID | Obtiene el identificador único del control que produjo el postback asincrónico. |
|
AsyncPostBackTimeout | Obtiene o establece un valor que indica el tiempo, en segundos, que transcurrirá antes de que se agote el tiempo de espera de postbacks asincrónicos si no se recibe ninguna respuesta. |
|
AuthenticationService | Obtiene el objeto AuthenticationServiceManager asociado a la instancia de ScriptManager actual. |
|
BindingContainer | Infraestructura. Obtiene el control que contiene el enlace de datos de este control. (Se hereda de Control). |
|
ChildControlsCreated | Obtiene un valor que indica si se han creado controles secundarios del control de servidor. (Se hereda de Control). |
|
ClientID | Obtiene el identificador de control del formato HTML generado por ASP.NET. (Se hereda de Control). |
|
ClientIDMode | Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID. (Se hereda de Control). |
|
ClientIDSeparator | Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Se hereda de Control). |
|
ClientNavigateHandler | Obtiene o establece el nombre del método que controla el evento Sys.Application.navigate en el cliente. |
|
CompositeScript | Obtiene una referencia al script compuesto que admite la página web. |
|
Context | Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Se hereda de Control). |
|
Controls | Obtiene un objeto ControlCollection que representa los controles secundarios para un control de servidor especificado en la jerarquía de la interfaz de usuario. (Se hereda de Control). |
|
DataItemContainer | Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Se hereda de Control). |
|
DataKeysContainer | Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Se hereda de Control). |
|
DesignMode | Obtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Se hereda de Control). |
|
EmptyPageUrl | Obtiene o establece una dirección URL en una página web en blanco. |
|
EnableCdn | Determina si la página actual carga referencias de script de cliente desde rutas de acceso CDN (Content Delivery Network). |
|
EnableHistory | Obtiene o establece un valor que indica si la página web admite la administración de los puntos de historial. |
|
EnablePageMethods | Obtiene o establece un valor que indica si se puede llamar desde script de cliente a los métodos de página estáticos públicos de una página ASP.NET. |
|
EnablePartialRendering | Obtiene o establece un valor que habilita la representación parcial de una página, que, a su vez, permite actualizar regiones de la página individualmente mediante el uso de controles UpdatePanel. |
|
EnableScriptGlobalization | Obtiene o establece un valor que indica si el control ScriptManager representa script que admite que se analice y se aplique formato a la información específica de la referencia cultural. |
|
EnableScriptLocalization | Obtiene o establece un valor que indica si el control ScriptManager representa versiones localizadas de archivos de script. |
|
EnableSecureHistoryState | Obtiene o establece un valor que indica si se debe cifrar la cadena de estado del historial. |
|
EnableTheming | Obtiene o establece un valor que indica si los temas se aplican a este control. (Se hereda de Control). |
|
EnableViewState | Obtiene o establece un valor que indica si el control de servidor debe mantener su estado de vista y el de los controles secundarios que contiene, en el cliente que realiza la solicitud. (Se hereda de Control). |
|
Events | Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Se hereda de Control). |
|
HasChildViewState | Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista. (Se hereda de Control). |
|
ID | Obtiene o establece el identificador de programación asignado al control de servidor. (Se hereda de Control). |
|
IdSeparator | Infraestructura. Obtiene el carácter utilizado para separar los identificadores de control. (Se hereda de Control). |
|
IsChildControlStateCleared | Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Se hereda de Control). |
|
IsDebuggingEnabled | Obtiene un valor que indica si se representarán las versiones de depuración de las bibliotecas de scripts de cliente. |
|
IsInAsyncPostBack | Obtiene un valor que indica si el postback actual se ejecuta en modo de representación parcial. |
|
IsNavigating | Obtiene un valor que indica actualmente se controla un evento Navigate. |
|
IsTrackingViewState | Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Se hereda de Control). |
|
IsViewStateEnabled | Obtiene un valor que indica si el estado de vista está habilitado para este control. (Se hereda de Control). |
|
LoadScriptsBeforeUI | Obtiene o establece un valor que indica si los scripts se cargan antes o después de cargar el marcado de la interfaz de usuario de la página. |
|
LoadViewStateByID | Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice. (Se hereda de Control). |
|
NamingContainer | Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad Control.ID. (Se hereda de Control). |
|
Page | Obtiene una referencia a la instancia Page que contiene el control de servidor. (Se hereda de Control). |
|
Parent | Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Se hereda de Control). |
|
ProfileService | Obtiene el objeto ProfileServiceManager asociado a la instancia de ScriptManager actual. |
|
RenderingCompatibility | Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Se hereda de Control). |
|
RoleService | Obtiene el objeto RoleServiceManager asociado a la instancia de ScriptManager actual. |
|
ScriptMode | Obtiene o establece un valor que especifica si se representan las versiones de depuración o lanzamiento de las bibliotecas de scripts de cliente. |
|
ScriptPath | Obsoleto. Obtiene o establece la ruta de acceso raíz de la ubicación que se utiliza para compilar las rutas de acceso a los archivos de script personalizados y archivos de script Ajax de ASP.NET. |
|
ScriptResourceMapping | Obtiene un objeto ScriptResourceMapping. |
|
Scripts | Obtiene un objeto ScriptReferenceCollection que contiene los objetos ScriptReference, cada uno de los cuales representa un archivo de script representado en el cliente. |
|
Services | Obtiene un objeto ServiceReferenceCollection que contiene un objeto ServiceReference para cada servicio Web que ASP.NET expone en el cliente para la funcionalidad de Ajax. |
|
Site | Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño. (Se hereda de Control). |
|
SkinID | Obtiene o establece la máscara que se va a aplicar al control. (Se hereda de Control). |
|
SupportsPartialRendering | Obtiene un valor que indica si el cliente admite la representación parcial de página. |
|
TemplateControl | Obtiene o establece una referencia a la plantilla que contiene este control. (Se hereda de Control). |
|
TemplateSourceDirectory | Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Se hereda de Control). |
|
UniqueID | Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Se hereda de Control). |
|
ViewState | Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página. (Se hereda de Control). |
|
ViewStateIgnoresCase | Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Se hereda de Control). |
|
ViewStateMode | Obtiene o establece el modo del estado de vista de este control. (Se hereda de Control). |
|
Visible | Invalida la propiedad Visible heredada de la clase Control base para evitar establecer este valor. (Invalida a Control.Visible). |
| Nombre | Descripción | |
|---|---|---|
|
AddedControl | Se le llama una vez que se ha agregado un control secundario a la colección Controls del Control objeto. (Se hereda de Control). |
|
AddHistoryPoint(NameValueCollection, String) | Crea un punto del historial y lo agrega a la pila del historial del explorador, utilizando la recolección de datos de estado y el título de estado que se han especificado. |
|
AddHistoryPoint(String, String) | Crea un punto del historial y lo agrega a la pila del historial del explorador, utilizando la clave de estado y el valor de estado especificados. |
|
AddHistoryPoint(String, String, String) | Crea un punto del historial y lo agrega a la pila del historial del explorador, utilizando la clave de estado, el valor de estado y el título de estado especificados. |
|
AddParsedSubObject | Indica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega dicho elemento al objeto ControlCollection del control de servidor. (Se hereda de Control). |
|
ApplyStyleSheetSkin | Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página. (Se hereda de Control). |
|
BuildProfileTree | Infraestructura. Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página. (Se hereda de Control). |
|
ClearCachedClientID | Infraestructura. Establece en null el valor de ClientID almacenado en caché. (Se hereda de Control). |
|
ClearChildControlState | Elimina la información sobre el estado de control de los controles secundarios del control de servidor. (Se hereda de Control). |
|
ClearChildState | Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor. (Se hereda de Control). |
|
ClearChildViewState | Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Se hereda de Control). |
|
ClearEffectiveClientIDMode | Infraestructura. Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Se hereda de Control). |
|
CreateChildControls | Lo llama el marco de trabajo de las páginas ASP.NET para indicar a los controles de servidor que utilizan la implementación basada en la composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos. (Se hereda de Control). |
|
CreateControlCollection | Crea un nuevo objeto ControlCollection para guardar los controles secundarios (tanto literales como de servidor) del control de servidor. (Se hereda de Control). |
|
DataBind() | Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios. (Se hereda de Control). |
|
DataBind(Boolean) | Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding. (Se hereda de Control). |
|
DataBindChildren | Enlaza un origen de datos a los controles secundarios del control de servidor. (Se hereda de Control). |
|
Dispose | Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Se hereda de Control). |
|
EnsureChildControls | Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Se hereda de Control). |
|
EnsureID | Crea un identificador para controles que no tiene un identificador asignado. (Se hereda de Control). |
|
Equals(Object) | Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object). |
|
Finalize | Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object). |
|
FindControl(String) | Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual. (Se hereda de Control). |
|
FindControl(String, Int32) | Infraestructura. Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar. (Se hereda de Control). |
|
Focus | Establece el foco de entrada en un control. (Se hereda de Control). |
|
GetCurrent | Obtiene la instancia de ScriptManager para un objeto Page dado. |
|
GetDesignModeState | Infraestructura. Obtiene datos en tiempo de diseño para un control. (Se hereda de Control). |
|
GetHashCode | Actúa como función hash para un tipo concreto. (Se hereda de Object). |
|
GetRegisteredArrayDeclarations | Recupera una colección de sólo lectura de las declaraciones de matriz de ECMAScript (JavaScript) que se registraron anteriormente con el objeto Page. |
|
GetRegisteredClientScriptBlocks | Recupera una colección de sólo lectura de los bloques de script de cliente que se registraron anteriormente con el control ScriptManager. |
|
GetRegisteredDisposeScripts | Recupera una colección de sólo lectura de los scripts dispose que se registraron anteriormente con el objeto Page. |
|
GetRegisteredExpandoAttributes | Recupera una colección de sólo lectura de atributos personalizados (Expando) que se registraron anteriormente con el objeto Page. |
|
GetRegisteredHiddenFields | Recupera una colección de sólo lectura de los campos ocultos que se registraron anteriormente con el objeto Page. |
|
GetRegisteredOnSubmitStatements | Recupera una colección de sólo lectura de las instrucciones onsubmit que se registraron anteriormente con el objeto Page. |
|
GetRegisteredStartupScripts | Recupera una colección de sólo lectura de los scripts de inicio que se registraron anteriormente con el objeto Page. |
|
GetRouteUrl(Object) | Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control). |
|
GetRouteUrl(RouteValueDictionary) | Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control). |
|
GetRouteUrl(String, Object) | Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control). |
|
GetRouteUrl(String, RouteValueDictionary) | Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control). |
|
GetStateString | Recupera una cadena que contiene pares clave-valor que representan el estado de la página web. |
|
GetType | Obtiene el objeto Type de la instancia actual. (Se hereda de Object). |
|
GetUniqueIDRelativeTo | Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Se hereda de Control). |
|
HasControls | Determina si el control de servidor contiene controles secundarios. (Se hereda de Control). |
|
HasEvents | Devuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Se hereda de Control). |
|
IsLiteralContent | Infraestructura. Determina si el control de servidor alberga únicamente contenido literal. (Se hereda de Control). |
|
LoadControlState | Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState. (Se hereda de Control). |
|
LoadPostData | Lee los datos de formulario que se exponen en el servidor desde el explorador y determina el origen del postback asincrónico. |
|
LoadViewState | Restaura la información sobre el estado de vista de una solicitud de página anterior guardada por el método SaveViewState. (Se hereda de Control). |
|
MapPathSecure | Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Se hereda de Control). |
|
MemberwiseClone | Crea una copia superficial del objeto Object actual. (Se hereda de Object). |
|
OnAsyncPostBackError | Provoca el evento AsyncPostBackError. |
|
OnBubbleEvent | Determina si el evento del control de servidor debe pasarse a la jerarquía de controles de servidor de la interfaz de usuario de la página. (Se hereda de Control). |
|
OnDataBinding | Provoca el evento DataBinding. (Se hereda de Control). |
|
OnInit | Provoca el evento Init y comprueba que haya tan solo un control ScriptManager en la página. (Invalida a Control.OnInit(EventArgs)). |
|
OnLoad | Provoca el evento Load. (Se hereda de Control). |
|
OnPreRender | Provoca el evento PreRender y registra los archivos y servicios de script para las actualizaciones parciales de página. (Invalida a Control.OnPreRender(EventArgs)). |
|
OnResolveCompositeScriptReference | Genera el evento ResolveCompositeScriptReference. |
|
OnResolveScriptReference | Provoca el evento ResolveScriptReference para cada referencia de script administrada por el control ScriptManager. |
|
OnUnload | Provoca el evento Unload. (Se hereda de Control). |
|
OpenFile | Obtiene un objeto Stream utilizado para leer un archivo. (Se hereda de Control). |
|
RaiseBubbleEvent | Asigna los orígenes del evento y su información al control principal del control. (Se hereda de Control). |
|
RaisePostBackEvent | Procesa un evento de postback que genera el control ScriptManager y carga el estado del historial de la página web. |
|
RaisePostDataChangedEvent | Provoca eventos para el control ScriptManager cuando devuelve datos al servidor. |
|
RegisterArrayDeclaration(Control, String, String) | Registra una declaración de matriz de ECMAScript (JavaScript) con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega la matriz a la página. |
|
RegisterArrayDeclaration(Page, String, String) | Registra una declaración de matriz de ECMAScript (JavaScript) con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega la matriz a la página. |
|
RegisterAsyncPostBackControl | Registra un control como desencadenador de postbacks asincrónicos. |
|
RegisterClientScriptBlock(Control, Type, String, String, Boolean) | Registra un bloque de script de cliente con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega el bloque de script a la página. |
|
RegisterClientScriptBlock(Page, Type, String, String, Boolean) | Registra un bloque de script de cliente con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega el bloque de script a la página. |
|
RegisterClientScriptInclude(Control, Type, String, String) | Registra un archivo script de cliente con el control ScriptManager para el uso con un control que está dentro de un control UpdatePanel y, a continuación, agrega una referencia del archivo de script a la página. |
|
RegisterClientScriptInclude(Page, Type, String, String) | Registra el script de cliente con el control ScriptManager cada vez que se produce un postback asincrónico y, a continuación, agrega una referencia del archivo de script a la página. |
|
RegisterClientScriptResource(Control, Type, String) | Registra el script de cliente que está incrustado en un ensamblado con el control ScriptManager para su uso con un control que participa en la representación parcial de página. |
|
RegisterClientScriptResource(Page, Type, String) | Registra un archivo de script de cliente que se incrusta en un ensamblado con el control ScriptManager cada vez que se produce un postback. |
|
RegisterDataItem(Control, String) | Envía datos personalizados a un control durante la representación parcial de la página. |
|
RegisterDataItem(Control, String, Boolean) | Envía datos personalizados a un control durante la representación parcial de la página e indica si los datos están en formato JavaScript Object Notation (JSON). |
|
RegisterDispose | Registra un script dispose para un control que está dentro de un control UpdatePanel. Se ejecuta el script cuando el control UpdatePanel se actualiza o elimina. |
|
RegisterExpandoAttribute | Registra un par de nombre y valor con el control ScriptManager como atributo personalizado (expando) de un control especificado. |
|
RegisterExtenderControl<TExtenderControl> | Registra un control extensor con la instancia de ScriptManager actual. |
|
RegisterHiddenField(Control, String, String) | Registra un campo oculto con el control ScriptManager para un control que está dentro de un control UpdatePanel. |
|
RegisterHiddenField(Page, String, String) | Registra un campo oculto con el control ScriptManager durante cada postback asincrónico. |
|
RegisterOnSubmitStatement(Control, Type, String, String) | Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se utiliza con un control UpdatePanel que se ejecuta cuando se envía el formulario. |
|
RegisterOnSubmitStatement(Page, Type, String, String) | Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se utiliza con un control UpdatePanel que se ejecuta cuando se envía el formulario. |
|
RegisterPostBackControl | Registra un control como desencadenador de un postback. Este método se utiliza para configurar controles de postback que se encuentran dentro de un control UpdatePanel y que, de otro modo, realizarían postbacks asincrónicos. |
|
RegisterScriptControl<TScriptControl> | Registra un control de script con la instancia de ScriptManager actual. |
|
RegisterScriptDescriptors(IExtenderControl) | Vuelve a llamar a una clase ExtenderControl para que se devuelvan los scripts de instancia que se deben representar para admitir el objeto de cliente que representa un componente, comportamiento o control de cliente. |
|
RegisterScriptDescriptors(IScriptControl) | Llamar a una clase ScriptControl para que se devuelvan los scripts de instancia que se deben representar para admitir el objeto de cliente que representa un componente, comportamiento o control de cliente. |
|
RegisterStartupScript(Control, Type, String, String, Boolean) | Registra un bloque de script de inicio para un control que está dentro de UpdatePanel con el control ScriptManager y agrega el bloque de script a la página. |
|
RegisterStartupScript(Page, Type, String, String, Boolean) | Registra un bloque de script de inicio para cada postback asincrónico con el control ScriptManager y agrega el bloque de script a la página. |
|
RemovedControl | Se le llama una vez que se ha quitado un control secundario de la colección Controls del Control objeto. (Se hereda de Control). |
|
Render | Representa el contenido del control ScriptManager en el explorador con el objeto HtmlTextWriter especificado. (Invalida a Control.Render(HtmlTextWriter)). |
|
RenderChildren | Envía el contenido del control secundario del control de servidor a un objeto HtmlTextWriter suministrado, que escribe el contenido que se va a representar en el cliente. (Se hereda de Control). |
|
RenderControl(HtmlTextWriter) | Envía el contenido del control de servidor a un objeto HtmlTextWriter que se proporciona y almacena la información de traza sobre el control si dicha traza está habilitada. (Se hereda de Control). |
|
RenderControl(HtmlTextWriter, ControlAdapter) | Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado. (Se hereda de Control). |
|
ResolveAdapter | Obtiene el adaptador de controles que se encarga de representar el control especificado. (Se hereda de Control). |
|
ResolveClientUrl | Obtiene una dirección URL que el explorador puede utilizar. (Se hereda de Control). |
|
ResolveUrl | Convierte una dirección URL en una que el cliente solicitante pueda utilizar. (Se hereda de Control). |
|
SaveControlState | Guarda los cambios de estado de un control de servidor que se hayan producido desde el momento en que se devolvieron al servidor los datos de la página. (Se hereda de Control). |
|
SaveViewState | Guarda los cambios realizados en el estado de vista del control de servidor desde la devolución de la página al servidor. (Se hereda de Control). |
|
SetDesignModeState | Establece datos en tiempo de diseño para un control. (Se hereda de Control). |
|
SetFocus(Control) | Establece el foco del explorador en el control especificado. |
|
SetFocus(String) | Establece el foco del explorador en el control especificado mediante identificador. |
|
SetRenderMethodDelegate | Infraestructura. Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal. (Se hereda de Control). |
|
ToString | Devuelve una cadena que representa el objeto actual. (Se hereda de Object). |
|
TrackViewState | Origina el seguimiento de los cambios del estado de vista del control de servidor de manera que se puedan almacenar en el objeto StateBag del control de servidor. Se obtiene acceso a este objeto a través de la propiedad Control.ViewState. (Se hereda de Control). |
| Nombre | Descripción | |
|---|---|---|
|
AsyncPostBackError | Se produce cuando hay un error de página durante un postback asincrónico. |
|
DataBinding | Se produce cuando el control de servidor se enlaza a un origen de datos. (Se hereda de Control). |
|
Disposed | Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET. (Se hereda de Control). |
|
Init | Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Se hereda de Control). |
|
Load | Se produce cuando el control de servidor se carga en el objeto Page. (Se hereda de Control). |
|
Navigate | Se provoca cuando el usuario hace clic en el botón Atrás o Adelante del explorador. |
|
PreRender | Se produce una vez que se carga el objeto Control, pero antes de su representación. (Se hereda de Control). |
|
ResolveCompositeScriptReference | Se provoca cuando un script compuesto se registra con el control ScriptManager. |
|
ResolveScriptReference | Se produce cuando un miembro de la colección Scripts se registra con el control ScriptManager. |
|
Unload | Se produce cuando el control de servidor se descarga de la memoria. (Se hereda de Control). |
| Nombre | Descripción | |
|---|---|---|
|
FindDataSourceControl | Devuelve el origen de datos que está asociado al control de datos del control especificado. (Definido por DynamicDataExtensions). |
|
FindFieldTemplate | Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado. (Definido por DynamicDataExtensions). |
|
FindMetaTable | Devuelve el objeto de metatabla para el control de datos contenedor. (Definido por DynamicDataExtensions). |
En este tema:
Introduction
El control ScriptManager es fundamental para la funcionalidad de AJAX en ASP.NET. El control administra todos los recursos AJAX de ASP.NET en una página. Esto incluye la descarga de scripts de Microsoft Ajax Library en el explorador y la coordinación de las actualizaciones parciales de página que se habilitan mediante el uso de controles UpdatePanel. Además, el control ScriptManager permite hacer lo siguiente:
-
Registrar scripts compatibles con las actualizaciones parciales de página. Para administrar las dependencias entre su script y la biblioteca principal, cualquier script que registre se cargará después del script de Microsoft Ajax Library.
-
Especificar si se envían al explorador scripts de lanzamiento o de depuración.
-
Proporcionar acceso a métodos de servicio Web desde el script mediante el registro de los servicios Web con el control ScriptManager.
-
Proporcionar acceso a los servicios de autenticación, funciones y perfiles de ASP.NET desde el script de cliente mediante el registro de estos servicios con el control ScriptManager.
-
Habilitar la presentación específica de la referencia cultural en el explorador de las funciones ECMAScript (JavaScript) Date, Number y String.
-
Tener acceso a recursos de localización para los archivos de script incrustados o para los archivos de script independientes por medio de la propiedad ResourceUICultures del control ScriptReference.
-
Registrar controles de servidor que implementen la interfaz IExtenderControl o IScriptControl con el control ScriptManager para que se represente el script que requieren los comportamientos y componentes del cliente.
Representación parcial de página
Los factores siguientes controlan si una página ASP.NET tiene capacidad de admitir la representación parcial de página:
-
La propiedad EnablePartialRendering del control ScriptManager debe ser true (valor predeterminado).
-
Debe haber por lo menos un control UpdatePanel en la página.
-
La propiedad SupportsPartialRendering debe ser true (valor predeterminado). Si no se establece la propiedad SupportsPartialRendering explícitamente, su valor se basa en la funcionalidad del explorador.
Puede invalidar el valor de la propiedad EnablePartialRendering en tiempo de ejecución durante el evento Init de la página o antes del mismo. Si intenta cambiar esta propiedad después de que se ha producido el evento Init de la página, se iniciará una excepción InvalidOperationException.
Cuando se admite la representación parcial de página, el control ScriptManager representa el script para habilitar las devoluciones de datos asincrónicas y las actualizaciones parciales de página. Las regiones de la página que se van a actualizar se designan mediante los controles UpdatePanel. El control ScriptManager administra las devoluciones de datos asincrónicas y actualiza sólo las regiones de la página que tienen que actualizarse. Para obtener más información acerca de la representación parcial de la página, vea Información general sobre la representación parcial de páginas. Para obtener más información sobre las condiciones que provocan una actualización, vea Información general sobre el control UpdatePanel.
Utilizar el control ScriptManager con páginas maestras, controles de usuario y otros componentes secundarios
Una página sólo puede contener un control ScriptManager en su jerarquía. Para registrar servicios y scripts para páginas anidadas, controles de usuario o componentes cuando la página primaria ya tiene un control ScriptManager, utilice el control ScriptManagerProxy. Para obtener más información, vea Usar el control UpdatePanel de ASP.NET con páginas maestras.
Administración y registro de scripts
El control ScriptManager permite registrar script que después se representa como parte de la página. Los métodos de registro del control ScriptManager se pueden clasificar en las tres categorías siguientes:
-
Métodos de registro que garantizan que se mantienen las dependencias de script en Microsoft Ajax Library.
-
Métodos de registro que no dependen de Microsoft Ajax Library pero son compatibles con controles UpdatePanel.
-
Métodos de registro que permiten trabajar con controles UpdatePanel.
Para obtener más información sobre cómo crear y usar script Ajax en ASP.NET, vea Crear un script de cliente personalizado mediante Microsoft Ajax Library.
Registrar script que depende de Microsoft AJAX Library
Puede usar los métodos siguientes para registrar archivos de script de forma que se garantice que se mantiene cualquier dependencia de Microsoft Ajax Library.
|
Método |
Definición |
|---|---|
|
Registra un control de servidor que implementa la interfaz IScriptControl que se utiliza para definir un objeto de cliente Sys.Component. El control ScriptManager representa script que admite el objeto de cliente. |
|
|
Registra un control de servidor que implementa la interfaz IExtenderControl que se utiliza para definir un objeto de cliente Sys.UI.Behavior. El control ScriptManager representa script que admite el objeto de cliente. |
Registrar scripts compatibles con las actualizaciones parciales de página
Puede utilizar los métodos siguientes para registrar archivos de script que no dependen de Microsoft Ajax Library pero son compatibles con controles UpdatePanel. Estos métodos se corresponden con métodos similares del control ClientScriptManager. Si va a representar un script para usarlo dentro de un control UpdatePanel, asegúrese de que llama a los métodos del control ScriptManager.
|
Método |
Definición |
|---|---|
|
Agrega un valor a una matriz JavaScript. Si la matriz no existe, se creará. |
|
|
Representa un elemento script después de la etiqueta de apertura <form> de la página. El script se especifica como un parámetro de cadena. |
|
|
Representa un elemento script después de la etiqueta de apertura <form> de la página. El contenido del script se especifica estableciendo el atributo src en una dirección URL que señala a un archivo de script. |
|
|
Representa un elemento script después de la etiqueta de apertura <form> de la página. El contenido del script se especifica con un nombre de recurso en un ensamblado. El atributo src se rellena automáticamente con una dirección URL mediante una llamada a un controlador HTTP que recupera el script con nombre del ensamblado. |
|
|
Representa un par de nombre y valor como atributo personalizado (expando) en el marcado para un control especificado. |
|
|
Representa un campo oculto. |
|
|
Registra un script que se ejecuta en respuesta al evento submit del elemento form. El atributo onSubmit hace referencia al script especificado. |
|
|
Representa un bloque de script de inicio justo delante de la etiqueta de cierre </form> de la página. El script que se va a representar se especifica como parámetro de cadena. |
Al registrar los métodos, se especifica un par de tipo y clave para ese script. Si ya se ha registrado un script con el mismo par de tipo y clave, no se registra un nuevo script. De igual forma, si se registra un script con un par de tipo y nombre de recurso que ya existe, no se vuelve a agregar el elemento script que hace referencia al recurso. Al registrar un atributo expando de un atributo previamente registrado, se inicia una excepción. Se permite el registro duplicado de valores de matriz.
Al llamar al método RegisterClientScriptInclude o RegisterClientScriptResource, evite registrar script que ejecute funciones inline. En su lugar, registre script que contenga definiciones de función como controladores de eventos o definiciones de clase personalizadas para su aplicación.
Métodos de registro para los controles UpdatePanel
Puede utilizar los métodos siguientes para personalizar las actualizaciones parciales de página al utilizar controles UpdatePanel.
|
Método |
Definición |
|---|---|
|
Registra un control como desencadenador de postbacks asincrónicos. |
|
|
Envía datos personalizados a los controles durante la representación parcial de la página. |
|
|
Registra un script de eliminación para un control que está dentro de un control UpdatePanel. Se ejecuta el script cuando el control UpdatePanel se actualiza o elimina. El método de eliminación se utiliza para los componentes de cliente que forman parte de Microsoft Ajax Library y que tienen que liberar recursos cuando ya no se utiliza un componente. |
|
|
Registra un control como desencadenador de una devolución de datos completa. Este método se utiliza para los controles que están dentro de un control UpdatePanel que, de lo contrario, realizarían devoluciones de datos asincrónicas. |
Referencias a servicios Web
Puede registrar un servicio Web que se va a llamar desde script de cliente creando un objeto ServiceReference y agregándolo a la colección Services del control ScriptManager. ASP.NET genera un objeto proxy de cliente para cada objeto ServiceReference de la colección Services. Puede agregar mediante programación objetos ServiceReference a la colección Services para registrar servicios Web en tiempo de ejecución.
Para obtener más información sobre cómo tener acceso a los servicios Web en script, vea Exposing Web Services to Client Script y Calling Web Services from Client Script.
Localización
El control ScriptManager genera referencias en la página representada que señalan a los archivos de script localizados correspondientes, que son archivos de script incrustados en ensamblados o archivos de script independientes.
Cuando la propiedad EnableScriptLocalization se establece en true, el control ScriptManager recupera los recursos localizados (por ejemplo, cadenas localizadas) para la referencia cultural actual, si existen. El control ScriptManager proporciona la funcionalidad siguiente para utilizar recursos localizados:
-
Archivos de script incrustados en un ensamblado. El control ScriptManager determina qué archivo de script específico de la referencia cultural o de referencia cultural de reserva se enviará al explorador. Para ello, utiliza el atributo de ensamblado NeutralResourcesLanguageAttribute específico de la referencia cultural, los recursos empaquetados con el ensamblado y la referencia cultural de la interfaz de usuario del explorador (si lo hubiera).
-
Archivos de script independientes. El control ScriptManager define la lista de referencias culturales de interfaz de usuario que se admiten mediante la propiedad ResourceUICultures del objeto ScriptReference.
-
En modo de depuración. El control ScriptManager intenta representar un archivo de script específico de la referencia cultural que contiene información de depuración. Por ejemplo, si la página está en modo de depuración y la referencia cultural actual está definida como en-MX, el control representa un archivo de script que tendría un nombre parecido a scriptname.en-MX .debug .js, si el archivo existe. Si el archivo no existe, se representa el archivo de depuración de la referencia cultural de reserva correspondiente.
Para obtener más información sobre cómo localizar recursos, vea Información general sobre la localización de recursos para bibliotecas de componentes.
Control de errores
Cuando se produce un error de página durante las devoluciones de datos asincrónicas, se provoca el evento AsyncPostBackError. La forma en la que los errores del servidor se envían al cliente depende de la propiedad AllowCustomErrorsRedirect, la propiedad AsyncPostBackErrorMessage y la sección de errores personalizados (customErrors) del archivo Web.config. Para obtener más información, vea Personalizar el control de errores para los controles UpdatePanel de ASP.NET.
Sintaxis de la declaración
<asp:ScriptManager AllowCustomErrorsRedirect="True|False" AsyncPostBackErrorMessage="string" AsyncPostBackTimeout="integer" AuthenticationService-Path="uri" EnablePageMethods="True|False" EnablePartialRendering="True|False" EnableScriptGlobalization="True|False" EnableScriptLocalization="True|False" EnableTheming="True|False" EnableViewState="True|False" ID="string" LoadScriptsBeforeUI="True|False" OnAsyncPostBackError="AsyncPostBackError event handler" OnDataBinding="DataBinding event handler" OnDisposed="Disposed event handler" OnInit="Init event handler" OnLoad="Load event handler" OnPreRender="PreRender event handler" OnResolveScriptReference="ResolveScriptReference event handler" OnUnload="Unload event handler" ProfileService-LoadProperties="string" ProfileService-Path="uri" RoleService-LoadRoles="True|False" RoleService-Path="uri" runat="server" ScriptMode="Auto|Inherit|Debug|Release" ScriptPath="string" SkinID="string" SupportsPartialRendering="True|False" Visible="True|False" > <AuthenticationService Path="uri" /> <ProfileService LoadProperties="string" Path="uri" /> <RoleService LoadRoles="True|False" Path="uri" /> <Scripts> <asp:ScriptReference Assembly="string" IgnoreScriptPath="True|False" Name="string" NotifyScriptLoaded="True|False" Path="string" ResourceUICultures="string" ScriptMode="Auto|Debug|Inherit|Release" /> </Scripts> <Services> <asp:ServiceReference InlineScript="True|False" Path="string" /> </Services> </asp:ScriptManager>
En los ejemplos siguientes se muestran distintos escenarios de uso del control ScriptManager.
Habilitar actualizaciones parciales de la página
En el ejemplo siguiente se muestra cómo utilizar el control ScriptManager para habilitar las actualizaciones parciales de página. En este ejemplo, los controles Calendar y DropDownList están dentro de un control UpdatePanel. De manera predeterminada, el valor de la propiedad UpdateMode es Always y el valor de la propiedad ChildrenAsTriggers es true. Por consiguiente, los controles secundarios del panel provocan una devolución de datos asincrónica.
<%@ Page Language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> void DropDownSelection_Change(Object sender, EventArgs e) { Calendar1.DayStyle.BackColor = System.Drawing.Color.FromName(ColorList.SelectedItem.Value); } protected void Calendar1_SelectionChanged(object sender, EventArgs e) { SelectedDate.Text = Calendar1.SelectedDate.ToString(); } </script> <html xmlns="http://www.w3.org/1999/xhtml"> <head id="Head1" runat="server"> <title>UpdatePanel Example</title> </head> <body> <form id="form1" runat="server"> <div> <asp:ScriptManager ID="ScriptManager1" runat="server" /> <asp:UpdatePanel ID="UpdatePanel1" runat="server"> <ContentTemplate> <asp:Calendar ID="Calendar1" ShowTitle="True" OnSelectionChanged="Calendar1_SelectionChanged" runat="server" /> <div> Background: <br /> <asp:DropDownList ID="ColorList" AutoPostBack="True" OnSelectedIndexChanged="DropDownSelection_Change" runat="server"> <asp:ListItem Selected="True" Value="White"> White </asp:ListItem> <asp:ListItem Value="Silver"> Silver </asp:ListItem> <asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem> <asp:ListItem Value="Khaki"> Khaki </asp:ListItem> <asp:ListItem Value="DarkKhaki"> D ark Khaki </asp:ListItem> </asp:DropDownList> </div> <br /> Selected date: <asp:Label ID="SelectedDate" runat="server">None.</asp:Label> </ContentTemplate> </asp:UpdatePanel> <br /> </div> </form> </body> </html>
Controlar los errores de actualización parcial de página y registrar el script
En el ejemplo siguiente se muestra cómo proporcionar el control de errores personalizado durante las actualizaciones parciales de página. De forma predeterminada, cuando se produce un error durante las actualizaciones parciales de página, se muestra un cuadro de mensaje de JavaScript. Este ejemplo muestra cómo utilizar el control de errores personalizado proporcionando un controlador para el evento AsyncPostBackError y estableciendo la propiedad AsyncPostBackErrorMessage en el controlador de eventos. También se puede establecer la propiedad AllowCustomErrorsRedirect para especificar cómo se utiliza la sección de errores personalizados (customErrors) del archivo Web.config cuando se produce un error durante las actualizaciones parciales de página. En este ejemplo, se usa el valor predeterminado de la propiedad AllowCustomErrorsRedirect. Esto significa que si el archivo Web.config contiene un elemento customErrors, ese elemento determina cómo se muestran los errores. Para obtener más información, vea Elemento customErrors (Esquema de configuración de ASP.NET).
<%@ Page Language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> protected void Button1_Click(object sender, EventArgs e) { try { int a = Int32.Parse(TextBox1.Text); int b = Int32.Parse(TextBox2.Text); int res = a / b; Label1.Text = res.ToString(); } catch (Exception ex) { if (TextBox1.Text.Length > 0 && TextBox2.Text.Length > 0) { ex.Data["ExtraInfo"] = " You can't divide " + TextBox1.Text + " by " + TextBox2.Text + "."; } throw ex; } } protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e) { if (e.Exception.Data["ExtraInfo"] != null) { ScriptManager1.AsyncPostBackErrorMessage = e.Exception.Message + e.Exception.Data["ExtraInfo"].ToString(); } else { ScriptManager1.AsyncPostBackErrorMessage = "An unspecified error occurred."; } } </script> <html xmlns="http://www.w3.org/1999/xhtml"> <head id="Head1" runat="server"> <title>UpdatePanel Error Handling Example</title> <style type="text/css"> #UpdatePanel1 { width: 200px; height: 50px; border: solid 1px gray; } #AlertDiv{ left: 40%; top: 40%; position: absolute; width: 200px; padding: 12px; border: #000000 1px solid; background-color: white; text-align: left; visibility: hidden; z-index: 99; } #AlertButtons{ position: absolute; right: 5%; bottom: 5%; } </style> </head> <body id="bodytag"> <form id="form1" runat="server"> <div> <asp:ScriptManager ID="ScriptManager1" OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" > <Scripts> <asp:ScriptReference Path="ErrorHandling.js" /> </Scripts> </asp:ScriptManager> <asp:UpdatePanel ID="UpdatePanel1" runat="server"> <ContentTemplate> <asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox> / <asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox> = <asp:Label ID="Label1" runat="server"></asp:Label><br /> <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" /> </ContentTemplate> </asp:UpdatePanel> <div id="AlertDiv"> <div id="AlertMessage"> </div> <br /> <div id="AlertButtons"> <input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" /> </div> </div> </div> </form> </body> </html>
Globalizar la fecha y hora que se muestran en el explorador
El ejemplo siguiente muestra cómo establecer la propiedad EnableScriptGlobalization para que el script de cliente pueda mostrar una fecha y hora específica de la referencia cultural en el explorador. En el ejemplo se establece el atributo Culture de la directiva @ Page en auto. Como resultado, el primer idioma que se especifica en la configuración actual del explorador determina la referencia cultural y la referencia cultural de la interfaz de usuario para la página. Para obtener más información, vea Cómo: Establecer la referencia cultural y la referencia cultural de la interfaz de usuario para la globalización de páginas web ASP.NET.
<%@ Page Language="C#" Culture="auto" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head id="Head1" runat="server"> <title>Globalization Example</title> </head> <body> <form id="form1" runat="server"> <asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server"> </asp:ScriptManager> <script type="text/javascript"> function pageLoad() { Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate); } function formatDate() { var d = new Date(); try { $get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss"); } catch(e) { alert("Error:" + e.message); } } </script> <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional"> <ContentTemplate> <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel"> <asp:Button ID="Button1" runat="server" Text="Display Date" /> <br /> <asp:Label ID="Label1" runat="server"></asp:Label> </asp:Panel> </ContentTemplate> </asp:UpdatePanel> </form> </body> </html>
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.