SectionInformation.UnprotectSection Method

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Package:

System.Configuration.ConfigurationManager v9.0.0-rc.2.24473.5

Source:

SectionInformation.cs

Removes the protected configuration encryption from the associated configuration section.

public:
 void UnprotectSection();

public void UnprotectSection ();

member this.UnprotectSection : unit -> unit

Public Sub UnprotectSection ()

Examples

The following example shows how to use this method.

static public void UnProtectSection()
{

    // Get the current configuration file.
    System.Configuration.Configuration config =
            ConfigurationManager.OpenExeConfiguration(
            ConfigurationUserLevel.None);

    // Get the section.
    UrlsSection section =
        (UrlsSection)config.GetSection("MyUrls");

    // Unprotect (decrypt)the section.
    section.SectionInformation.UnprotectSection();

    // Force the section information to be written to
    // the configuration file.
    section.SectionInformation.ForceDeclaration(true);

    // Save the decrypted section.
    section.SectionInformation.ForceSave = true;

    config.Save(ConfigurationSaveMode.Full);

    // Display the decrypted configuration 
    // section. 
    string sectionXml =
        section.SectionInformation.GetRawXml();

    Console.WriteLine("Decrypted section:");
    Console.WriteLine(sectionXml);
}

Public Shared Sub UnProtectSection() 
    
    ' 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)
    
    ' Unprotect (decrypt)the section.
    section.SectionInformation.UnprotectSection()
    
    ' Force the section information to be written to
    ' the configuration file.
    section.SectionInformation.ForceDeclaration(True)

    ' Save the decrypted section.
    section.SectionInformation.ForceSave = True
    
    config.Save(ConfigurationSaveMode.Full)
    
    ' Display the decrypted configuration 
    ' section. 
    Dim sectionXml As String = _
    section.SectionInformation.GetRawXml()
    
    Console.WriteLine("Decrypted section:")
    Console.WriteLine(sectionXml)

End Sub

Remarks

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

See also

• Encrypting Configuration Information Using Protected Configuration