User Třída

Definice

Obor názvů:

Microsoft.VisualBasic.ApplicationServices

Sestavení:

Microsoft.VisualBasic.Forms.dll

Zdroj:

User.vb

Poskytuje přístup k informacím o aktuálním uživateli.

public ref class User

public class User

type User = class

Public Class User

Dědičnost

Object

User

Odvozené

Microsoft.VisualBasic.ApplicationServices.WebUser

Příklady

Tento příklad zkontroluje, jestli aplikace používá windows nebo vlastní ověřování, a používá tyto informace k analýze My.User.Name vlastnosti.

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

Poznámky

Vlastnosti a metody vystavené objektem My.User poskytují přístup k informacím o aktuálním uživateli. Význam "aktuálního uživatele" se mírně liší mezi Windows a webovými aplikacemi. V aplikaci pro Windows je aktuálním uživatelem uživatel, který aplikaci spouští. Ve webové aplikaci je aktuálním uživatelem uživatel, který k aplikaci přistupuje.

Vlastnost My.User také poskytuje přístup k aktuálnímu IPrincipal uživateli. Objekt zabezpečení představuje kontext zabezpečení uživatele, včetně identity daného uživatele a všech rolí, ke kterým uživatel patří.

U aplikací pro Windows tato vlastnost poskytuje stejné funkce jako CurrentPrincipal vlastnost. U webových aplikací tato vlastnost poskytuje stejné funkce jako User vlastnost objektu vráceného Current vlastností.

Poznámka:

V případě aplikací pro Windows inicializují My.User objekt ve výchozím nastavení pouze projekty založené na šabloně aplikace systému Windows. Ve všech ostatních typech projektů systému Windows je nutné inicializovat My.User objekt voláním InitializeWithWindowsUser metody explicitně nebo přiřazením hodnoty .CurrentPrincipal

Konstruktory

Name	Description
User()	Inicializuje novou instanci User třídy.

Vlastnosti

Name	Description
CurrentPrincipal	Získá nebo nastaví aktuální objekt zabezpečení (pro zabezpečení na základě role).
InternalPrincipal	Získá nebo nastaví objekt instanční objekt představující aktuálního uživatele.
IsAuthenticated	Získá hodnotu, která označuje, zda byl uživatel ověřen.
Name	Získá jméno aktuálního uživatele.

Metody

Name	Description
IsInRole(String)	Určuje, zda aktuální uživatel patří do zadané role.

Viz také

• IPrincipal
• CurrentPrincipal
• User
• Current
• Objekty (Visual Basic)