AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones específicas de la Web / Funciones de páginas
  • Si se utiliza el modo de gestión de contextos mediante cookies (constante ctxCookie utilizada en ConfigureAWPContext):
  • Si se utiliza el modo de gestión de contextos en disco (constante ctxDisk utilizada en ConfigureAWPContext):
  • Miscelánea
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
Se utiliza para declarar una lista de variables cuyos valores serán persistentes entre sucesivas visualizaciones de Páginas WEBDEV Activas. Esta función indica las variables que se guardarán y restaurarán cada vez que se visualicen las Páginas WEBDEV Activas. Esto le permite gestionar un contexto AWP. Hay dos modos disponibles para gestionar los contextos:
  • Gestión de contextos mediante cookies (por defecto).
  • Gestión de contextos en disco.
El modo de gestión de los contextos se selecciona en ConfigureAWPContext. Si no se llama a esta función, los contextos se gestionan por defecto mediante cookies.
DeclareAWPContext sólo se tiene en cuenta en el modo AWP.
Se recomienda utilizar esta función en el evento de inicialización del proyecto (para variables de proyecto) y/o en el evento de inicialización de la página (para variables de página). En la mayoría de los casos, esta función debe utilizarse en el proceso en el que se declaran e inicializan las variables.
Si el proyecto utiliza sesiones preiniciadas, esta función no debe utilizarse en el evento "Inicialización" del proyecto. Debe utilizarse en el evento "Inicialización en modo de sesión preiniciada".
Nota: Para más detalles:
Nota: Esta función está destinada a desarrolladores familiarizados con WEBDEV.
Ejemplo
// -- Project initialization code 
gnNumCurrentProduct is int = 1

// Indicate that the value of gnNumCurrentProduct must be saved
// whenever an Active WEBDEV Page is displayed
DeclareAWPContext(gnNumCurrentProduct)

// During the next displays of the page:
// - either the value of gnNumCurrentProduct is not retrieved 
// and it is automatically reinitialized with "1"
// (during the first page display for example)
// - or the value of gnNumCurrentProduct is retrieved and used
// (during the next displays for example)
Sintaxis
<Result> = DeclareAWPContext(<Variable name 1> [, <Variable name 2> [... [, <Name of variable N>]]])
<Result>: booleano
  • True si se restauraron las variables especificadas,
  • False en caso contrario (al mostrar la página por primera vez, por ejemplo).
<Variable name 1>: Tipo de variable
Nombre de la primera variable que se guardará al final de la visualización. El valor de esta variable se recuperará durante las sucesivas visualizaciones de la página.
<Variable name 2>: Tipo de variable (parámetro opcional)
Nombre de la 2ª variable que se guardará al final de la visualización. El valor de esta variable se recuperará durante las sucesivas visualizaciones de la página.
<Name of variable N>: Tipo de variable (parámetro opcional)
Nombre de la enésima variable que se guardará al final de la visualización. El valor de esta variable se recuperará durante las sucesivas visualizaciones de la página.
Observaciones

Si se utiliza el modo de gestión de contextos mediante cookies (constante ctxCookie utilizada en ConfigureAWPContext):

  • DeclareAWPContext utiliza cookies HTTP. Los valores de las variables no se restaurarán si las cookies HTTP son ignoradas por el navegador utilizado en el ordenador actual.
  • El tamaño total de los valores de las diferentes variables no puede superar los 4KB. Si el tamaño de estos valores es demasiado importante, se truncarán (variable omitida y/o contenido truncado).
  • No se recomienda utilizar la función DeclareAWPContext para datos confidenciales (contraseña del usuario, por ejemplo). De hecho, los datos fluyen a través del navegador. Esta función NO debe utilizarse para almacenar una conexión de usuario, por ejemplo.
  • Si se guardan dos variables con el mismo nombre (una en el proyecto y otra en una página, por ejemplo), sólo se guardará la primera variable.
  • DeclareAWPContext devuelve Falso si una de las variables no ha sido restaurada.
  • Solo las variables pasadas a la función DeclareAWPContext durante la visualización de una página se recuperarán durante la siguiente visualización. Las variables pasadas anteriormente no se vuelven a guardar automáticamente.
  • Sólo se admiten variables simples (enteros, cadenas, etc.).
    Nota: Para manipular buffers, utilice el contexto en disco en su lugar.

Si se utiliza el modo de gestión de contextos en disco (constante ctxDisk utilizada en ConfigureAWPContext):

  • La función DeclareAWPContext utiliza contextos en el disco. Los valores de las variables se restablecen siempre.
  • El tamaño total de los valores de las distintas variables no está limitado.
  • DeclareAWPContext puede utilizarse para datos sensibles (contraseña de usuario, por ejemplo).
  • Si se guardan dos variables con el mismo nombre (una en el proyecto y otra en una página, por ejemplo), las dos variables se guardan independientemente.
  • DeclareAWPContext devuelve Falso si una de las variables no ha sido restaurada.
  • Todas las variables pasadas a la función DeclareAWPContext durante la visualización de una página se recuperarán durante la siguiente visualización. Las variables pasadas anteriormente se vuelven a guardar automáticamente.
  • Se admiten variables simples (entero, cadena, etc.), así como variables de tipo:
    • estructura,
    • class,
    • array,
    • array asociativo,
    • combinación,
    • enumeración,
    • Novedad versión 2025
      Json.
  • No se admiten los siguientes tipos de variables:
    • arrays fijos,
    • miembros globales de las clases,
    • arrays asociativos de estructuras locales,
    • referencias a objetos dinámicos.

Miscelánea

DeclareAWPContext puede llamarse varias veces para acumular declaraciones de variables persistentes.
Componente: wd300page.dll
Versión mínima requerida
  • Versión 10
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 13/03/2025

Señalar un error o enviar una sugerencia | Ayuda local