ProtectedConfigurationSection Class
Assembly: System.Configuration (in system.configuration.dll)
'Declaration Public NotInheritable Class ProtectedConfigurationSection Inherits ConfigurationSection 'Usage Dim instance As ProtectedConfigurationSection
public final class ProtectedConfigurationSection extends ConfigurationSection
public final class ProtectedConfigurationSection extends ConfigurationSection
Not applicable.
The configProtectedData configuration file section contains a collection of protected data providers in its providers element.
Note: |
|---|
| You can use the Aspnet_regiis.exe tool to encrypt and decrypt configuration sections. See Encrypting Configuration Information Using Protected Configuration. |
The following configuration file excerpt shows how to declaratively specify protected data providers.
<configProtectedData defaultProvider="RsaProtectedConfigurationProvider">
<providers>
<clear />
<add keyContainerName="NetFrameworkConfigurationKey" cspProviderName="" useMachineContainer="true" useOAEP="false" description="Uses RsaCryptoServiceProvider to encrypt and decrypt" name="RsaProtectedConfigurationProvider" type="System.Configuration.RsaProtectedConfigurationProvider,System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
<add useMachineProtection="true" description="Uses CryptProtectData and CryptUnProtectData Windows APIs to encrypt and decrypt" keyEntropy="" name="DataProtectionConfigurationProvider" type="System.Configuration.DpapiProtectedConfigurationProvider,System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</providers>
</configProtectedData>
The following code example shows how to use the ProtectedConfigurationSection class to programmatically access values in the configProtectedData configuration file section.
Imports System Imports System.IO Imports System.Configuration ' Shows how to use ProtectedConfigurationSection. Class UsingProtectedConfigurationSection Shared Sub GetDefaultProvider() Try ' Get the application configuration. Dim config As Configuration = _ ConfigurationManager.OpenExeConfiguration( _ ConfigurationUserLevel.None) ' Get the protected configuration section. Dim pcSection _ As ProtectedConfigurationSection = _ CType(config.GetSection( _ "configProtectedData"), _ System.Configuration.ProtectedConfigurationSection) ' Get the current DefaultProvider. Console.WriteLine( _ "Protected configuration section default provider:") Console.WriteLine("{0}", _ pcSection.DefaultProvider) Catch e As ConfigurationErrorsException Console.WriteLine(e.ToString()) End Try End Sub 'GetDefaultProvider Shared Sub GetProviderCollection() Try ' Get the application configuration. Dim config As Configuration = _ ConfigurationManager.OpenExeConfiguration( _ ConfigurationUserLevel.None) ' Get the protected configuration section. Dim pcSection _ As ProtectedConfigurationSection = _ CType(config.GetSection( _ "configProtectedData"), _ System.Configuration.ProtectedConfigurationSection) Console.WriteLine( _ "Protected configuration section providers:") Dim ps As ProviderSettings For Each ps In pcSection.Providers Console.WriteLine(" {0}", ps.Name) Next ps Catch e As ConfigurationErrorsException Console.WriteLine(e.ToString()) End Try End Sub 'GetProviderCollection Public Shared Sub Main() GetDefaultProvider() GetProviderCollection() End Sub 'Main End Class 'UsingProtectedConfigurationSection
System.Configuration.ConfigurationElement
System.Configuration.ConfigurationSection
System.Configuration.ProtectedConfigurationSection
Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.Reference
ProtectedConfigurationSection MembersSystem.Configuration Namespace
ProtectedConfiguration
ProtectedConfigurationProvider
ProtectedConfigurationProviderCollection
ProtectedProviderSettings
Other Resources
Cryptographic ServicesEncrypting Configuration Information Using Protected Configuration
Walkthrough: Encrypting Configuration Information Using Protected Configuration
Note: