SectionInformation.ProtectSection(String) Metodo

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

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

Origine:

SectionInformation.cs

Contrassegna una sezione di configurazione per la protezione.

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

public void ProtectSection (string protectionProvider);

member this.ProtectSection : string -> unit

Public Sub ProtectSection (protectionProvider As String)

Parametri

protectionProvider

String

Nome del provider di protezione da usare.

Eccezioni

InvalidOperationException

La proprietà AllowLocation è impostata su false.

-oppure-

La sezione di destinazione è già una sezione di dati protetta.

Esempio

Nell'esempio seguente viene illustrato come utilizzare il metodo 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

Commenti

Il ProtectSection metodo contrassegna la sezione per la crittografia in modo che venga scritta in formato crittografato su disco.

Per impostazione predefinita, sono inclusi i provider di protezione seguenti:

DpapiProtectedConfigurationProvider

RsaProtectedConfigurationProvider

Nota

Se si chiama il ProtectSection metodo con un null parametro o una stringa vuota, la RsaProtectedConfigurationProvider classe viene usata come provider di protezione.

Per altre informazioni sulle sezioni di configurazione protetta, vedere Crittografia delle informazioni di configurazione tramite la configurazione protetta.

Vedi anche

• DpapiProtectedConfigurationProvider
• RsaProtectedConfigurationProvider
• Crittografia delle informazioni di configurazione tramite la configurazione protetta