SectionInformation.ProtectSection(String) Método

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Marca una sección de configuración para la protección.

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

public void ProtectSection (string protectionProvider);

member this.ProtectSection : string -> unit

Public Sub ProtectSection (protectionProvider As String)

Parámetros

protectionProvider

String

Nombre del proveedor de protección que se va a usar.

Excepciones

InvalidOperationException

La propiedad AllowLocation se establece en false.

o bien

La sección de destino ya es una sección de datos protegidos.

Ejemplos

En el siguiente ejemplo, se muestra cómo utilizar el método 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

Comentarios

El ProtectSection método marca la sección para el cifrado, por lo que se escribirá en forma cifrada en el disco.

Los siguientes proveedores de protección se incluyen de forma predeterminada:

DpapiProtectedConfigurationProvider

RsaProtectedConfigurationProvider

Nota

Si llama al ProtectSection método con un null parámetro o una cadena vacía, la RsaProtectedConfigurationProvider clase se usa como proveedor de protección.

Para obtener más información sobre las secciones de configuración protegida, consulte Cifrado de información de configuración mediante la configuración protegida.

Consulte también

• DpapiProtectedConfigurationProvider
• RsaProtectedConfigurationProvider
• Cifrar información de configuración mediante una configuración protegida