SectionInformation.ProtectSection Method
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Marks a configuration section for protection.
Namespace: System.Configuration
Assembly: System.Configuration (in System.Configuration.dll)
| Exception | Condition |
|---|---|
| InvalidOperationException |
The AllowLocation property is set to false. - or - The target section is already a protected data section. |
The ProtectSection method marks the section for encryption so it will be written in encrypted form on disk.
The following protection providers are included by default:
System.Configuration.DPAPIProtectedConfigurationProvider
System.Configuration.RSAProtectedConfigurationProvider
Note
|
|---|
|
If you call the ProtectSection method with a null parameter or an empty string, the System.Configuration.RSAProtectedConfigurationProvider class is used as the protection provider. |
For more information about protected configuration sections, see Encrypting Configuration Information Using Protected Configuration.
The following example shows how to use the ProtectSection method.
static public void ProtectSection() { // Get the current configuration file. System.Configuration.Configuration config = ConfigurationManager.OpenExeConfiguration( ConfigurationUserLevel.None); // Get the section. UrlsSection section = (UrlsSection)config.GetSection("MyUrls"); // Protect (encrypt)the section. section.SectionInformation.ProtectSection( "RsaProtectedConfigurationProvider"); // Save the encrypted section. section.SectionInformation.ForceSave = true; config.Save(ConfigurationSaveMode.Full); // Display decrypted configuration // section. Note, the system // uses the Rsa provider to decrypt // the section transparently. string sectionXml = section.SectionInformation.GetRawXml(); Console.WriteLine("Decrypted section:"); Console.WriteLine(sectionXml); }
Windows 8 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Note