User.CurrentPrincipal Eigenschaft
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.
Dient zum Abrufen oder Festlegen des aktuellen Prinzipals (für rollenbasierte Sicherheit).
public:
property System::Security::Principal::IPrincipal ^ CurrentPrincipal { System::Security::Principal::IPrincipal ^ get(); void set(System::Security::Principal::IPrincipal ^ value); };
public System.Security.Principal.IPrincipal CurrentPrincipal { get; set; }
member this.CurrentPrincipal : System.Security.Principal.IPrincipal with get, set
Public Property CurrentPrincipal As IPrincipal
Eigenschaftswert
Ein IPrincipal Wert, der den Sicherheitskontext darstellt.
Ausnahmen
Der Aufrufer verfügt nicht über die zum Festlegen des Prinzipals erforderliche Berechtigung.
Beispiele
In diesem Beispiel wird überprüft, ob die Anwendung Windows oder benutzerdefinierte Authentifizierung verwendet und diese Informationen verwendet, um 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
Sie können die My.User.CurrentPrincipal Eigenschaft auf ein Objekt festlegen, das die Schnittstelle implementiert, um die IPrincipal benutzerdefinierte Authentifizierung zu aktivieren.
In den meisten Projekttypen ruft diese Eigenschaft den aktuellen Prinzipal des Threads ab und legt sie fest. In einer ASP.NET Anwendung ruft diese Eigenschaft die Sicherheitsinformationen für die Benutzeridentität der aktuellen HTTP-Anforderung ab und legt sie fest.
Dies ist ein erweitertes Mitglied; Sie wird in IntelliSense nur angezeigt, wenn Sie auf die Registerkarte "Alle " klicken.
Verfügbarkeit nach Projekttyp
| Projekttyp | Available |
|---|---|
| Windows-Anwendung | Ja |
| Klassenbibliothek | Ja |
| Konsolenanwendung | Ja |
| Windows-Steuerelementbibliothek | Ja |
| Websteuerelementbibliothek | Ja |
| Windows-Dienst | Ja |
| Website | Ja |