My.User-Objekt

Artikel
09/03/2008

Aktualisiert: November 2007

Ermöglicht den Zugriff auf die Informationen über den aktuellen Benutzer.

Hinweise

Die Eigenschaften und die Methoden, die vom My.User-Objekt verfügbar gemacht werden, ermöglichen den Zugriff auf die Informationen über den aktuellen Benutzer. Die Bedeutung von "aktueller Benutzer" unterscheidet sich in Windows- und Webanwendungen geringfügig. In einer Windows-Anwendung ist der aktuelle Benutzer der Benutzer, der die Anwendung ausführt. In einer Webanwendung ist der aktuelle Benutzer der Benutzer, der auf die Anwendung zugreift.

Die My.User-Eigenschaft ermöglicht auch den Zugriff auf den IPrincipal für den aktuellen Benutzer. Ein Prinzipalobjekt stellt den Sicherheitskontext des Benutzers dar, einschließlich der Identität des Benutzers und der Rollen, die der ggf. Benutzer innehat.

Für Windows-Anwendungen bietet diese Eigenschaft die gleiche Funktionalität wie die CurrentPrincipal-Eigenschaft. Für Webanwendungen bietet diese Eigenschaft ähnliche Funktionalität wie die User-Eigenschaft des von der Current-Eigenschaft zurückgegebenen Objekts.

Hinweis:
In Windows-Anwendungen initialisieren nur anhand der Vorlage Windows-Anwendung erstellte Projekte standardmäßig das My.User-Objekt. Bei allen anderen Windows-Projekttypen müssen Sie das My.User-Objekt initialisieren, indem Sie explizit die My.User.InitializeWithWindowsUser-Methode aufrufen oder CurrentPrincipal einen Wert zuweisen.

Hinweis:
Das My.User-Objekt kann keine Informationen über den aktuellen Windows-Benutzer angeben, wenn die Ausführung unter Windows 95 oder Windows 98 erfolgt, weil diese Betriebssysteme das Konzept eines angemeldeten Benutzers nicht unterstützen. Sie müssen benutzerdefinierte Authentifizierung implementieren, um das My.User-Objekt unter diesen Betriebssystemen verwenden zu können. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Implementieren von benutzerdefinierter Authentifizierung und Autorisierung.

Das My.User-Objekt kann keine Informationen über den aktuellen Windows-Benutzer angeben, wenn die Ausführung unter Windows 95 oder Windows 98 erfolgt, weil diese Betriebssysteme das Konzept eines angemeldeten Benutzers nicht unterstützen. Sie müssen benutzerdefinierte Authentifizierung implementieren, um das My.User-Objekt unter diesen Betriebssystemen verwenden zu können. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Implementieren von benutzerdefinierter Authentifizierung und Autorisierung.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit dem My.User-Objekt aufgeführt.

Zweck	Weitere Informationen finden Sie unter
Abrufen des Benutzernamens des Benutzers	Gewusst wie: Bestimmen des Benutzernamens eines Benutzers
Abrufen des Domänennamens des Benutzers, wenn die Anwendung Windows-Authentifizierung verwendet	Gewusst wie: Bestimmen der Domäne des Benutzers
Bestimmen der Rolle des Benutzers	Gewusst wie: Ermitteln, ob ein Benutzer einer Gruppe angehört
Implementieren benutzerdefinierter Authentifizierung	Exemplarische Vorgehensweise: Implementieren von benutzerdefinierter Authentifizierung und Autorisierung

Beispiel

In diesem Beispiel wird überprüft, ob die Anwendung Windows-Authentifizierung oder benutzerdefinierte Authentifizierung verwendet, und anhand dieser Informationen wird die My.User.Name-Eigenschaft analysiert.

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