SectionInformation.ProtectSection(String) Metoda

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Zdroj:

SectionInformation.cs

Označí oddíl konfigurace pro ochranu.

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

public void ProtectSection(string protectionProvider);

member this.ProtectSection : string -> unit

Public Sub ProtectSection (protectionProvider As String)

Parametry

protectionProvider

String

Název zprostředkovatele ochrany, který se má použít.

Výjimky

InvalidOperationException

Vlastnost AllowLocation je nastavena na hodnotu false.

nebo

Cílový oddíl už je chráněným oddílem dat.

Příklady

Následující příklad ukazuje, jak použít metodu ProtectSection .

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

Poznámky

Metoda ProtectSection označí oddíl pro šifrování, takže se zapíše v šifrované podobě na disku.

Ve výchozím nastavení jsou zahrnuté následující zprostředkovatelé ochrany:

DpapiProtectedConfigurationProvider

RsaProtectedConfigurationProvider

Poznámka:

Pokud voláte metodu ProtectSection s parametrem null nebo prázdným řetězcem, RsaProtectedConfigurationProvider třída se použije jako zprostředkovatel ochrany.

Viz také

• DpapiProtectedConfigurationProvider
• RsaProtectedConfigurationProvider