User Clase

Definición

Proporciona acceso a la información sobre el usuario actual.Provides access to the information about the current user.

public ref class User
public class User
type User = class
Public Class User
Herencia
User
Derivado

Ejemplos

En este ejemplo se comprueba si la aplicación usa Windows o la autenticación personalizada, y se usa esa información para analizar la My.User.Name propiedad.This example checks if the application is using Windows or custom authentication, and uses that information to parse the My.User.Name property.

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

Comentarios

Las propiedades y los métodos expuestos por el My.User objeto proporcionan acceso a la información sobre el usuario actual.The properties and methods exposed by the My.User object provide access to the information about the current user. El significado de "usuario actual" difiere ligeramente entre Windows y las aplicaciones Web.The meaning of "current user" differs slightly between Windows and Web applications. En una aplicación de Windows, el usuario actual es el usuario que ejecuta la aplicación.In a Windows application, the current user is the user who runs the application. En una aplicación Web, el usuario actual es el usuario que obtiene acceso a la aplicación.In a Web application, the current user is the user who accesses the application.

La My.User propiedad también proporciona acceso al IPrincipal para el usuario actual.The My.User property also provides access to the IPrincipal for the current user. Un objeto principal representa el contexto de seguridad del usuario, incluida la identidad del usuario y los roles a los que pertenece el usuario.A principal object represents the user's security context, including that user's identity and any roles to which the user belongs.

En el caso de las aplicaciones Windows, esta propiedad proporciona la misma funcionalidad que la CurrentPrincipal propiedad.For Windows applications, this property provides the same functionality as the CurrentPrincipal property. En el caso de las aplicaciones Web, esta propiedad proporciona la misma funcionalidad que la User propiedad del objeto devuelto por la Current propiedad.For Web applications, this property provides the same functionality as the User property of the object returned by the Current property.

Nota

En el caso de las aplicaciones Windows, solo los proyectos generados en la plantilla de aplicación de Windows inicializan el My.User objeto de forma predeterminada.For Windows applications, only projects built on the Windows Application template initialize the My.User object by default. En todos los demás tipos de proyecto de Windows, debe inicializar el My.User objeto llamando al InitializeWithWindowsUser método explícitamente o asignando un valor a CurrentPrincipal .In all other Windows project types, you must initialize the My.User object by calling the InitializeWithWindowsUser method explicitly or by assigning a value to CurrentPrincipal.

Constructores

User()

Inicializa una nueva instancia de la clase User.Initializes a new instance of the User class.

Propiedades

CurrentPrincipal

Obtiene o establece la entidad de seguridad (de la seguridad basada en roles).Gets or sets the current principal (for role-based security).

InternalPrincipal

Obtiene o establece el objeto principal que representa al usuario actual.Gets or sets the principal object representing the current user.

IsAuthenticated

Obtiene un valor que indica si el usuario se ha autenticado.Gets a value that indicates whether the user has been authenticated.

Name

Obtiene el nombre del usuario actual.Gets the name of the current user.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeWithWindowsUser()

Establece la entidad de seguridad actual del subproceso en el usuario de Windows que inició la aplicación.Sets the thread's current principal to the Windows user that started the application.

IsInRole(BuiltInRole)

Determina si el usuario actual pertenece al rol especificado.Determines whether the current user belongs to the specified role.

IsInRole(String)

Determina si el usuario actual pertenece al rol especificado.Determines whether the current user belongs to the specified role.

MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también