WebUser Klasse
Definition
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 WebUser : Microsoft::VisualBasic::ApplicationServices::Userpublic class WebUser : Microsoft.VisualBasic.ApplicationServices.Usertype WebUser = class
inherit UserPublic Class WebUser
Inherits User- Vererbung
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
| WebUser() |
Initialisiert eine neue Instanz der WebUser-Klasse. |
Eigenschaften
| CurrentPrincipal |
Ruft den aktuellen Prinzipal (für rollenbasierte Sicherheit) ab oder legt diesen fest. (Geerbt von User) |
| 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. (Geerbt von User) |
| Name |
Ruft den Namen des aktuellen Benutzers ab. (Geerbt von User) |
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. (Geerbt von User) |
| IsInRole(BuiltInRole) |
Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört. (Geerbt von User) |
| IsInRole(String) |
Bestimmt, ob der aktuelle Benutzer zur angegebenen Rolle gehört. (Geerbt von User) |
| 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) |
