ScriptMode Enumeración

Referencia

Definición

Espacio de nombres:: System.Web.UI

Ensamblado:: System.Web.Extensions.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Especifica si los objetos ScriptManager y ScriptReference hacen referencia a la versión de depuración o lanzamiento de scripts de cliente.

public enum class ScriptMode

public enum ScriptMode

type ScriptMode =

Public Enum ScriptMode

Herencia: Object

ValueType

Enum
ScriptMode

Campos

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. En el control ScriptReference, cuando se aplica a un archivo de script independiente, Auto es equivalente a Release. Cuando se aplica a una referencia de script en un ensamblado, Auto es equivalente a Inherit.
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. En el control ScriptReference, la versión de depuración del script de cliente se utiliza en la página web.
Inherit	1	En el control ScriptManager, Inherit es equivalente a Auto. En el control ScriptReference, el valor ScriptMode de ScriptManager determina qué versión del script de cliente se va a utilizar.
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. En el control ScriptReference, la versión de lanzamiento del script de cliente se utiliza en la página web.

Ejemplos

En el ejemplo siguiente se muestra una página en la que las versiones del script se establecen mediante declaración en Release en el ScriptManager control, pero un script denominado CustomClient.js se establece mediante declaración en Depurar en el 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 usará en una página web. Los valores de enumeración se pueden aplicar a la ScriptManager.ScriptMode propiedad o a la propiedad ScriptReference.ScriptMode . El ScriptManager objeto establece la versión de todos los scripts de la página a menos que un objeto lo invalide ScriptReference . El ScriptReference objeto establece la versión de un script determinado.

El ScriptMode.Auto valor genera resultados diferentes en función de si hace referencia a un archivo de script independiente o a un archivo de script incrustado como un recurso en un ensamblado. Un archivo de script independiente se define con la propiedad ScriptReference.Path . Se debe tener acceso a una referencia de ensamblado a través de las Name propiedades y Assembly . Los resultados del ScriptMode.Auto valor son los siguientes:

Cuando se aplica a un archivo de script independiente donde se especifica la propiedad [ScriptReference.Path],Path el ScriptMode.Auto valor es equivalente a ScriptMode.Release.
Cuando se aplica a una referencia de script en un ensamblado, ScriptMode.Auto es equivalente a ScriptMode.Inherit. Cuando solo Name se especifica , se usa para hacer referencia al script. Cuando Name y la propiedad [ScriptReference.Path]Path se especifican, se usa la propiedad [ScriptReference.Path]Path en lugar de Name, pero el ScriptMode.Auto valor sigue siendo equivalente a ScriptMode.Inherit.

Se produce un error si la versión solicitada del script no existe. 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 se establece ScriptMode.Debugen , pero CustomScript.debug.js no existe en el sitio. Las referencias a scripts de un ensamblado devuelven la versión de lanzamiento si la versión de depuración no existe.

Nota

Cuando el retail atributo del elemento de implementación del archivo Machine.config se establece trueen , las versiones de lanzamiento de los scripts de cliente se usan en todo el sitio web. Los ScriptMode valores de las ScriptManager.ScriptMode propiedades y ScriptReference.ScriptMode se omiten.

Se aplica a