Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

PrincipalPermissionAttribute (Clase)

Permite aplicar acciones de seguridad para PrincipalPermission en el código mediante el uso de la seguridad declarativa. Esta clase no puede heredarse.

Espacio de nombres:  System.Security.Permissions
Ensamblado:  mscorlib (en mscorlib.dll)

[SerializableAttribute]
[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method, AllowMultiple = true, 
	Inherited = false)]
[ComVisibleAttribute(true)]
public sealed class PrincipalPermissionAttribute : CodeAccessSecurityAttribute

El tipo PrincipalPermissionAttribute expone los siguientes miembros.

  NombreDescripción
Método públicoPrincipalPermissionAttributeInicializa una nueva instancia de la clase PrincipalPermissionAttribute con el objeto SecurityAction especificado.
Arriba

  NombreDescripción
Propiedad públicaActionObtiene o establece una acción de seguridad. (Se hereda de SecurityAttribute).
Propiedad públicaAuthenticatedObtiene o establece un valor que indica si el proveedor de seguridad según el rol subyacente autenticó la entidad de seguridad actual.
Propiedad públicaNameObtiene o establece el nombre de la identidad asociada al valor de la entidad de seguridad actual.
Propiedad públicaRoleObtiene o establece la pertenencia a un rol de seguridad específico.
Propiedad públicaTypeIdCuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Se hereda de Attribute).
Propiedad públicaUnrestrictedObtiene o establece un valor que indica si se declara el permiso completo (sin restricciones) al recurso protegido por el atributo. (Se hereda de SecurityAttribute).
Arriba

  NombreDescripción
Método públicoCreatePermissionCrea y devuelve un nuevo objeto PrincipalPermission. (Invalida a SecurityAttribute.CreatePermission()).
Método públicoEqualsInfraestructura. Devuelve un valor que indica si esta instancia equivale al objeto especificado. (Se hereda de Attribute).
Método públicoGetHashCodeDevuelve el código hash de esta instancia. (Se hereda de Attribute).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoIsDefaultAttributeCuando se invalida en una clase derivada, indica si el valor de esta instancia es el valor predeterminado para la clase derivada. (Se hereda de Attribute).
Método públicoMatch Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Se hereda de Attribute).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privado_Attribute.GetIDsOfNamesAsigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoObtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoCount

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.InvokeProporciona acceso a las propiedades y los métodos expuestos por un objeto. (Se hereda de Attribute).
Arriba

Es posible utilizar PrincipalPermissionAttribute para solicitar de forma declarativa que los usuarios que ejecutan el código pertenezcan a un rol determinado o se hayan autenticado. El uso de Unrestricted crea PrincipalPermission con Authenticated establecido en true y Name y Role establecidos en null.

El ámbito permitido de la declaración depende del SecurityAction utilizado. PrincipalPermissionAttribute no se puede aplicar en el nivel de ensamblado.

La información de seguridad declarada por un atributo de seguridad se almacena en los metadatos del destino del atributo y el sistema obtiene acceso a él en tiempo de ejecución. Los atributos de seguridad sólo se utilizan para la seguridad declarativa. Para obtener una seguridad imperativa, utilice la clase de permiso correspondiente.

Nota importanteImportante

Antes de utilizar esta clase para exigir el permiso principal, debe establecer la directiva del entidad de seguridad del dominio de aplicación actual en el valor de enumeración WindowsPrincipal. De forma predeterminada, la directiva de la entidad de seguridad se establece en UnauthenticatedPrincipal. Si no se establece la directiva de la entidad de seguridad en WindowsPrincipal, la petición de permiso de la entidad de seguridad dará un error. Antes de que se produzca la petición, debería ejecutarse el siguiente código: AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal).

El siguiente ejemplo muestra cómo se utiliza la clase PrincipalPermissionAttribute mediante declaración para exigir que el usuario actual sea un administrador.

NotaNota

En Windows Vista, el Control de cuentas de usuario (UAC) determina los privilegios de un usuario. Si es miembro del grupo Administradores integrados, se le asignarán dos símbolos (tokens) de acceso en tiempo de ejecución: un símbolo (token) de acceso de usuario estándar y un símbolo (token) de acceso de administrador. De forma predeterminada, se le asignará el rol de usuario estándar. Para poder ejecutar código que requiera que el usuario sea un administrador, primero deberá elevar el nivel de sus privilegios de usuario estándar a los de administrador. Podrá hacerlo cuando inicie una aplicación haciendo clic con el botón secundario en el icono de la aplicación e indicando que desea ejecutarla como administrador.


using System;
using System.Threading;
using System.Security.Permissions;
using System.Security.Principal;

class SecurityPrincipalDemo
{
    public static void Main()
    {
        try
        {
            // PrincipalPolicy must be set to WindowsPrincipal to check roles.
            AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal);
            // Check using the PrincipalPermissionAttribute
            CheckAdministrator();
            // Check using PrincipalPermission class.
            PrincipalPermission principalPerm = new PrincipalPermission(null, "Administrators");
            principalPerm.Demand();
            Console.WriteLine("Demand succeeded.");
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
    }
    [PrincipalPermission(SecurityAction.Demand, Role = "Administrators")]
    static void CheckAdministrator()
    {
        Console.WriteLine("User is an administrator");
    }
}


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft