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.

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

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

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Referenz