User.CurrentPrincipal Eigenschaft

Definition

Ruft den aktuellen Prinzipal (für rollenbasierte Sicherheit) ab oder legt diesen fest.

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 erforderliche Berechtigung zum Festlegen des Prinzipals.

Beispiele

In diesem Beispiel wird überprüft, ob die Anwendung windows- oder benutzerdefinierte Authentifizierung verwendet, und verwendet diese Informationen, um die Eigenschaft zu analysieren My.User.Name .

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 diesen 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 Element. Es wird in IntelliSense nur angezeigt, wenn Sie auf die Registerkarte Alle klicken.

Verfügbarkeit nach Projekttyp

Projekttyp Verfügbar
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Ja
Windows-Dienst Ja
Website Ja

Gilt für:

Weitere Informationen