SectionInformation.ProtectSection(String) Method

public:
 void ProtectSection(System::String ^ protectionProvider);

public void ProtectSection(string protectionProvider);

member this.ProtectSection : string -> unit

Public Sub ProtectSection (protectionProvider As String)

Parameters

Exceptions

Examples

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

Public Shared Sub ProtectSection() 
 
 ' Get the current configuration file.
 Dim config _
 As System.Configuration.Configuration = _
 ConfigurationManager.OpenExeConfiguration( _
 ConfigurationUserLevel.None)

 
 ' Get the section.
 Dim section As UrlsSection = _
 CType(config.GetSection("MyUrls"), UrlsSection)
 
 
 ' 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.
 Dim sectionXml As String = _
 section.SectionInformation.GetRawXml()
 
 Console.WriteLine("Decrypted section:")
 Console.WriteLine(sectionXml)

End Sub

Remarks

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:

DpapiProtectedConfigurationProvider

RsaProtectedConfigurationProvider

For more information about protected configuration sections, see Encrypting Configuration Information Using Protected Configuration.

See also

• DpapiProtectedConfigurationProvider
• RsaProtectedConfigurationProvider
• Encrypting Configuration Information Using Protected Configuration