RoleManagerSection Klasa

Definicja

Namespace:: System.Web.Configuration

Montaż:: System.Web.dll

Ważny

Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.

Definiuje ustawienia konfiguracji używane do obsługi infrastruktury zarządzania rolami aplikacji internetowych. Klasa ta nie może być dziedziczona.

public ref class RoleManagerSection sealed : System::Configuration::ConfigurationSection

public sealed class RoleManagerSection : System.Configuration.ConfigurationSection

type RoleManagerSection = class
    inherit ConfigurationSection

Public NotInheritable Class RoleManagerSection
Inherits ConfigurationSection

Dziedziczenie: Object

ConfigurationElement

ConfigurationSection
RoleManagerSection

Przykłady

Ta sekcja zawiera dwa przykłady kodu. Pierwszy demonstruje sposób deklaratywnego określania wartości dla kilku właściwości RoleManagerSection klasy. Drugi pokazuje, jak używać RoleManagerSection typu.

Poniższy przykładowy plik konfiguracji przedstawia sposób deklaratywnego określania wartości dla kilku właściwości RoleManagerSection klasy.

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

W poniższym przykładzie kodu pokazano, jak używać RoleManagerSection typu.

#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();
    }
  }
}

Imports System.Collections.Generic
Imports System.Text
Imports System.Configuration
Imports System.Web
Imports System.Web.Configuration

Namespace Samples.Aspnet.SystemWebConfiguration
  Class UsingRoleManagerSection
    Public Shared Sub Main()
      Try
        ' Set the path of the config file.
        Dim configPath As String = ""

        ' Get the Web application configuration object.
        Dim config As System.Configuration.Configuration = _
         System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration(configPath)

        ' Get the section related object.
        Dim configSection As System.Web.Configuration.RoleManagerSection = _
         CType(config.GetSection("system.web/roleManager"), _
         System.Web.Configuration.RoleManagerSection)

        ' 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 CookieName 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.
        For Each providerItem As ProviderSettings In configSection.Providers()
          Console.WriteLine()
          Console.WriteLine("Provider Details:")
          Console.WriteLine("Name: {0}", providerItem.Name)
          Console.WriteLine("Type: {0}", providerItem.Type)
        Next

        ' Update if not locked.
        If Not configSection.SectionInformation.IsLocked Then
          config.Save()
          Console.WriteLine("** Configuration updated.")
        Else
          Console.WriteLine("** Could not update, section is locked.")
        End If

      Catch e As Exception
        ' Unknown error.
        Console.WriteLine(e.ToString())
      End Try

      ' Display and wait
      Console.ReadLine()
    End Sub
  End Class
End Namespace

Uwagi

Klasa RoleManagerSection umożliwia programowy dostęp i modyfikowanie zawartości roleManager sekcji pliku konfiguracji.

Konstruktorów

Nazwa	Opis
RoleManagerSection()	Inicjuje RoleManagerSection nowe wystąpienie klasy przy użyciu ustawień domyślnych.

Właściwości

Nazwa	Opis
CacheRolesInCookie	Pobiera lub ustawia wartość wskazującą, czy role bieżącego użytkownika są buforowane w pliku cookie.
CookieName	Pobiera lub ustawia nazwę pliku cookie używanego do buforowania nazw ról.
CookiePath	Pobiera lub ustawia wirtualną ścieżkę pliku cookie używanego do buforowania nazw ról.
CookieProtection	Pobiera lub ustawia typ zabezpieczeń używany do ochrony pliku cookie, który buforuje nazwy ról.
CookieRequireSSL	Pobiera lub ustawia wartość wskazującą, czy plik cookie używany do buforowania nazw ról wymaga połączenia Secure Sockets Layer (SSL) w celu zwrócenia go do serwera.
CookieSlidingExpiration	Pobiera lub ustawia wartość wskazującą, czy plik cookie używany do buforowania nazw ról będzie okresowo resetowany.
CookieTimeout	Pobiera lub ustawia liczbę minut przed wygaśnięciem plików cookie używanych do buforowania nazw ról.
CreatePersistentCookie	Wskazuje, czy plik cookie oparty na sesji, czy trwały plik cookie jest używany do buforowania nazw ról.
CurrentConfiguration	Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration reprezentującego hierarchię konfiguracji, do którego należy bieżące ConfigurationElement wystąpienie. (Dziedziczone od ConfigurationElement)
DefaultProvider	Pobiera lub ustawia nazwę domyślnego dostawcy używanego do zarządzania rolami.
Domain	Pobiera lub ustawia nazwę domeny skojarzonej z plikiem cookie używanym do buforowania nazw ról.
ElementInformation	ElementInformation Pobiera obiekt, który zawiera informacje i funkcje ConfigurationElement obiektu, które nie można dostosowywać. (Dziedziczone od ConfigurationElement)
ElementProperty	ConfigurationElementProperty Pobiera obiekt reprezentujący ConfigurationElement sam obiekt. (Dziedziczone od ConfigurationElement)
Enabled	Pobiera lub ustawia wartość wskazującą, czy funkcja zarządzania rolami ASP.NET jest włączona.
EvaluationContext	ContextInformation Pobiera obiekt dla ConfigurationElement obiektu. (Dziedziczone od ConfigurationElement)
HasContext	Pobiera wartość wskazującą CurrentConfiguration , czy właściwość ma wartość `null`. (Dziedziczone od ConfigurationElement)
Item[ConfigurationProperty]	Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji. (Dziedziczone od ConfigurationElement)
Item[String]	Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji. (Dziedziczone od ConfigurationElement)
LockAllAttributesExcept	Pobiera kolekcję zablokowanych atrybutów. (Dziedziczone od ConfigurationElement)
LockAllElementsExcept	Pobiera kolekcję zablokowanych elementów. (Dziedziczone od ConfigurationElement)
LockAttributes	Pobiera kolekcję zablokowanych atrybutów. (Dziedziczone od ConfigurationElement)
LockElements	Pobiera kolekcję zablokowanych elementów. (Dziedziczone od ConfigurationElement)
LockItem	Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany. (Dziedziczone od ConfigurationElement)
MaxCachedResults	Pobiera lub ustawia maksymalną liczbę ról, które ASP.NET pamięci podręcznej w pliku cookie roli.
Properties	Pobiera kolekcję właściwości. (Dziedziczone od ConfigurationElement)
Providers	ProviderSettingsCollection Pobiera obiekt ProviderSettings elementów.
SectionInformation	SectionInformation Pobiera obiekt, który zawiera informacje i funkcje ConfigurationSection obiektu, które nie można dostosowywać. (Dziedziczone od ConfigurationSection)

Metody

Nazwa	Opis
DeserializeElement(XmlReader, Boolean)	Odczytuje kod XML z pliku konfiguracji. (Dziedziczone od ConfigurationElement)
DeserializeSection(XmlReader)	Odczytuje kod XML z pliku konfiguracji. (Dziedziczone od ConfigurationSection)
Equals(Object)	Porównuje bieżące ConfigurationElement wystąpienie z określonym obiektem. (Dziedziczone od ConfigurationElement)
GetHashCode()	Pobiera unikatową wartość reprezentującą bieżące ConfigurationElement wystąpienie. (Dziedziczone od ConfigurationElement)
GetRuntimeObject()	Zwraca obiekt niestandardowy, gdy zostanie zastąpiony w klasie pochodnej. (Dziedziczone od ConfigurationSection)
GetTransformedAssemblyString(String)	Zwraca przekształconą wersję określonej nazwy zestawu. (Dziedziczone od ConfigurationElement)
GetTransformedTypeString(String)	Zwraca przekształconą wersję określonej nazwy typu. (Dziedziczone od ConfigurationElement)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Dziedziczone od Object)
Init()	ConfigurationElement Ustawia obiekt na stan początkowy. (Dziedziczone od ConfigurationElement)
InitializeDefault()	Służy do inicjowania domyślnego zestawu wartości dla ConfigurationElement obiektu. (Dziedziczone od ConfigurationElement)
IsModified()	Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania lub załadowania podczas implementacji w klasie pochodnej. (Dziedziczone od ConfigurationSection)
IsReadOnly()	Pobiera wartość wskazującą, czy ConfigurationElement obiekt jest tylko do odczytu. (Dziedziczone od ConfigurationElement)
ListErrors(IList)	Dodaje błędy nieprawidłowej właściwości w tym ConfigurationElement obiekcie i we wszystkich podelementach do przekazanej listy. (Dziedziczone od ConfigurationElement)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
OnDeserializeUnrecognizedAttribute(String, String)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut. (Dziedziczone od ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany element. (Dziedziczone od ConfigurationElement)
OnRequiredPropertyNotFound(String)	Zgłasza wyjątek, gdy nie można odnaleźć wymaganej właściwości. (Dziedziczone od ConfigurationElement)
PostDeserialize()	Wywoływana po deserializacji. (Dziedziczone od ConfigurationElement)
PreSerialize(XmlWriter)	Wywoływana przed serializacji. (Dziedziczone od ConfigurationElement)
Reset(ConfigurationElement)	Resetuje stan ConfigurationElement wewnętrzny obiektu, w tym blokady i kolekcje właściwości. (Dziedziczone od ConfigurationElement)
ResetModified()	Resetuje wartość IsModified() metody w `false` przypadku implementacji w klasie pochodnej. (Dziedziczone od ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	Zapisuje zawartość tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Dziedziczone od ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	Tworzy ciąg XML zawierający nieskonwergentny widok ConfigurationSection obiektu jako pojedynczą sekcję do zapisu w pliku. (Dziedziczone od ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	Zapisuje zewnętrzne tagi tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Dziedziczone od ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Ustawia właściwość na określoną wartość. (Dziedziczone od ConfigurationElement)
SetReadOnly()	IsReadOnly() Ustawia właściwość dla ConfigurationElement obiektu i wszystkich podelementów. (Dziedziczone od ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	Wskazuje, czy określony element powinien być serializowany, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej programu .NET Framework. (Dziedziczone od ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	Wskazuje, czy określona właściwość powinna być serializowana, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej programu .NET Framework. (Dziedziczone od ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	Wskazuje, czy bieżące ConfigurationSection wystąpienie powinno być serializowane, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej programu .NET Framework. (Dziedziczone od ConfigurationSection)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Dziedziczone od Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modyfikuje obiekt w ConfigurationElement celu usunięcia wszystkich wartości, które nie powinny być zapisywane. (Dziedziczone od ConfigurationElement)

Dotyczy

Zobacz także

Sprzężenie zwrotne

Czy ta strona była pomocna?