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 los objetos ScriptManager y ScriptReference hacen referencia a la versión de depuración o lanzamiento de scripts de cliente.
public enum class ScriptModepublic enum ScriptModetype ScriptMode = Public Enum ScriptMode- Herencia
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 ScriptManager control , Inherit es equivalente a Auto. En el ScriptReference control , el ScriptMode valor de ScriptManager determina la versión del script de cliente que se va a usar. |
| 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 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 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, la propiedad [ScriptReference.Path]Path se usa 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 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.
