Leggere o modificare le proprietà di sessione¶

Cambiare l’utente di sessione

Fare riferimento all’API Session.ChangeUser(username, password) ChangeUser.

Modificare i locale di sessione

Per modificare i locale di sessione, istanziare un array di tipo stringa tramite la sintassi new string[].

Nota

è necessario istanziare un array perché la sessione prevede locale di fallback (vedere Localizzazione di fallback).

Di seguito un esempio di impostazione dei locale su inglese internazionale e italiano.

Session.LocaleIds = new string[] {"en-US", "it-IT"};

Eseguire metodi al cambio utente

Per eseguire metodi all’evento di cambio utente usare il gestore eventi UserChange, fornito dalla classe Session.

Avvertimento

Annullare sempre la sottoscrizione all’interno del metodo Stop(), per evitare consumo di memoria.

Di seguito un esempio in cui si esegue il metodo Session_UserChange a ogni cambio utente, fino all’annullamento della sottoscrizione:

public override void Start()
{
    Session.UserChange += Session_UserChange;
}

private void Session_UserChange(object sender, UserChangeEventArgs e)
{
    Log.Info(e.newUser.BrowseName);
}

public override void Stop()
{
    Session.UserChange -= Session_UserChange;
}

Il tipo di dato UserChangeEventArgs è una classe che espone le due proprietà newUser e oldUser, che rappresentano rispettivamente i nodi del nuovo e del vecchio utente. Nell’esempio precedente il metodo Session_UserChange genera un log che riporta il BrowseName del nuovo utente.