User.CurrentPrincipal Eigenschaft

Referenz

Definition

Namespace:: Microsoft.VisualBasic.ApplicationServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

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.

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 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:

Freigeben über