MembershipSection Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Definuje nastavení konfigurace pro podporu infrastruktury pro konfiguraci a správu podrobností o členství. Tuto třídu nelze zdědit.
public ref class MembershipSection sealed : System::Configuration::ConfigurationSectionpublic sealed class MembershipSection : System.Configuration.ConfigurationSectiontype MembershipSection = class
inherit ConfigurationSectionPublic NotInheritable Class MembershipSection
Inherits ConfigurationSection- Dědičnost
Příklady
Tento příklad ukazuje, jak zadat hodnoty deklarativní pro několik atributů oddílu membership , ke kterým lze přistupovat také jako členové MembershipSection třídy.
Následující příklad konfiguračního souboru ukazuje, jak zadat hodnoty deklarativním způsobem pro membership oddíl.
<system.web>
<membership
defaultProvider="AspNetSqlMembershipProvider"
userIsOnlineTimeWindow="15">
<providers>
<add
name=" AspNetSqlMembershipProvider"
type="System.Web.Security.SqlMembershipProvider, System.Web,
Version=2.0.3600.0, Culture=neutral,
PublicKeyToken=b03f5f7f11d50a3a"
connectionStringName="LocalSqlServer"
passwordAttemptThreshold="5"
passwordAttemptWindow="10"
enablePasswordRetrieval="false"
enablePasswordReset="true"
requiresQuestionAndAnswer="true"
applicationName="/"
requiresUniqueEmail="false"
passwordFormat="Hashed"
description="Stores and retrieves membership data from
the local Microsoft SQL Server database."
/>
</providers>
</membership>
</system.web>
Následující příklad kódu ukazuje, jak používat MembershipSection třídu.
#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 UsingMembershipSection
{
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.
MembershipSection configSection =
(MembershipSection)config.GetSection("system.web/membership");
// 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 Default Provider.
Console.WriteLine("DefaultProvider: {0}",
configSection.DefaultProvider);
// Set Default Provider.
configSection.DefaultProvider =
"AspNetSqlRoleProvider";
// Display HashAlgorithmType value.
Console.WriteLine("HashAlgorithmType: {0}",
configSection.HashAlgorithmType);
// Set HashAlgorithmType value.
configSection.HashAlgorithmType =
MachineKeyValidation.HMACSHA256.ToString();
// Display UserIsOnlineTimeWindow value.
Console.WriteLine("UserIsOnlineTimeWindow: {0}",
configSection.UserIsOnlineTimeWindow);
// Set UserIsOnlineTimeWindow value.
configSection.UserIsOnlineTimeWindow =
TimeSpan.FromMinutes(15) ;
// 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 UsingMembershipSection
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.MembershipSection = _
CType(config.GetSection("system.web/membership"), _
System.Web.Configuration.MembershipSection)
' 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 Default Provider.
Console.WriteLine("DefaultProvider: {0}", _
configSection.DefaultProvider)
' Set Default Provider.
configSection.DefaultProvider = _
"AspNetSqlRoleProvider"
' Display HashAlgorithmType value.
Console.WriteLine("HashAlgorithmType: {0}", _
configSection.HashAlgorithmType)
' Set HashAlgorithmType value.
configSection.HashAlgorithmType = _
MachineKeyValidation.HMACSHA256.ToString()
' Display UserIsOnlineTimeWindow value.
Console.WriteLine("UserIsOnlineTimeWindow: {0}", _
configSection.UserIsOnlineTimeWindow)
' Set UserIsOnlineTimeWindow value.
configSection.UserIsOnlineTimeWindow = _
TimeSpan.FromMinutes(15)
' 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
Poznámky
Třída MembershipSection poskytuje způsob, jak programově přistupovat a upravovat membership oddíl v konfiguračním souboru.
Konstruktory
| MembershipSection() |
Inicializuje novou instanci MembershipSection třídy. |
Vlastnosti
| CurrentConfiguration |
Získá odkaz na instanci nejvyšší úrovně Configuration , která představuje hierarchii konfigurace, do které aktuální ConfigurationElement instance patří. (Zděděno od ConfigurationElement) |
| DefaultProvider |
Získá nebo nastaví název výchozího zprostředkovatele, který se používá ke správě rolí. |
| ElementInformation |
ElementInformation Získá objekt, který obsahuje neuzpůsobitelné informace a funkce objektuConfigurationElement. (Zděděno od ConfigurationElement) |
| ElementProperty |
ConfigurationElementProperty Získá objekt, který představuje ConfigurationElement samotný objekt. (Zděděno od ConfigurationElement) |
| EvaluationContext |
ContextInformation Získá objekt objektuConfigurationElement. (Zděděno od ConfigurationElement) |
| HasContext |
Získá hodnotu, která označuje, zda CurrentConfiguration je |
| HashAlgorithmType |
Získá nebo nastaví typ šifrování, který se používá pro citlivé informace členství. |
| Item[ConfigurationProperty] |
Získá nebo nastaví vlastnost nebo atribut tohoto konfiguračního prvku. (Zděděno od ConfigurationElement) |
| Item[String] |
Získá nebo nastaví vlastnost, atribut nebo podřízený prvek tohoto konfiguračního prvku. (Zděděno od ConfigurationElement) |
| LockAllAttributesExcept |
Získá kolekci uzamčených atributů. (Zděděno od ConfigurationElement) |
| LockAllElementsExcept |
Získá kolekci uzamčených prvků. (Zděděno od ConfigurationElement) |
| LockAttributes |
Získá kolekci uzamčených atributů. (Zděděno od ConfigurationElement) |
| LockElements |
Získá kolekci uzamčených prvků. (Zděděno od ConfigurationElement) |
| LockItem |
Získá nebo nastaví hodnotu určující, zda je prvek uzamčen. (Zděděno od ConfigurationElement) |
| Properties |
Získá kolekci vlastností. (Zděděno od ConfigurationElement) |
| Providers |
ProviderSettingsCollection Získá objekt ProviderSettings objektů. |
| SectionInformation |
SectionInformation Získá objekt, který obsahuje ne přizpůsobitelné informace a funkce objektuConfigurationSection. (Zděděno od ConfigurationSection) |
| UserIsOnlineTimeWindow |
Získá nebo nastaví dobu v minutách, než se uživatel už nepovažuje za online. |
Metody
| DeserializeElement(XmlReader, Boolean) |
Načte XML z konfiguračního souboru. (Zděděno od ConfigurationElement) |
| DeserializeSection(XmlReader) |
Načte XML z konfiguračního souboru. (Zděděno od ConfigurationSection) |
| Equals(Object) |
Porovná aktuální ConfigurationElement instanci se zadaným objektem. (Zděděno od ConfigurationElement) |
| GetHashCode() |
Získá jedinečnou hodnotu představující aktuální ConfigurationElement instanci. (Zděděno od ConfigurationElement) |
| GetRuntimeObject() |
Vrátí vlastní objekt při přepsání v odvozené třídě. (Zděděno od ConfigurationSection) |
| GetTransformedAssemblyString(String) |
Vrátí transformovanou verzi zadaného názvu sestavení. (Zděděno od ConfigurationElement) |
| GetTransformedTypeString(String) |
Vrátí transformovanou verzi zadaného názvu typu. (Zděděno od ConfigurationElement) |
| GetType() |
Type Získá aktuální instanci. (Zděděno od Object) |
| Init() |
ConfigurationElement Nastaví objekt na počáteční stav. (Zděděno od ConfigurationElement) |
| InitializeDefault() |
Slouží k inicializaci výchozí sady hodnot objektu ConfigurationElement . (Zděděno od ConfigurationElement) |
| IsModified() |
Označuje, zda byl tento element konfigurace změněn od posledního uložení nebo načtení při implementaci v odvozené třídě. (Zděděno od ConfigurationSection) |
| IsReadOnly() |
Získá hodnotu určující, zda ConfigurationElement objekt je jen pro čtení. (Zděděno od ConfigurationElement) |
| ListErrors(IList) |
Přidá chyby neplatné vlastnosti v tomto ConfigurationElement objektu a ve všech dílčích počtech do předaného seznamu. (Zděděno od ConfigurationElement) |
| MemberwiseClone() |
Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Získá hodnotu označující, zda je zjištěn neznámý atribut během deserializace. (Zděděno od ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Získá hodnotu označující, zda je při deserializaci zjištěn neznámý prvek. (Zděděno od ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Vyvolá výjimku, když se nenajde požadovaná vlastnost. (Zděděno od ConfigurationElement) |
| PostDeserialize() |
Volá se po deserializaci. (Zděděno od ConfigurationElement) |
| PreSerialize(XmlWriter) |
Volá se před serializací. (Zděděno od ConfigurationElement) |
| Reset(ConfigurationElement) |
Obnoví vnitřní stav objektu ConfigurationElement , včetně zámků a kolekcí vlastností. (Zděděno od ConfigurationElement) |
| ResetModified() |
Obnoví hodnotu IsModified() metody na |
| SerializeElement(XmlWriter, Boolean) |
Zapíše obsah tohoto konfiguračního prvku do konfiguračního souboru při implementaci v odvozené třídě. (Zděděno od ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Vytvoří řetězec XML obsahující nemergované zobrazení ConfigurationSection objektu jako jeden oddíl pro zápis do souboru. (Zděděno od ConfigurationSection) |
| SerializeToXmlElement(XmlWriter, String) |
Zapíše vnější značky tohoto konfiguračního prvku do konfiguračního souboru při implementaci v odvozené třídě. (Zděděno od ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Nastaví vlastnost na zadanou hodnotu. (Zděděno od ConfigurationElement) |
| SetReadOnly() |
IsReadOnly() Nastaví vlastnost pro ConfigurationElement objekt a všechny dílčí prvky. (Zděděno od ConfigurationElement) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Určuje, zda má být zadaný prvek serializován při serializaci hierarchie objektu konfigurace pro zadanou cílovou verzi .NET Framework. (Zděděno od ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Určuje, zda má být zadaná vlastnost serializována, pokud je hierarchie objektu konfigurace serializována pro zadanou cílovou verzi .NET Framework. (Zděděno od ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Určuje, zda má být aktuální ConfigurationSection instance serializována, když je hierarchie objektu konfigurace serializována pro zadanou cílovou verzi .NET Framework. (Zděděno od ConfigurationSection) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Upraví objekt tak, ConfigurationElement aby odebral všechny hodnoty, které by neměly být uloženy. (Zděděno od ConfigurationElement) |