Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase ScriptManager

 

Publicado: marzo de 2016

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.

Espacio de nombres:   System.Web.UI
Ensamblado:  System.Web.Extensions (en System.Web.Extensions.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.ScriptManager

public class ScriptManager : Control, IPostBackDataHandler, IPostBackEventHandler

NombreDescripción
System_CAPS_pubmethodScriptManager()

Inicializa una nueva instancia de la clase ScriptManager.

NombreDescripción
System_CAPS_protpropertyAdapter

Obtiene el adaptador específico del explorador para el control.(Heredado de Control).

System_CAPS_pubpropertyAjaxFrameworkAssembly

Obtiene el ensamblado de marco de Ajax que usan los componentes de la página.

System_CAPS_pubpropertyAjaxFrameworkMode

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.

System_CAPS_pubpropertyAllowCustomErrorsRedirect

Obtiene o establece un valor que determina si se usa la sección de errores personalizados del archivo Web.config durante un error en un postback asincrónico.

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativa a la aplicación de la Page o UserControl objeto que contiene este control.(Heredado de Control).

System_CAPS_pubpropertyAsyncPostBackErrorMessage

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.

System_CAPS_pubpropertyAsyncPostBackSourceElementID

Obtiene el identificador único del control que produjo el postback asincrónico.

System_CAPS_pubpropertyAsyncPostBackTimeout

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.

System_CAPS_pubpropertyAuthenticationService

Obtiene el objeto AuthenticationServiceManager asociado a la instancia de ScriptManager actual.

System_CAPS_pubpropertyBindingContainer

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el control que contiene el enlace de datos del control.(Heredado de Control).

System_CAPS_protpropertyChildControlsCreated

Obtiene un valor que indica si se crearon los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_pubpropertyClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.(Heredado de Control).

System_CAPS_pubpropertyClientIDMode

Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad.(Heredado de Control).

System_CAPS_protpropertyClientIDSeparator

Obtiene un valor de carácter que representa el carácter separador utilizado en el ClientID propiedad.(Heredado de Control).

System_CAPS_pubpropertyClientNavigateHandler

Obtiene o establece el nombre del método que controla el evento Sys.Application.navigate en el cliente.

System_CAPS_pubpropertyCompositeScript

Obtiene una referencia al script compuesto que admite la página web.

System_CAPS_protpropertyContext

Obtiene el HttpContext objeto asociado con el control de servidor para la solicitud Web actual.(Heredado de Control).

System_CAPS_pubpropertyControls

Obtiene un ControlCollection objeto que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.(Heredado de Control).

System_CAPS_pubpropertyDataItemContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataItemContainer.(Heredado de Control).

System_CAPS_pubpropertyDataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataKeysControl.(Heredado de Control).

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.(Heredado de Control).

System_CAPS_pubpropertyEmptyPageUrl

Obtiene o establece una dirección URL en una página web en blanco.

System_CAPS_pubpropertyEnableCdn

Determina si la página actual carga referencias de script de cliente desde rutas de acceso CDN (Content Delivery Network).

System_CAPS_pubpropertyEnableCdnFallback

Habilita la copia local de un script para cargar en caso de que la CDN (Content Delivery Network) no esté disponible.

System_CAPS_pubpropertyEnableHistory

Obtiene o establece un valor que indica si la página web admite la administración de los puntos de historial.

System_CAPS_pubpropertyEnablePageMethods

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.

System_CAPS_pubpropertyEnablePartialRendering

Obtiene o establece un valor que habilita la representación parcial de una página, lo que, a su vez, permite actualizar regiones de la página individualmente mediante el uso de controles UpdatePanel.

System_CAPS_pubpropertyEnableScriptGlobalization

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.

System_CAPS_pubpropertyEnableScriptLocalization

Obtiene o establece un valor que indica si el control ScriptManager representa versiones localizadas de archivos de script.

System_CAPS_pubpropertyEnableSecureHistoryState

Obtiene o establece un valor que indica si se debe cifrar la cadena de estado del historial.

System_CAPS_pubpropertyEnableTheming

Obtiene o establece un valor que indica si se aplican temas a este control.(Heredado de Control).

System_CAPS_pubpropertyEnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.(Heredado de Control).

System_CAPS_protpropertyEvents

Obtiene una lista de delegados de controladores de eventos para el control. Esta propiedad es de sólo lectura.(Heredado de Control).

System_CAPS_protpropertyHasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardado.(Heredado de Control).

System_CAPS_pubpropertyID

Obtiene o establece el identificador de programación asignado al control de servidor.(Heredado de Control).

System_CAPS_protpropertyIdSeparator

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el carácter utilizado para separar los identificadores de control.(Heredado de Control).

System_CAPS_protpropertyIsChildControlStateCleared

Obtiene un valor que indica si los controles incluidos en este control tienen estado de control.(Heredado de Control).

System_CAPS_pubpropertyIsDebuggingEnabled

Obtiene un valor que indica si se representarán las versiones de depuración de las bibliotecas de scripts de cliente.

System_CAPS_pubpropertyIsInAsyncPostBack

Obtiene un valor que indica si el postback actual se ejecuta en modo de representación parcial.

System_CAPS_pubpropertyIsNavigating

Obtiene un valor que indica si actualmente se controla un evento Navigate.

System_CAPS_protpropertyIsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios en su estado de vista.(Heredado de Control).

System_CAPS_protpropertyIsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.(Heredado de Control).

System_CAPS_pubpropertyLoadScriptsBeforeUI

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.

System_CAPS_protpropertyLoadViewStateByID

Obtiene un valor que indica si el control participa en la carga su estado de vista por ID en lugar de índice.(Heredado de Control).

System_CAPS_pubpropertyNamingContainer

Obtiene una referencia al control de servidor de nombres del contenedor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor con el mismo Control.ID valor de propiedad.(Heredado de Control).

System_CAPS_pubpropertyPage

Obtiene una referencia a la Page instancia que contiene el control de servidor.(Heredado de Control).

System_CAPS_pubpropertyParent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.(Heredado de Control).

System_CAPS_pubpropertyProfileService

Obtiene el objeto ProfileServiceManager asociado a la instancia de ScriptManager actual.

System_CAPS_pubpropertyRenderingCompatibility

Obtiene un valor que especifica será compatible con la versión de ASP.NET que se representa en HTML.(Heredado de Control).

System_CAPS_pubpropertyRoleService

Obtiene el objeto RoleServiceManager asociado a la instancia de ScriptManager actual.

System_CAPS_pubpropertyScriptMode

Obtiene o establece un valor que especifica si se representan las versiones de depuración o lanzamiento de las bibliotecas de scripts de cliente.

System_CAPS_pubpropertyScriptPath

Obsoleto. Obtiene o establece la ruta de acceso raíz de la ubicación que se usa para compilar las rutas de acceso a los archivos de script personalizados y archivos de script Ajax de ASP.NET.

System_CAPS_pubpropertySystem_CAPS_staticScriptResourceMapping

Obtiene un objeto ScriptResourceMapping.

System_CAPS_pubpropertyScripts

Obtiene un objeto ScriptReferenceCollection que contiene los objetos ScriptReference, cada uno de los cuales representa un archivo de script representado en el cliente.

System_CAPS_pubpropertyServices

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.

System_CAPS_pubpropertySite

Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño.(Heredado de Control).

System_CAPS_pubpropertySkinID

Obtiene o establece la máscara que se aplica al control.(Heredado de Control).

System_CAPS_pubpropertySupportsPartialRendering

Obtiene un valor que indica si el cliente admite la representación parcial de página.

System_CAPS_pubpropertyTemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.(Heredado de Control).

System_CAPS_pubpropertyTemplateSourceDirectory

Obtiene el directorio virtual de la Page o UserControl que contiene el control de servidor actual.(Heredado de Control).

System_CAPS_pubpropertyUniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.(Heredado de Control).

System_CAPS_pubpropertyValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el Explorador de valores potencialmente peligrosos.(Heredado de Control).

System_CAPS_protpropertyViewState

Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor a través de varias solicitudes de la misma página.(Heredado de Control).

System_CAPS_protpropertyViewStateIgnoresCase

Obtiene un valor que indica si la StateBag objeto distingue mayúsculas de minúsculas.(Heredado de Control).

System_CAPS_pubpropertyViewStateMode

Obtiene o establece el modo de estado de vista de este control.(Heredado de Control).

System_CAPS_pubpropertyVisible

Invalida la propiedad Visible heredada de la clase Control base para evitar establecer este valor.(Invalida Control.Visible).

NombreDescripción
System_CAPS_protmethodAddedControl(Control, Int32)

Se llama después de que se agrega un control secundario a la Controls colección de la Control objeto.(Heredado de Control).

System_CAPS_pubmethodAddHistoryPoint(NameValueCollection, String)

Crea un punto del historial y lo agrega a la pila del historial del explorador mediante la recolección de datos de estado y el título de estado que se especificaron.

System_CAPS_pubmethodAddHistoryPoint(String, String)

Crea un punto del historial y lo agrega a la pila del historial del explorador mediante la clave de estado y el valor de estado especificados.

System_CAPS_pubmethodAddHistoryPoint(String, String, String)

Crea un punto del historial y lo agrega a la pila del historial del explorador mediante la clave de estado, el valor de estado y el título de estado especificados.

System_CAPS_protmethodAddParsedSubObject(Object)

Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor.(Heredado de Control).

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Se aplica a las propiedades de estilo definidas en la hoja de estilo de página para el control.(Heredado de Control).

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Comienza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control).

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Recopila información sobre el control de servidor y la pasa a la Trace propiedad que se mostrará cuando el seguimiento está habilitado para la página.(Heredado de Control).

System_CAPS_protmethodClearCachedClientID()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Establece la caché ClientID valor a null.(Heredado de Control).

System_CAPS_protmethodClearChildControlState()

Elimina la información de estado de control para los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_protmethodClearChildState()

Elimina la información de estado de vista y el estado de control para los controles secundarios todos del control de servidor.(Heredado de Control).

System_CAPS_protmethodClearChildViewState()

Elimina la información de estado de vista para todo el servidor controles secundarios del control.(Heredado de Control).

System_CAPS_protmethodClearEffectiveClientIDMode()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Establece el ClientIDMode propiedad de la instancia actual del control y de todos los controles secundarios a Inherit.(Heredado de Control).

System_CAPS_protmethodCreateChildControls()

Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos.(Heredado de Control).

System_CAPS_protmethodCreateControlCollection()

Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor.(Heredado de Control).

System_CAPS_pubmethodDataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.(Heredado de Control).

System_CAPS_protmethodDataBind(Boolean)

Enlaza un origen de datos para el control de servidor invocado y todos sus controles secundarios con una opción para generar el DataBinding eventos.(Heredado de Control).

System_CAPS_protmethodDataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_pubmethodDispose()

Habilita un control de servidor realizar la limpieza final antes de que se libere de la memoria.(Heredado de Control).

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Finaliza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control).

System_CAPS_protmethodEnsureChildControls()

Determina si el control de servidor contiene controles secundarios. Si no es así, crea controles secundarios.(Heredado de Control).

System_CAPS_protmethodEnsureID()

Crea un identificador para los controles que no tienen un identificador asignado.(Heredado de Control).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.(Heredado de Object).

System_CAPS_pubmethodFindControl(String)

Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id parámetro.(Heredado de Control).

System_CAPS_protmethodFindControl(String, Int32)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id y un entero especificado en el pathOffset parámetro, lo que ayuda en la búsqueda. No se debe reemplazar esta versión de la FindControl (método).(Heredado de Control).

System_CAPS_pubmethodFocus()

Establece el foco en un control de entrada.(Heredado de Control).

System_CAPS_pubmethodSystem_CAPS_staticGetCurrent(Page)

Obtiene la instancia de ScriptManager para un objeto Page dado.

System_CAPS_protmethodGetDesignModeState()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene los datos de tiempo de diseño para un control.(Heredado de Control).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetRegisteredArrayDeclarations()

Recupera una colección de solo lectura de las declaraciones de matriz de ECMAScript (JavaScript) que se registraron anteriormente con el objeto Page.

System_CAPS_pubmethodGetRegisteredClientScriptBlocks()

Recupera una colección de solo lectura de los bloques de script de cliente que se registraron anteriormente con el control ScriptManager.

System_CAPS_pubmethodGetRegisteredDisposeScripts()

Recupera una colección de solo lectura de los scripts dispose que se registraron anteriormente con el objeto Page.

System_CAPS_pubmethodGetRegisteredExpandoAttributes()

Recupera una colección de solo lectura de atributos personalizados (expando) que se registraron anteriormente con el objeto Page.

System_CAPS_pubmethodGetRegisteredHiddenFields()

Recupera una colección de solo lectura de los campos ocultos que se registraron anteriormente con el objeto Page.

System_CAPS_pubmethodGetRegisteredOnSubmitStatements()

Recupera una colección de solo lectura de las instrucciones onsubmit que se registraron anteriormente con el objeto Page.

System_CAPS_pubmethodGetRegisteredStartupScripts()

Recupera una colección de solo lectura de los scripts de inicio que se registraron anteriormente con el objeto Page.

System_CAPS_pubmethodGetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.(Heredado de Control).

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.(Heredado de Control).

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.(Heredado de Control).

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.(Heredado de Control).

System_CAPS_pubmethodGetStateString()

Recupera una cadena que contiene pares clave-valor que representan el estado de la página web.

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Devuelve la parte fija de la UniqueID propiedad del control especificado.(Heredado de Control).

System_CAPS_pubmethodHasControls()

Determina si el control de servidor contiene todos los controles secundarios.(Heredado de Control).

System_CAPS_protmethodHasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.(Heredado de Control).

System_CAPS_protmethodIsLiteralContent()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Determina si el control de servidor alberga únicamente contenido literal.(Heredado de Control).

System_CAPS_protmethodLoadControlState(Object)

Restaura la información de estado de control de una solicitud de página anterior guardada por el SaveControlState (método).(Heredado de Control).

System_CAPS_protmethodLoadPostData(String, NameValueCollection)

Lee los datos de formulario que se exponen en el servidor desde el explorador y determina el origen del postback asincrónico.

System_CAPS_protmethodLoadViewState(Object)

Restaura la información de estado de vista de una solicitud de página anterior guardada por el SaveViewState (método).(Heredado de Control).

System_CAPS_protmethodMapPathSecure(String)

Recupera la ruta de acceso física que se asigna una ruta de acceso virtual absoluta o relativa, a.(Heredado de Control).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodOnAsyncPostBackError(AsyncPostBackErrorEventArgs)

Genera el evento AsyncPostBackError.

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página.(Heredado de Control).

System_CAPS_protmethodOnDataBinding(EventArgs)

Genera el evento DataBinding.(Heredado de Control).

System_CAPS_protmethodOnInit(EventArgs)

Provoca el evento Init y comprueba que haya tan solo un control ScriptManager en la página.(Invalida Control.OnInit(EventArgs)).

System_CAPS_protmethodOnLoad(EventArgs)

Genera el evento Load.(Heredado de Control).

System_CAPS_protmethodOnPreRender(EventArgs)

Provoca el evento PreRender y registra los archivos y servicios de script para las actualizaciones parciales de página.(Invalida Control.OnPreRender(EventArgs)).

System_CAPS_protmethodOnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)
System_CAPS_protmethodOnResolveScriptReference(ScriptReferenceEventArgs)

Provoca el evento ResolveScriptReference para cada referencia de script administrada por el control ScriptManager.

System_CAPS_protmethodOnUnload(EventArgs)

Genera el evento Unload.(Heredado de Control).

System_CAPS_protmethodOpenFile(String)

Obtiene un Stream utilizado para leer un archivo.(Heredado de Control).

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al elemento primario del control.(Heredado de Control).

System_CAPS_protmethodRaisePostBackEvent(String)

Procesa un evento de postback que genera el control ScriptManager y carga el estado del historial de la página web.

System_CAPS_protmethodRaisePostDataChangedEvent()

Genera eventos para el control ScriptManager cuando devuelve datos al servidor.

System_CAPS_pubmethodSystem_CAPS_staticRegisterArrayDeclaration(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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterArrayDeclaration(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.

System_CAPS_pubmethodRegisterAsyncPostBackControl(Control)

Registra un control como desencadenador de postbacks asincrónicos.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptBlock(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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptBlock(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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptInclude(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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptInclude(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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptResource(Control, Type, String)

Registra scripts de cliente incrustados en ensamblados con el control ScriptManager para su uso con un control que participa en la representación parcial de página.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptResource(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.

System_CAPS_pubmethodRegisterDataItem(Control, String)

Envía datos personalizados a un control durante la representación parcial de la página.

System_CAPS_pubmethodRegisterDataItem(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 de notación de objetos JavaScript (JSON).

System_CAPS_pubmethodRegisterDispose(Control, String)

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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterExpandoAttribute(Control, String, String, String, Boolean)

Registra un par de nombre y valor con el control ScriptManager como atributo personalizado (expando) de un control especificado.

System_CAPS_pubmethodRegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)

Registra un control extensor con la instancia de ScriptManager actual.

System_CAPS_pubmethodSystem_CAPS_staticRegisterHiddenField(Control, String, String)

Registra un campo oculto con el control ScriptManager para un control que está dentro de un control UpdatePanel.

System_CAPS_pubmethodSystem_CAPS_staticRegisterHiddenField(Page, String, String)

Registra un campo oculto con el control ScriptManager durante cada postback asincrónico.

System_CAPS_pubmethodSystem_CAPS_staticRegisterNamedClientScriptResource(Control, String)

Registra scripts por nombre de recurso de cliente incrustados en ensamblados con el control ScriptManager para su uso con un control que participa en la representación parcial de página.

System_CAPS_pubmethodSystem_CAPS_staticRegisterNamedClientScriptResource(Page, String)

Registra scripts por nombre de recurso de cliente incrustados en ensamblados con el control ScriptManager para su uso con un control que participa en la representación parcial de página.

System_CAPS_pubmethodSystem_CAPS_staticRegisterOnSubmitStatement(Control, Type, String, String)

Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se usa con un control UpdatePanel que se ejecuta cuando se envía el formulario.

System_CAPS_pubmethodSystem_CAPS_staticRegisterOnSubmitStatement(Page, Type, String, String)

Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se usa con un control UpdatePanel que se ejecuta cuando se envía el formulario.

System_CAPS_pubmethodRegisterPostBackControl(Control)

Registra un control como desencadenador de un postback. Este método se usa para configurar controles de postback que se encuentran dentro de un control UpdatePanel y que, de otro modo, realizarían postbacks asincrónicos.

System_CAPS_pubmethodRegisterScriptControl<TScriptControl>(TScriptControl)

Registra un control de script con la instancia de ScriptManager actual.

System_CAPS_pubmethodRegisterScriptDescriptors(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.

System_CAPS_pubmethodRegisterScriptDescriptors(IScriptControl)

Llama 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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterStartupScript(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.

System_CAPS_pubmethodSystem_CAPS_staticRegisterStartupScript(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.

System_CAPS_protmethodRemovedControl(Control)

Se llama después de que se quita un control secundario de la Controls colección de la Control objeto.(Heredado de Control).

System_CAPS_protmethodRender(HtmlTextWriter)

Representa el contenido del control ScriptManager en el explorador con el objeto HtmlTextWriter especificado.(Invalida Control.Render(HtmlTextWriter)).

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Envía el contenido de los elementos secundarios de un control de servidor a un HtmlTextWriter objeto, que escribe el contenido que se va a representar en el cliente.(Heredado de Control).

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Genera el contenido del control de servidor a un HtmlTextWriter de objeto y almacena información de seguimiento sobre el control si está habilitado el seguimiento.(Heredado de Control).

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Genera el contenido del control de servidor a un HtmlTextWriter objeto usando una URL ControlAdapter objeto.(Heredado de Control).

System_CAPS_protmethodResolveAdapter()

Obtiene el adaptador de control responsable de representar el control especificado.(Heredado de Control).

System_CAPS_pubmethodResolveClientUrl(String)

Obtiene una dirección URL que se puede usar el explorador.(Heredado de Control).

System_CAPS_pubmethodResolveUrl(String)

Convierte una dirección URL en una que se puede usar en el cliente solicitante.(Heredado de Control).

System_CAPS_protmethodSaveControlState()

Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor.(Heredado de Control).

System_CAPS_protmethodSaveViewState()

Guarda los cambios realizados en el estado de vista del control de servidor desde que la página volvió a publicarse en el servidor.(Heredado de Control).

System_CAPS_protmethodSetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.(Heredado de Control).

System_CAPS_pubmethodSetFocus(Control)

Establece el foco del explorador en el control especificado.

System_CAPS_pubmethodSetFocus(String)

Establece el foco del explorador en el control especificado mediante identificador.

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.(Heredado de Control).

System_CAPS_pubmethodSetTraceData(Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando la clave de datos de seguimiento y el valor de datos de seguimiento de seguimiento.(Heredado de Control).

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando el objeto de seguimiento, la clave de datos de seguimiento y el valor de datos de seguimiento de traza.(Heredado de Control).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

System_CAPS_protmethodTrackViewState()

Hace el seguimiento de cambios de estado de vista para el control de servidor para que puedan almacenarse en el control de servidor StateBag objeto. Este objeto es accesible a través de la propiedad Control.ViewState.(Heredado de Control).

NombreDescripción
System_CAPS_pubeventAsyncPostBackError

Se produce cuando hay un error de página durante un postback asincrónico.

System_CAPS_pubeventDataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.(Heredado de Control).

System_CAPS_pubeventDisposed

Se produce cuando un control de servidor se libera de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página ASP.NET.(Heredado de Control).

System_CAPS_pubeventInit

Se produce cuando se inicializa el control de servidor, que es el primer paso del ciclo de vida.(Heredado de Control).

System_CAPS_pubeventLoad

Se produce cuando el control de servidor se carga en el Page objeto.(Heredado de Control).

System_CAPS_pubeventNavigate

Se produce cuando el usuario hace clic en el botón Atrás o Adelante del explorador.

System_CAPS_pubeventPreRender

Se produce después de la Control es cargado pero antes de la representación.(Heredado de Control).

System_CAPS_pubeventResolveCompositeScriptReference

Se produce cuando un script compuesto se registra con el control ScriptManager.

System_CAPS_pubeventResolveScriptReference

Se produce cuando un miembro de la colección Scripts se registra con el control ScriptManager.

System_CAPS_pubeventUnload

Se produce cuando el control de servidor se descarga de la memoria.(Heredado de Control).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Para una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Para una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Para una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Para una descripción de este miembro, vea IParserAccessor.AddParsedSubObject.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.LoadPostData(String, NameValueCollection)

Para una descripción de este miembro, vea IPostBackDataHandler.LoadPostData.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.RaisePostDataChangedEvent()

Para una descripción de este miembro, vea IPostBackDataHandler.RaisePostDataChangedEvent.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackEventHandler.RaisePostBackEvent(String)

Habilita el control ScriptManager para procesar un evento de postback y cargar el estado del historial de la página web.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Para una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Para una descripción de este miembro, vea IControlDesignerAccessor.UserData.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.DataBindings.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Para una descripción de este miembro, vea IExpressionsAccessor.Expressions.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Para una descripción de este miembro, vea IExpressionsAccessor.HasExpressions.(Heredado de Control).

NombreDescripción
System_CAPS_pubmethodFindDataSourceControl()

Devuelve el origen de datos que está asociado con el control de datos para el control especificado.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindFieldTemplate(String)

Devuelve que el contenedor de nomenclatura de la plantilla de campo para la columna especificada en el control especificado.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindMetaTable()

Devuelve el objeto de metatabla para el control de datos que contiene.(Definido por DynamicDataExtensions).

El ScriptManager control es fundamental para la funcionalidad de Ajax en ASP.NET. El control administra todos los recursos de ASP.NET Ajax en una página. Esto incluye la descarga de Microsoft Ajax Library el explorador y coordinar las actualizaciones parciales de página que se habilitan mediante secuencias de comandos UpdatePanel controles. Además, el ScriptManager control le 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 carga después de la Microsoft Ajax Library secuencia de comandos.

  • Especifique si la versión o scripts de depuración se envían al explorador.

  • Proporcionar acceso a métodos de servicio Web desde un script registrando servicios Web con el ScriptManager control.

  • Proporcionar servicios de aplicaciones desde el script de cliente de acceso a la autenticación, rol y perfil ASP.NET registrando estos servicios con el ScriptManager control.

  • Habilitar la visualización de la referencia cultural de ECMAScript (JavaScript) y funciones en el explorador.

  • Obtener acceso a recursos de localización para archivos de script incrustados o para archivos de script independientes mediante el ResourceUICultures propiedad de la ScriptReference control.

  • Registrar controles de servidor que implementan el IExtenderControl o IScriptControl interactúa con el ScriptManager control para que se represente el script requerido componentes de cliente y comportamientos.

La capacidad de una página ASP.NET para admitir la representación parcial de página se controla mediante los siguientes factores:

Puede invalidar el valor de la EnablePartialRendering propiedad en tiempo de ejecución durante o antes de la página Init eventos. Si intenta cambiar esta propiedad después de la página Init se ha producido el evento, un InvalidOperationException excepción.

Cuando se admite la representación parcial de página, el ScriptManager control representa el script para habilitar las devoluciones de datos asincrónicas y las actualizaciones parciales de página. Las regiones de la página Actualizar se designan utilizando UpdatePanel controles. El ScriptManager control controla las devoluciones de datos asincrónicas y actualiza sólo las regiones de la página que se actualizará. Para obtener más información acerca de la representación parcial de página, consulte Partial-Page Rendering Overview. Para obtener más información acerca de las condiciones que provocan una actualización, consulte UpdatePanel Control Overview.

Una página puede contener sólo un ScriptManager control 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 ScriptManager control, use el ScriptManagerProxy control. Para obtener más información, vea Using the ASP.NET UpdatePanel Control with Master Pages

El ScriptManager control permite registrar script que después se representa como parte de la página. El ScriptManager los métodos de registro de control se pueden dividir en las tres categorías siguientes:

  • Los métodos de registro que garantizan que las dependencias de script en el Microsoft Ajax Library se mantienen.

  • Métodos de registro que no son dependientes de la Microsoft Ajax Library, pero que son compatibles con UpdatePanel controles.

  • Los métodos de registro que permiten trabajar con UpdatePanel controles.

Para obtener más información acerca de cómo crear y usar script Ajax en ASP.NET, consulte Creating Custom Client Script by Using the Microsoft Ajax Library.

Puede usar los métodos siguientes para registrar archivos de script de forma que se garantiza que todas las dependencias en el Microsoft Ajax Library se mantienen. 

Método

Definición

RegisterScriptControl<TScriptControl>

Registra un control de servidor que implementa el IScriptControl interfaz que se utiliza para definir un objeto de cliente. El ScriptManager control representa script que admite el objeto de cliente.

RegisterExtenderControl<TExtenderControl>

Registra un control de servidor que implementa el IExtenderControl interfaz que se utiliza para definir un objeto de cliente. El ScriptManager control representa script que admite el objeto de cliente.

Puede utilizar los métodos siguientes para registrar los archivos de script que no dependen del Microsoft Ajax Library pero que son compatibles con UpdatePanel controles. Estos métodos corresponden a los métodos similares de la ClientScriptManager control. Si es un script de representación para su uso dentro de un UpdatePanel control, asegúrese de llamar a los métodos de la ScriptManager control.

Método

Definición

RegisterArrayDeclaration

Agrega un valor a una matriz de JavaScript. Si la matriz no existe, se crea.

RegisterClientScriptBlock

Representa un script elemento después de abrir la página <form> etiqueta. El script se especifica como un parámetro de cadena.

RegisterClientScriptInclude

Representa un script elemento después de abrir la página <form> etiqueta. El contenido del script se especifica estableciendo el src atributo a una dirección URL que apunta a un archivo de script.

RegisterClientScriptResource

Representa un script elemento después de abrir la página <form> etiqueta. El contenido del script se especifica con un nombre de recurso en un ensamblado. El src atributo se rellena automáticamente con una dirección URL mediante una llamada a un controlador HTTP que recupera el script con nombre del ensamblado.

RegisterExpandoAttribute

Representa un par de atributo de nombre o valor personalizado (expando) en el marcado para un control especificado.

RegisterHiddenField

Representa un campo oculto.

RegisterOnSubmitStatement

Registra un script que se ejecuta en respuesta a la form del elemento submit eventos. El onSubmit atributo hace referencia a la secuencia de comandos especificado.

RegisterStartupScript

Representa un bloque de script de inicio justo antes de cerrar la página </form> etiqueta. La secuencia de comandos para representar se especifica como un parámetro de cadena.

Al registrar los métodos, especifique un par de tipo y clave para ese script. Si ya está registrado un script con el mismo par de tipo y clave, no se registra un nuevo script. De forma similar, si se registra un script con un par de nombre de tipo o recurso que ya existe, la script no se agrega el elemento que hace referencia al recurso nuevo. Al registrar un atributo expando de un atributo previamente registrado, se produce una excepción. Se permite el registro duplicado de valores de la matriz.

Cuando se llama a la RegisterClientScriptInclude o la RegisterClientScriptResource método, evite registrar script que ejecute funciones inline. En su lugar, registre script que contiene las definiciones de función como controladores de eventos o definiciones de clase personalizadas para su aplicación.

Puede utilizar los métodos siguientes para personalizar las actualizaciones parciales de página al usar UpdatePanel controles.

Método

Definición

RegisterAsyncPostBackControl

Registra un control como desencadenador de postbacks asincrónicos.

RegisterDataItem

Envía datos personalizados a los controles durante la representación parcial de la página.

RegisterDispose

Registra un script de eliminación para un control que está dentro de un UpdatePanel control. Se ejecuta el script cuando el control UpdatePanel se actualiza o elimina. El método dispose se utiliza para los componentes de cliente que forman parte de la Microsoft Ajax Library y que tienen que liberar recursos cuando ya no se utiliza un componente.

RegisterPostBackControl

Registra un control como desencadenador de una devolución completa. Este método se utiliza para los controles dentro de un UpdatePanel control que de lo contrario, realizarían postbacks asincrónicos.

Puede registrar un servicio Web puede llamar desde script de cliente mediante la creación de un ServiceReference objeto y agregarlo a la Services colección de la ScriptManager control. ASP.NET genera un objeto de proxy de cliente para cada ServiceReference objeto en el Services colección. Puede agregar mediante programación ServiceReference objetos a la Services colección para registrar servicios Web en tiempo de ejecución.

Para obtener más información acerca de cómo obtener acceso a servicios Web en script, consulte Exposing Web Services to Client Script in ASP.NET AJAX y Calling Web Services from Client Script in ASP.NET AJAX.

El ScriptManager control genera referencias en la página representada que señalan a los archivos de script localizados adecuados, que pueden ser archivos de script incrustados en ensamblados o archivos de script independientes.

Cuando el EnableScriptLocalization propiedad se establece en true, el ScriptManager control recupera los recursos localizados (por ejemplo, cadenas localizadas) para la referencia cultural actual, si existen. El ScriptManager control proporciona la funcionalidad siguiente para utilizar recursos localizados:

  • Archivos que están incrustados en un ensamblado de script. El ScriptManager control determina qué archivo de secuencia de comandos específicos de la referencia cultural o la referencia cultural de reserva para enviar al explorador. Esto hace utilizando la referencia cultural específica NeutralResourcesLanguageAttribute assembly (atributo), los recursos empaquetados con el ensamblado y la referencia cultural de interfaz de usuario del explorador (si existe).

  • Archivos de script independientes. El ScriptManager control define la lista de referencias culturales de interfaz de usuario que son compatibles con el ResourceUICultures propiedad de la ScriptReference objeto.

  • En modo de depuración. El ScriptManager control intenta procesar un archivo de secuencia de comandos específica 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 se establece en-MX, el control representa un archivo de script que tiene un nombre como scriptname.en-MX.debug.js, si el archivo existe. Si el archivo no existe, se procesa el archivo de depuración de la referencia cultural de reserva adecuada

Para obtener más información sobre cómo localizar recursos, consulte Localizing Resources for Component Libraries Overview.

Cuando se produce un error de página durante las devoluciones asincrónicas, el AsyncPostBackError provoca el evento. La manera en que los errores en el servidor se envían al cliente depende del AllowCustomErrorsRedirect propiedad, el AsyncPostBackErrorMessage propiedad y la sección de errores personalizados del archivo Web.config. Para obtener más información, consulta Customizing Error Handling for ASP.NET UpdatePanel Controls.

<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>

Los ejemplos siguientes muestran diferentes escenarios de utilización del ScriptManager control.

Habilitar actualizaciones parciales de página

En el ejemplo siguiente se muestra cómo utilizar el ScriptManager control para habilitar actualizaciones parciales de página. En este ejemplo, un Calendar y un DropDownList control están dentro de un UpdatePanel control. De forma predeterminada, el valor de la UpdateMode propiedad es Always, y el valor de la ChildrenAsTriggers propiedad es true. Por lo tanto, los controles secundarios del panel de provocan un postback asincrónico.


<%@ 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>

Control de errores de actualización parcial de página y registrar el Script

En el ejemplo siguiente se muestra cómo proporcionar control durante las actualizaciones parciales de la página de errores personalizada. 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 los errores personalizados proporcionando un controlador para el AsyncPostBackError eventos y estableciendo el AsyncPostBackErrorMessage propiedad en el controlador de eventos. También puede establecer el AllowCustomErrorsRedirect propiedad para especificar cómo se usa la sección de errores personalizados del archivo Web.config cuando se produce un error durante las actualizaciones parciales de página. En este ejemplo, el valor predeterminado de la AllowCustomErrorsRedirect se utiliza la propiedad. Esto significa que si el archivo Web.config contiene un elemento, ese elemento determina cómo se muestran los errores. Para obtener más información, consulte customErrors Element (ASP.NET Settings Schema).

<%@ 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

En el ejemplo siguiente se muestra cómo establecer el EnableScriptGlobalization propiedad ese script de cliente pueda mostrar una fecha específica de la referencia cultural y la hora en el explorador. En el ejemplo, el Culture de la directiva se establece 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 de la página. Para obtener más información, consulta Cómo: establecer la referencia cultural y la referencia cultural de la interfaz de usuario para la globalización de páginas web de 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>

.NET Framework
Disponible desde 3.5

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: