RoleManagerSection Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Web uygulamalarının rol yönetimi altyapısını desteklemek için kullanılan yapılandırma ayarlarını tanımlar. Bu sınıf devralınamaz.
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
- Devralma
Örnekler
Bu bölümde iki kod örneği verilmiştir. birincisi, sınıfın çeşitli özellikleri RoleManagerSection için değerlerin nasıl bildirim temelli olarak belirtileceğini gösterir. İkincisi, türün RoleManagerSection nasıl kullanılacağını gösterir.
Aşağıdaki yapılandırma dosyası örneği, sınıfın çeşitli özellikleri RoleManagerSection için değerlerin nasıl bildirim temelli olarak belirtileceğini gösterir.
<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>
Aşağıdaki kod örneğinde türün nasıl kullanılacağı gösterilmektedir RoleManagerSection .
#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
Açıklamalar
sınıfı, RoleManagerSection yapılandırma dosyasının bölümünün içeriğine program aracılığıyla erişmek ve içeriği roleManager
değiştirmek için bir yol sağlar.
Oluşturucular
RoleManagerSection() |
Varsayılan ayarları kullanarak sınıfın RoleManagerSection yeni bir örneğini başlatır. |
Özellikler
CacheRolesInCookie |
Geçerli kullanıcının rollerinin bir tanımlama bilgisinde önbelleğe alınıp alınmadığını belirten bir değer alır veya ayarlar. |
CookieName |
Rol adlarını önbelleğe almak için kullanılan tanımlama bilgisinin adını alır veya ayarlar. |
CookiePath |
Rol adlarını önbelleğe almak için kullanılan tanımlama bilgisinin sanal yolunu alır veya ayarlar. |
CookieProtection |
Rol adlarını önbelleğe alan tanımlama bilgisini korumak için kullanılan güvenlik türünü alır veya ayarlar. |
CookieRequireSSL |
Rol adlarını önbelleğe almak için kullanılan tanımlama bilgisinin sunucuya döndürülmesi için Güvenli Yuva Katmanı (SSL) bağlantısı gerekip gerekmediğini belirten bir değer alır veya ayarlar. |
CookieSlidingExpiration |
Rol adlarını önbelleğe almak için kullanılan tanımlama bilgisinin düzenli aralıklarla sıfırlanıp sıfırlanmayacağını belirten bir değer alır veya ayarlar. |
CookieTimeout |
Rol adlarını önbelleğe almak için kullanılan tanımlama bilgisinin süresi dolmadan önce geçmesi gereken dakika sayısını alır veya ayarlar. |
CreatePersistentCookie |
Rol adlarını önbelleğe almak için oturum tabanlı tanımlama bilgisinin mi yoksa kalıcı tanımlama bilgisinin mi kullanıldığını gösterir. |
CurrentConfiguration |
Geçerli ConfigurationElement örneğin ait olduğu yapılandırma hiyerarşisini temsil eden en üst düzey Configuration örneğe başvuru alır. (Devralındığı yer: ConfigurationElement) |
DefaultProvider |
Rolleri yönetmek için kullanılan varsayılan sağlayıcının adını alır veya ayarlar. |
Domain |
Rol adlarını önbelleğe almak için kullanılan tanımlama bilgisi ile ilişkili etki alanının adını alır veya ayarlar. |
ElementInformation |
Özelleştirilebilir olmayan bilgileri ve nesnenin işlevselliğini ConfigurationElement içeren bir ElementInformation nesnesi alır. (Devralındığı yer: ConfigurationElement) |
ElementProperty |
Nesnenin ConfigurationElementProperty kendisini temsil ConfigurationElement eden nesneyi alır. (Devralındığı yer: ConfigurationElement) |
Enabled |
ASP.NET rol yönetimi özelliğinin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar. |
EvaluationContext |
Nesnenin ContextInformation nesnesini ConfigurationElement alır. (Devralındığı yer: ConfigurationElement) |
HasContext |
özelliğinin |
Item[ConfigurationProperty] |
Bu yapılandırma öğesinin bir özelliğini veya özniteliğini alır veya ayarlar. (Devralındığı yer: ConfigurationElement) |
Item[String] |
Bu yapılandırma öğesinin bir özelliğini, özniteliğini veya alt öğesini alır veya ayarlar. (Devralındığı yer: ConfigurationElement) |
LockAllAttributesExcept |
Kilitli özniteliklerin koleksiyonunu alır. (Devralındığı yer: ConfigurationElement) |
LockAllElementsExcept |
Kilitli öğeler koleksiyonunu alır. (Devralındığı yer: ConfigurationElement) |
LockAttributes |
Kilitli özniteliklerin koleksiyonunu alır. (Devralındığı yer: ConfigurationElement) |
LockElements |
Kilitli öğeler koleksiyonunu alır. (Devralındığı yer: ConfigurationElement) |
LockItem |
Öğesinin kilitli olup olmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: ConfigurationElement) |
MaxCachedResults |
Rol tanımlama bilgisinde önbelleğe ASP.NET rol sayısı üst sınırını alır veya ayarlar. |
Properties |
Özellik koleksiyonunu alır. (Devralındığı yer: ConfigurationElement) |
Providers |
Öğelerin nesnesini ProviderSettingsCollectionProviderSettings alır. |
SectionInformation |
Özelleştirilebilir olmayan bilgileri ve nesnenin işlevselliğini ConfigurationSection içeren bir SectionInformation nesnesi alır. (Devralındığı yer: ConfigurationSection) |
Yöntemler
DeserializeElement(XmlReader, Boolean) |
Yapılandırma dosyasından XML okur. (Devralındığı yer: ConfigurationElement) |
DeserializeSection(XmlReader) |
Yapılandırma dosyasından XML okur. (Devralındığı yer: ConfigurationSection) |
Equals(Object) |
Geçerli ConfigurationElement örneği belirtilen nesneyle karşılaştırır. (Devralındığı yer: ConfigurationElement) |
GetHashCode() |
Geçerli ConfigurationElement örneği temsil eden benzersiz bir değer alır. (Devralındığı yer: ConfigurationElement) |
GetRuntimeObject() |
Türetilmiş bir sınıfta geçersiz kılındığında özel bir nesne döndürür. (Devralındığı yer: ConfigurationSection) |
GetTransformedAssemblyString(String) |
Belirtilen derleme adının dönüştürülmüş sürümünü döndürür. (Devralındığı yer: ConfigurationElement) |
GetTransformedTypeString(String) |
Belirtilen tür adının dönüştürülmüş sürümünü döndürür. (Devralındığı yer: ConfigurationElement) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
Init() |
ConfigurationElement Nesneyi başlangıç durumuna ayarlar. (Devralındığı yer: ConfigurationElement) |
InitializeDefault() |
Nesne için varsayılan değer kümesini başlatmak için ConfigurationElement kullanılır. (Devralındığı yer: ConfigurationElement) |
IsModified() |
Bu yapılandırma öğesinin türetilmiş bir sınıfta uygulandığında son kaydedildiğinden veya yüklendiğinden bu yana değiştirilip değiştirilmediğini gösterir. (Devralındığı yer: ConfigurationSection) |
IsReadOnly() |
Nesnenin ConfigurationElement salt okunur olup olmadığını belirten bir değer alır. (Devralındığı yer: ConfigurationElement) |
ListErrors(IList) |
Bu ConfigurationElement nesnedeki ve tüm alt öğelerdeki invalid-property hatalarını geçirilen listeye ekler. (Devralındığı yer: ConfigurationElement) |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
OnDeserializeUnrecognizedAttribute(String, String) |
Seri durumdan çıkarma sırasında bilinmeyen bir öznitelikle karşılaşılıp karşılaşılmadığını belirten bir değer alır. (Devralındığı yer: ConfigurationElement) |
OnDeserializeUnrecognizedElement(String, XmlReader) |
Seri durumdan çıkarma sırasında bilinmeyen bir öğeyle karşılaşılıp karşılaşılmadığını belirten bir değer alır. (Devralındığı yer: ConfigurationElement) |
OnRequiredPropertyNotFound(String) |
Gerekli bir özellik bulunamadığında bir özel durum oluşturur. (Devralındığı yer: ConfigurationElement) |
PostDeserialize() |
Seri durumdan çıkarıldıktan sonra çağrılır. (Devralındığı yer: ConfigurationElement) |
PreSerialize(XmlWriter) |
Serileştirmeden önce çağrılır. (Devralındığı yer: ConfigurationElement) |
Reset(ConfigurationElement) |
Kilitler ve özellikler koleksiyonları dahil olmak üzere nesnenin iç durumunu ConfigurationElement sıfırlar. (Devralındığı yer: ConfigurationElement) |
ResetModified() |
Türetilmiş bir sınıfta uygulandığında yönteminin IsModified() |
SerializeElement(XmlWriter, Boolean) |
Türetilmiş bir sınıfta uygulandığında bu yapılandırma öğesinin içeriğini yapılandırma dosyasına yazar. (Devralındığı yer: ConfigurationElement) |
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Bir dosyaya yazmak için tek bir bölüm olarak nesnenin ConfigurationSection birleştirilmemiş bir görünümünü içeren bir XML dizesi oluşturur. (Devralındığı yer: ConfigurationSection) |
SerializeToXmlElement(XmlWriter, String) |
Türetilmiş bir sınıfta uygulandığında bu yapılandırma öğesinin dış etiketlerini yapılandırma dosyasına yazar. (Devralındığı yer: ConfigurationElement) |
SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Belirtilen değere bir özellik ayarlar. (Devralındığı yer: ConfigurationElement) |
SetReadOnly() |
Nesnesinin IsReadOnly() ve tüm alt öğelerinin ConfigurationElement özelliğini ayarlar. (Devralındığı yer: ConfigurationElement) |
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
.NET Framework'ün belirtilen hedef sürümü için yapılandırma nesnesi hiyerarşisi seri hale getirildiğinde belirtilen öğenin seri hale getirilip getirilmeyeceğini gösterir. (Devralındığı yer: ConfigurationSection) |
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
.NET Framework'ün belirtilen hedef sürümü için yapılandırma nesnesi hiyerarşisi seri hale getirildiğinde belirtilen özelliğin seri hale getirilip getirilmeyeceğini gösterir. (Devralındığı yer: ConfigurationSection) |
ShouldSerializeSectionInTargetVersion(FrameworkName) |
.NET Framework'ün belirtilen hedef sürümü için yapılandırma nesnesi hiyerarşisi seri hale getirildiğinde geçerli ConfigurationSection örneğin seri hale getirilip getirilmeyeceğini gösterir. (Devralındığı yer: ConfigurationSection) |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
ConfigurationElement Kaydedilmemesi gereken tüm değerleri kaldırmak için nesnesini değiştirir. (Devralındığı yer: ConfigurationElement) |