User Klasse

Referenz

Definition

Namespace:: Microsoft.VisualBasic.ApplicationServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object
User

Abgeleitet: Microsoft.VisualBasic.ApplicationServices.WebUser

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:

Freigeben über