User.CurrentPrincipal Eigenschaft

  • Referenz

Definition

Namespace:
Microsoft.VisualBasic.ApplicationServices
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.dll

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

IPrincipal

Ein IPrincipal-Wert, der den Sicherheitskontext darstellt.

Ausnahmen

SecurityException

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 diese Informationen zum Analysieren My.User.Name der Eigenschaft verwendet.

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 Eigenschaft auf ein Objekt festlegen, das die My.User.CurrentPrincipal IPrincipal Schnittstelle implementiert, um die benutzerdefinierte Authentifizierung zu aktivieren.

In den meisten Projekttypen ruft diese Eigenschaft ab und legt den aktuellen Prinzipal des Threads 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; es wird nicht in IntelliSense angezeigt, es sei denn, Sie klicken auf die Registerkarte "Alle ".

Verfügbarkeit nach Project Typ

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

Gilt für:

Siehe auch