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.
Bietet Zugriff auf die Informationen über den aktuellen Benutzer.
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 eine benutzerdefinierte Authentifizierung verwendet und diese Informationen verwendet, 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 Eigenschaften und Methoden, die vom My.User Objekt verfügbar gemacht werden, bieten 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 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 stellt diese Eigenschaft die gleiche Funktionalität wie die CurrentPrincipal Eigenschaft bereit. Bei Webanwendungen stellt diese Eigenschaft die gleiche Funktionalität wie die User Eigenschaft des objekts bereit, das von der Current Eigenschaft zurückgegeben wird.
Hinweis
Bei Windows-Anwendungen initialisieren My.User standardmäßig nur Projekte, die auf der Vorlage "Windows-Anwendung" basieren. In allen anderen Windows-Projekttypen müssen Sie das My.User Objekt initialisieren, indem Sie die InitializeWithWindowsUser Methode explizit aufrufen oder einen Wert CurrentPrincipalzuweisen.
Konstruktoren
| Name | Beschreibung |
|---|---|
| WebUser() |
Initialisiert eine neue Instanz der WebUser-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CurrentPrincipal |
Dient zum Abrufen oder Festlegen des aktuellen Prinzipals (für rollenbasierte Sicherheit). (Geerbt von User) |
| InternalPrincipal |
Dient zum Abrufen oder Festlegen des Prinzipalobjekts, das den aktuellen Benutzer darstellt. |
| 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
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die 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 der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
