Freigeben über


User Klasse

Definition

Stellt den Zugriff auf die Informationen über den aktuellen Benutzer bereit.

public ref class User
public class User
type User = class
Public Class User
Vererbung
User
Abgeleitet

Beispiele

In diesem Beispiel wird überprüft, ob die Anwendung Windows oder die benutzerdefinierte Authentifizierung verwendet, und verwendet diese Informationen, um die My.User.Name Eigenschaft zu analysieren.

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

Hinweise

Die vom -Objekt verfügbar gemachten My.User Eigenschaften und Methoden ermöglichen den Zugriff auf die Informationen über den aktuellen Benutzer. Die Bedeutung von "aktueller Benutzer" unterscheidet sich geringfügig zwischen Windows- und Webanwendungen. 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 bietet auch zugriff auf den IPrincipal für den aktuellen Benutzer. Ein Prinzipalobjekt stellt den Sicherheitskontext des Benutzers dar, einschließlich der Identität dieses Benutzers und aller Rollen, zu denen der Benutzer gehört.

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

Hinweis

Für Windows-Anwendungen initialisieren standardmäßig nur Projekte, die auf der Vorlage Windows-AnwendungMy.User basieren. In allen anderen Windows-Projekttypen müssen Sie das My.User -Objekt initialisieren, indem Sie die InitializeWithWindowsUser -Methode explizit aufrufen oder einen Wert zuweisen.CurrentPrincipal

Konstruktoren

User()

Initialisiert eine neue Instanz der User-Klasse.

Eigenschaften

CurrentPrincipal

Ruft den aktuellen Prinzipal (für rollenbasierte Sicherheit) ab oder legt diesen fest.

InternalPrincipal

Ruft das Prinzipalobjekt ab, das den aktuellen Benutzer darstellt, oder legt dieses fest.

IsAuthenticated

Ruft einen Wert ab, der angibt, ob der Benutzer authentifiziert wurde.

Name

Ruft den Namen des aktuellen Benutzers ab.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeWithWindowsUser()

Legt den aktuellen Prinzipal des Threads auf den Windows-Benutzer fest, der die Anwendung gestartet hat.

IsInRole(BuiltInRole)

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.

IsInRole(String)

Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen