ScriptMode ScriptMode ScriptMode ScriptMode Enum

Definición

Especifica si los objetos ScriptManager y ScriptReference hacen referencia a la versión de depuración o lanzamiento de scripts de cliente.Specifies whether ScriptManager and ScriptReference objects refer to the debug or release version of client scripts.

public enum class ScriptMode
public enum ScriptMode
type ScriptMode = 
Public Enum ScriptMode
Herencia

Campos

Auto Auto Auto Auto 0

En el control ScriptManager, se determina la versión de los scripts de cliente que se van a usar en tiempo de ejecución en función del elemento <compilation> del nivel de aplicación del archivo Web.config, a menos que se invalide en una instancia del control ScriptReference.In the ScriptManager control, the version of client scripts to use is determined at run time based on the application-level <compilation> element of the Web.config file, unless it is overridden in an instance of the ScriptReference control. En el control ScriptReference, cuando se aplica a un archivo de script independiente, Auto es equivalente a Release.In the ScriptReference control, when applied to a standalone script file, Auto is equivalent to Release. Cuando se aplica a una referencia de script en un ensamblado, Auto es equivalente a Inherit.When applied to a script reference in an assembly, Auto is equivalent to Inherit.

Debug Debug Debug Debug 2

En el control ScriptManager, la versión de depuración del script de cliente se utiliza en la página web a menos que se invalide en una instancia del control ScriptReference.In the ScriptManager control, the debug version of the client script is used on the Web page unless overridden in an instance of the ScriptReference control. En el control ScriptReference, la versión de depuración del script de cliente se utiliza en la página web.In the ScriptReference control, the debug version of the client script is used on the Web page.

Inherit Inherit Inherit Inherit 1

En el control ScriptManager, Inherit es equivalente a Auto.In the ScriptManager control, Inherit is equivalent to Auto. En el control ScriptReference, el valor ScriptMode de ScriptManager determina qué versión del script de cliente se va a utilizar.In the ScriptReference control, the ScriptMode value from ScriptManager determines which version of the client script to use.

Release Release Release Release 3

En el control ScriptManager, la versión de lanzamiento del script de cliente se utiliza en la página web a menos que se invalide mediante el establecimiento de la propiedad ScriptMode de una instancia de ScriptReference en Debug.In the ScriptManager control, the release version of the client script is used on the Web page unless overridden by setting the ScriptMode property of a ScriptReference instance to Debug. En el control ScriptReference, la versión de lanzamiento del script de cliente se utiliza en la página web.In the ScriptReference control, the release version of the client script is used on the Web page.

Ejemplos

En el ejemplo siguiente se muestra una página en la que las versiones de script se establecen mediante ScriptManager declaración en release en el control, pero un script denominado CustomClient. js se establece mediante Name declaración en debug en el control.The following example shows a page where the script versions are declaratively set to Release in the ScriptManager control, but one script named CustomClient.js is declaratively set to Debug in the Name control.

<asp:ScriptManager ID="SM" runat="server" ScriptMode="Release">
    <Scripts>
        <asp:ScriptReference Path="CustomClient.js" ScriptMode="Debug" />
    </Scripts>
</asp:ScriptManager>
<asp:ScriptManager ID="SM" runat="server" ScriptMode="Release">
    <Scripts>
        <asp:ScriptReference Path="CustomClient.js" ScriptMode="Debug" />
    </Scripts>
</asp:ScriptManager>

Comentarios

La ScriptMode enumeración proporciona valores para establecer la versión del script de cliente que se va a usar en una página web.The ScriptMode enumeration provides values for setting the version of client script to use on a Web page. Los valores de enumeración se pueden aplicar a ScriptManager.ScriptMode la propiedad o a la propiedad ScriptReference. ScriptMode .The enumeration values can be applied to either the ScriptManager.ScriptMode property or to the ScriptReference.ScriptMode property. El ScriptManager objeto establece la versión de todos los scripts de la página a menos que un ScriptReference objeto lo invalide.The ScriptManager object sets the version for all scripts on the page unless it is overridden by a ScriptReference object. El ScriptReference objeto establece la versión de un script determinado.The ScriptReference object sets the version for a particular script.

El ScriptMode.Auto valor produce resultados diferentes en función de si hace referencia a un archivo de script independiente o a un archivo de script que se incrusta como un recurso en un ensamblado.The ScriptMode.Auto value produces different results depending on whether it refers to a standalone script file or to a script file that is embedded as a resource in an assembly. Un archivo de script independiente se define con la propiedad ScriptReference. Path .A standalone script file is defined with the ScriptReference.Path property. Se debe obtener acceso a una referencia de ensamblado Assembly a través de las Name propiedades y.An assembly reference must be accessed through the Name and Assembly properties. Los resultados ScriptMode.Auto del valor son los siguientes:The results for the ScriptMode.Auto value are as follows:

Se produce un error si la versión solicitada del script no existe.An error is thrown if the requested version of the script does not exist. Por ejemplo, se produce un error si se hace una referencia a un archivo de script independiente denominado CustomScript. js y la ScriptManager.ScriptMode propiedad está establecida en ScriptMode.Debug, pero CustomScript. Debug. js no existe en el sitio.For instance, an error is thrown if a reference is made to a standalone script file that is named CustomScript.js and the ScriptManager.ScriptMode property is set to ScriptMode.Debug, but CustomScript.debug.js does not exist on the site. Las referencias a los scripts de un ensamblado devuelven la versión de lanzamiento si la versión de depuración no existe.References to scripts in an assembly return the release version if the debug version does not exist.

Nota

Cuando el retail atributo del elemento Deployment del archivo Machine. config se establece en true, se usan las versiones de lanzamiento de los scripts de cliente en todo el sitio Web.When the retail attribute of the deployment element of the Machine.config file is set to true, the release versions of client scripts are used throughout the Web site. Se ScriptMode omiten los ScriptManager.ScriptMode valores de las propiedades y ScriptReference. ScriptMode .The ScriptMode values in the ScriptManager.ScriptMode and ScriptReference.ScriptMode properties are ignored.

Se aplica a