Condividi tramite

Contesto di esecuzione (riferimento sul lato client)

  • Articolo

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

Il contesto di esecuzione è un parametro facoltativo che è possibile passare a una funzione della libreria JavaScript tramite un gestore eventi. Questa opzione è presentata nella finestra di dialogo delle proprietà del gestore quando si specifica il nome della funzione. Questa opzione viene impostata per un elemento <Handler> (FormXml) che utilizza l'attributo passExecutionContext.

Il contesto di esecuzione viene automaticamente passato alle funzioni impostate utilizzando i metodi Xrm.Page.data.addOnSave e Xrm.Page.data.entityAttribute.addOnChange e Xrm.Page.uiControl.addPreSearch.

Metodi del contesto di esecuzione

  • getContext
    Metodo che restituisce l'oggetto Contesto sul lato client (riferimento sul lato client).

  • getDepth
    Metodo che restituisce un valore che indica l'ordine in cui questo gestore viene eseguito.

  • getEventArgs
    Metodo che restituisce un oggetto con i metodi per gestire l'evento Save.

  • getEventSource
    Metodo che restituisce un riferimento all'oggetto in cui si è verificato l'evento.

  • Variabili condivise
    Le variabili condivise consentono la condivisione di una variabile con altri gestori per lo stesso evento. Utilizzare i metodi getSharedVariable e setSharedVariable da utilizzare con le variabili condivise.

getContext

Metodo che restituisce l'oggetto Contesto sul lato client (riferimento sul lato client)

ExecutionContextObj.getContext()
  • Valore restituito
    Tipo: oggetto.

getDepth

Metodo che restituisce un valore che indica l'ordine in cui questo gestore viene eseguito.

  • Valore restituito
    Tipo: numero

    L'ordine inizia con 0.

getEventArgs

Metodo che restituisce un oggetto con i metodi per gestire l'evento Save.

Nota

Questo metodo restituisce null per ogni evento diverso dall'evento Save.

ExecutionContextObj.getEventArgs()

getEventSource

Metodo che restituisce un riferimento all'oggetto in cui si è verificato l'evento.

ExecutionContextObj.getEventSource()

  • Valore restituito
    Tipo: oggetto.

    Questo metodo restituisce l'oggetto dal modello a oggetti Xrm.Page che è l'origine dell'evento, non un oggetto HTMLDOM. Ad esempio, in un evento OnChange, questo metodo restituisce l'oggetto dell'attributo Xrm.Page.data.entity che rappresenta l'attributo modificato.

Variabili condivise

Le variabili condivise consentono la condivisione di una variabile con altri gestori per lo stesso evento. Utilizzare i metodi di getSharedVariable e setSharedVariable per passare le variabili tra le funzioni.

setSharedVariable

Imposta il valore di una variabile da utilizzare da un gestore al termine del gestore corrente.

ExecutionContextObj.setSharedVariable(key, value)

  • Argomenti
    String: il nome della variabile

    Object: il valore da impostare.

getSharedVariable

Recupera una variabile impostata tramite setSharedVariable.

ExecutionContextObj.getSharedVariable(key)

  • Argomenti
    String: il nome della variabile.

  • Valore restituito
    Tipo: oggetto.

    Il tipo specifico dipende dall'oggetto del valore.

Vedere anche

Riferimento programmazione sul lato client

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright