User.CurrentPrincipal Eigenschaft

Definition

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

Gilt für:

Weitere Informationen