ScriptMode Enumeración
Definición
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 ScriptManager y ScriptReference objetos hacen referencia a la versión de depuración o versión de los scripts de cliente.
public enum class ScriptModepublic enum ScriptModetype ScriptMode = Public Enum ScriptMode- Herencia
Campos
| Nombre | Valor | Description |
|---|---|---|
| Auto | 0 | En el ScriptManager control, la versión de los scripts de cliente que se van a usar se determina en tiempo de ejecución en función del elemento de compilación> de nivel< de aplicación del archivo Web.config, a menos que se invalide en una instancia del ScriptReference control. En el ScriptReference control , 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. |
| Inherit | 1 | En el ScriptManager control , Inherit es equivalente a Auto. En el ScriptReference control , el ScriptMode valor de determina la ScriptManager versión del script de cliente que se va a usar. |
| Debug | 2 | En el ScriptManager control , la versión de depuración del script de cliente se usa en la página web a menos que se invalide en una instancia del ScriptReference control . En el ScriptReference control , la versión de depuración del script de cliente se usa en la página web. |
| Release | 3 | En el ScriptManager control , la versión de lanzamiento del script de cliente se usa en la página web a menos que se invalide estableciendo la ScriptMode propiedad de una ScriptReference instancia Debugen . En el ScriptReference control , la versión de lanzamiento del script de cliente se usa en la página web. |
Ejemplos
En el ejemplo siguiente se muestra una página en la que las versiones de script se establecen declarativamente en Release en el ScriptManager control, pero un script denominado CustomClient.js se establece declarativamente 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 va a 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 ScriptReference objeto lo invalide. 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 realiza 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 versión 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 versión 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.
