Oggetto My.User

Articolo
09/12/2008

Aggiornamento: novembre 2007

Fornisce l'accesso alle informazioni relative all'utente corrente.

Note

Le proprietà e i metodi esposti dall'oggetto My.User forniscono l'accesso alle informazioni relative all'utente corrente. Il significato di "utente corrente" è leggermente diverso tra le applicazioni Windows e Web. In un'applicazione Windows, l'utente corrente è l'utente che esegue l'applicazione. In un'applicazione Web, l'utente corrente è l'utente che ha accesso all'applicazione.

La proprietà My.User fornisce inoltre l'accesso a IPrincipal per l'utente corrente. Un oggetto Principal rappresenta il contesto di protezione dell'utente, compresa l'identità dell'utente e qualsiasi ruolo al quale appartiene l'utente.

Per le applicazioni Windows, questa proprietà fornisce la stessa funzionalità della proprietà CurrentPrincipal. Per le applicazioni Web, questa proprietà fornisce la stessa funzionalità della proprietà User dell'oggetto restituito dalla proprietà Current.

Nota:
Per le applicazioni Windows, solo i progetti realizzati sul modello dell'Applicazione Windows inizializza l'oggetto My.User come impostazione predefinita. In tutti gli altri tipi di progetti Windows, è necessario inizializzare l'oggetto My.User chiamando Metodo My.User.InitializeWithWindowsUser in maniera esplicita o assegnando un valore a CurrentPrincipal.

Nota:
L'oggetto My.User non è in grado di restituire le informazioni relative all'utente Windows corrente quando viene eseguito in Windows 95 e Windows 98 in quanto questi sistemi operativi non sostengono il concetto di un utente connesso. È necessario implementare l'autenticazione personalizzata per utilizzare l'oggetto My.User su quei sistemi operativi. Per ulteriori informazioni, vedere Procedura dettagliata: implementazione di autenticazione e autorizzazione personalizzate.

L'oggetto My.User non è in grado di restituire le informazioni relative all'utente Windows corrente quando viene eseguito in Windows 95 e Windows 98 in quanto questi sistemi operativi non sostengono il concetto di un utente connesso. È necessario implementare l'autenticazione personalizzata per utilizzare l'oggetto My.User su quei sistemi operativi. Per ulteriori informazioni, vedere Procedura dettagliata: implementazione di autenticazione e autorizzazione personalizzate.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative all'oggetto My.User.

Per	Vedere
Ottenere il nome di accesso dell'utente	Procedura: determinare il nome di accesso di un utente
Ottenere il nome di dominio dell'utente se nell'applicazione viene utilizzata l'autenticazione di Windows	Procedura: determinare il dominio utente
Determinare il ruolo dell'utente	Procedura: determinare l'appartenenza di un utente a un gruppo
Implementare l'autenticazione personalizzata	Procedura dettagliata: implementazione di autenticazione e autorizzazione personalizzate

Esempio

Nell'esempio riportato di seguito si verifica se l'applicazione utilizza un'autenticazione personalizzata o di Windows e tali informazioni vengono utilizzate per analizzare la proprietà My.User.Name.

Function GetUserName() As String
    If TypeOf My.User.CurrentPrincipal Is _
    Security.Principal.WindowsPrincipal Then
        ' The application is using Windows authentication.
        ' The name format is DOMAIN\USERNAME.
        Dim parts() As String = Split(My.User.Name, "\")
        Dim username As String = parts(1)
        Return username
    Else
        ' The application is using custom authentication.
        Return My.User.Name
    End If
End Function