Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase RoleManagerSection

 

Publicado: octubre de 2016

Define opciones de configuración que se utilizan para admitir la infraestructura de administración de funciones de aplicaciones Web. Esta clase no puede heredarse.

Espacio de nombres:   System.Web.Configuration
Ensamblado:  System.Web (en System.Web.dll)

System.Object
  System.Configuration.ConfigurationElement
    System.Configuration.ConfigurationSection
      System.Web.Configuration.RoleManagerSection

public sealed class RoleManagerSection : ConfigurationSection

NombreDescripción
System_CAPS_pubmethodRoleManagerSection()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de la clase RoleManagerSection utilizando las opciones predeterminadas.

NombreDescripción
System_CAPS_pubpropertyCacheRolesInCookie

Obtiene o establece un valor que indica si las funciones del usuario actual se almacenan provisionalmente en una cookie.

System_CAPS_pubpropertyCookieName

Obtiene o establece el nombre de la cookie que se usa en memoria caché los nombres de función.

System_CAPS_pubpropertyCookiePath

Obtiene o establece la ruta de acceso virtual de la cookie que se utiliza para almacenar en caché los nombres de función.

System_CAPS_pubpropertyCookieProtection

Obtiene o establece el tipo de seguridad que se utiliza para proteger la cookie que almacena en caché los nombres de función.

System_CAPS_pubpropertyCookieRequireSSL

Obtiene o establece un valor que indica si la cookie que se utiliza para la memoria caché los nombres de función requiere una conexión de capa de Sockets seguros (SSL) para que se devuelva al servidor.

System_CAPS_pubpropertyCookieSlidingExpiration

Obtiene o establece un valor que indica si la cookie que se utiliza para almacenar en caché los nombres de función se restablece periódicamente.

System_CAPS_pubpropertyCookieTimeout

Obtiene o establece el número de minutos antes de que expire la cookie que se utiliza para la memoria caché los nombres de función.

System_CAPS_pubpropertyCreatePersistentCookie

Indica si se utiliza una cookie basada en sesión o una cookie persistente para almacenar en caché los nombres de función.

System_CAPS_pubpropertyCurrentConfiguration

Obtiene una referencia al nivel superior Configuration instancia que representa la jerarquía de configuración que actual ConfigurationElement pertenece la instancia.(Heredado de ConfigurationElement).

System_CAPS_pubpropertyDefaultProvider

Obtiene o establece el nombre del proveedor predeterminado que se usa para administrar roles.

System_CAPS_pubpropertyDomain

Obtiene o establece el nombre del dominio al que está asociado a la cookie que se utiliza para almacenar en caché los nombres de función.

System_CAPS_pubpropertyElementInformation

Obtiene un ElementInformation objeto que contiene la información no personalizable y la funcionalidad de la ConfigurationElement objeto.(Heredado de ConfigurationElement).

System_CAPS_protpropertyElementProperty

Obtiene el ConfigurationElementProperty objeto que representa el ConfigurationElement propio objeto.(Heredado de ConfigurationElement).

System_CAPS_pubpropertyEnabled

Obtiene o establece un valor que indica si está habilitada la función de administración de funciones de ASP.NET.

System_CAPS_protpropertyItem[ConfigurationProperty]

Obtiene o establece una propiedad o atributo de este elemento de configuración.(Heredado de ConfigurationElement).

System_CAPS_protpropertyItem[String]

Obtiene o establece una propiedad, atributo o elemento secundario de este elemento de configuración.(Heredado de ConfigurationElement).

System_CAPS_pubpropertyLockAllAttributesExcept

Obtiene la colección de atributos bloqueados.(Heredado de ConfigurationElement).

System_CAPS_pubpropertyLockAllElementsExcept

Obtiene la colección de elementos bloqueados.(Heredado de ConfigurationElement).

System_CAPS_pubpropertyLockAttributes

Obtiene la colección de atributos bloqueados (Heredado de ConfigurationElement).

System_CAPS_pubpropertyLockElements

Obtiene la colección de elementos bloqueados.(Heredado de ConfigurationElement).

System_CAPS_pubpropertyLockItem

Obtiene o establece un valor que indica si el elemento está bloqueado.(Heredado de ConfigurationElement).

System_CAPS_pubpropertyMaxCachedResults

Obtiene o establece el número máximo de funciones que ASP.NET almacena en caché en la cookie de funciones.

System_CAPS_protpropertyProperties

Obtiene la colección de propiedades.(Heredado de ConfigurationElement).

System_CAPS_pubpropertyProviders

Obtiene un ProviderSettingsCollection objetos de ProviderSettings elementos.

System_CAPS_pubpropertySectionInformation

Obtiene un SectionInformation objeto que contiene la información no personalizable y la funcionalidad de la ConfigurationSection objeto.(Heredado de ConfigurationSection).

NombreDescripción
System_CAPS_protmethodDeserializeElement(XmlReader, Boolean)

Lee XML del archivo de configuración.(Heredado de ConfigurationElement).

System_CAPS_protmethodDeserializeSection(XmlReader)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Lee XML del archivo de configuración.(Heredado de ConfigurationSection).

System_CAPS_pubmethodEquals(Object)

Compara actual ConfigurationElement instancia con el objeto especificado.(Heredado de ConfigurationElement).

System_CAPS_pubmethodGetHashCode()

Obtiene un valor único que representa la actual ConfigurationElement instancia.(Heredado de ConfigurationElement).

System_CAPS_protmethodGetRuntimeObject()

Devuelve un objeto personalizado cuando se invalida en una clase derivada.(Heredado de ConfigurationSection).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodInit()

Establece la ConfigurationElement objeto a su estado inicial.(Heredado de ConfigurationElement).

System_CAPS_protmethodInitializeDefault()

Utilizado para inicializar un conjunto predeterminado de valores para el ConfigurationElement objeto.(Heredado de ConfigurationElement).

System_CAPS_protmethodIsModified()

Indica si se ha modificado este elemento de configuración desde su última guarda o carga cuando se implementa en una clase derivada.(Heredado de ConfigurationSection).

System_CAPS_pubmethodIsReadOnly()

Obtiene un valor que indica si el objeto ConfigurationElement es de solo lectura.(Heredado de ConfigurationElement).

System_CAPS_protmethodReset(ConfigurationElement)

Restablece el estado interno del objeto ConfigurationElement, incluyendo los bloqueos y las colecciones de propiedades.(Heredado de ConfigurationElement).

System_CAPS_protmethodResetModified()

Restablece el valor del método IsModified en false cuando se implementa en una clase derivada.(Heredado de ConfigurationSection).

System_CAPS_protmethodSerializeElement(XmlWriter, Boolean)

Escribe el contenido de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada.(Heredado de ConfigurationElement).

System_CAPS_protmethodSerializeSection(ConfigurationElement, String, ConfigurationSaveMode)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Crea una cadena XML que contiene una vista separada de la ConfigurationSection objeto como una sección única para escribir en un archivo.(Heredado de ConfigurationSection).

System_CAPS_protmethodSerializeToXmlElement(XmlWriter, String)

Escribe las etiquetas externas de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada.(Heredado de ConfigurationElement).

System_CAPS_protmethodSetReadOnly()

Establece el IsReadOnly propiedad para la ConfigurationElement objeto y todos los subelementos.(Heredado de ConfigurationElement).

System_CAPS_protmethodShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)

Indica si se debe serializar el elemento especificado cuando se serializa la jerarquía de objetos de configuración para la versión de destino especificado de la .NET Framework.(Heredado de ConfigurationSection).

System_CAPS_protmethodShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)

Indica si se debe serializar la propiedad especificada cuando se serializa la jerarquía de objetos de configuración para la versión de destino especificado de la .NET Framework.(Heredado de ConfigurationSection).

System_CAPS_protmethodShouldSerializeSectionInTargetVersion(FrameworkName)

Indica si el actual ConfigurationSection se debe serializar la instancia cuando se serializa la jerarquía de objetos de configuración para la versión de destino especificado de la .NET Framework.(Heredado de ConfigurationSection).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

System_CAPS_protmethodUnmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Modifica la ConfigurationElement objeto que se va a quitar todos los valores que no deben guardarse.(Heredado de ConfigurationElement).

La RoleManagerSection clase proporciona una manera de obtener acceso mediante programación y modificar el contenido de la roleManager sección del archivo de configuración.

Esta sección proporciona dos ejemplos de código. El primero muestra cómo especificar mediante declaración los valores para varias propiedades de la RoleManagerSection clase. El segundo ejemplo muestra cómo utilizar el RoleManagerSection tipo.

El siguiente ejemplo de archivo de configuración muestra cómo especificar mediante declaración los valores para varias propiedades de la RoleManagerSection clase.

<system.web>
  <roleManager 
    enabled="false" 
    cacheRolesInCookie="false" 
    cookieName=".ASPXROLES" cookieTimeout="30"
    cookiePath="/" cookieRequireSSL="false"
    cookieSlidingExpiration="true" createPersistentCookie="false"
    cookieProtection="All" 
    defaultProvider="AspNetSqlRoleProvider"
    maxCachedResults="25"  >
    <providers>
      <add 
        name="AspNetSqlRoleProvider"
        connectionStringName="LocalSqlServer" 
        applicationName="/"
        type="System.Web.Security.SqlRoleProvider, System.Web,
          Version=2.0.3600.0, Culture=neutral,
          PublicKeyToken=b03f5f7f11d50a3a" />
      <add 
        name="AspNetWindowsTokenRoleProvider" 
        applicationName="/"
        type="System.Web.Security.WindowsTokenRoleProvider, System.Web, 
          Version=2.0.3600.0, Culture=neutral, 
          PublicKeyToken=b03f5f7f11d50a3a" />
    </providers>
  </roleManager>
</system.web>

En el ejemplo de código siguiente se muestra cómo utilizar el RoleManagerSection tipo.

#region Using directives

using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;
using System.Web;
using System.Web.Configuration;

#endregion

namespace Samples.Aspnet.SystemWebConfiguration
{
  class UsingRoleManagerSection
  {
    static void Main(string[] args)
    {
      try
      {
        // Set the path of the config file.
        string configPath = "";

        // Get the Web application configuration object.
        Configuration config = WebConfigurationManager.OpenWebConfiguration(configPath);

        // Get the section related object.
        RoleManagerSection configSection =
          (RoleManagerSection)config.GetSection("system.web/roleManager");

        // Display title and info.
        Console.WriteLine("ASP.NET Configuration Info");
        Console.WriteLine();

        // Display Config details.
        Console.WriteLine("File Path: {0}",
          config.FilePath);
        Console.WriteLine("Section Path: {0}",
          configSection.SectionInformation.Name);

        // Display CacheRolesInCookie property.
        Console.WriteLine("CacheRolesInCookie: {0}",
          configSection.CacheRolesInCookie);

        // Set CacheRolesInCookie property.
        configSection.CacheRolesInCookie = false;

        // Display CookieName property.
        Console.WriteLine("CookieName: {0}", configSection.CookieName);

        // Set CookieName property.
        configSection.CookieName = ".ASPXROLES";

        // Display CookiePath property.
        Console.WriteLine("CookiePath: {0}", configSection.CookiePath);

        // Set CookiePath property.
        configSection.CookiePath = "/";

        // Display CookieProtection property.
        Console.WriteLine("CookieProtection: {0}",
          configSection.CookieProtection);

        // Set CookieProtection property.
        configSection.CookieProtection =
          System.Web.Security.CookieProtection.All;

        // Display CookieRequireSSL property.
        Console.WriteLine("CookieRequireSSL: {0}",
          configSection.CookieRequireSSL);

        // Set CookieRequireSSL property.
        configSection.CookieRequireSSL = false;

        // Display CookieSlidingExpiration property.
        Console.WriteLine("CookieSlidingExpiration: {0}",
          configSection.CookieSlidingExpiration);

        // Set CookieSlidingExpiration property.
        configSection.CookieSlidingExpiration = true;

        // Display CookieTimeout property.
        Console.WriteLine("CookieTimeout: {0}", configSection.CookieTimeout);

        // Set CookieTimeout property.
        configSection.CookieTimeout = TimeSpan.FromMinutes(30);

        // Display CreatePersistentCookie property.
        Console.WriteLine("CreatePersistentCookie: {0}",
          configSection.CreatePersistentCookie);

        // Set CreatePersistentCookie property.
        configSection.CreatePersistentCookie = false;

        // Display DefaultProvider property.
        Console.WriteLine("DefaultProvider: {0}",
          configSection.DefaultProvider);

        // Set DefaultProvider property.
        configSection.DefaultProvider = "AspNetSqlRoleProvider";

        // Display Domain property.
        Console.WriteLine("Domain: {0}", configSection.Domain);

        // Set Domain property.
        configSection.Domain = "";

        // Display Enabled property.
        Console.WriteLine("Enabled: {0}", configSection.Enabled);

        // Set Enabled property.
        configSection.Enabled = false;

        // Display the number of Providers
        Console.WriteLine("Providers Collection Count: {0}",
          configSection.Providers.Count);

        // Display elements of the Providers collection property.
        foreach (ProviderSettings providerItem in configSection.Providers)
        {
          Console.WriteLine();
          Console.WriteLine("Provider Details:");
          Console.WriteLine("Name: {0}", providerItem.Name);
          Console.WriteLine("Type: {0}", providerItem.Type);
        }

        // Update if not locked.
        if (!configSection.SectionInformation.IsLocked)
        {
          config.Save();
          Console.WriteLine("** Configuration updated.");
        }
        else
        {
          Console.WriteLine("** Could not update, section is locked.");
        }
      }

      catch (Exception e)
      {
        // Unknown error.
        Console.WriteLine(e.ToString());
      }

      // Display and wait
      Console.ReadLine();
    }
  }
}

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: