SectionInformation.ProtectSection(String) Método

Definición

Marca una sección de configuración para la protección.Marks a configuration section for protection.

public:
 void ProtectSection(System::String ^ protectionProvider);
public:
 void ProtectSection(System::String ^ provider);
public void ProtectSection (string protectionProvider);
public void ProtectSection (string provider);
member this.ProtectSection : string -> unit
member this.ProtectSection : string -> unit
Public Sub ProtectSection (protectionProvider As String)
Public Sub ProtectSection (provider As String)

Parámetros

protectionProviderprovider
String

Nombre del proveedor de protección que se va a usar.The name of the protection provider to use.

Excepciones

La propiedad AllowLocation se establece en false.The AllowLocation property is set to false.

O bien,-or- La sección de destino ya es una sección de datos protegidos.The target section is already a protected data section.

Ejemplos

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

Comentarios

El método ProtectSection marca la sección para el cifrado, por lo que se escribirá en formato cifrado en el disco.The ProtectSection method marks the section for encryption so it will be written in encrypted form on disk.

De forma predeterminada, se incluyen los siguientes proveedores de protección:The following protection providers are included by default:

DpapiProtectedConfigurationProvider

RsaProtectedConfigurationProvider

Nota

Si llama al método ProtectSection con un parámetro null o una cadena vacía, se usa la clase RsaProtectedConfigurationProvider como proveedor de protección.If you call the ProtectSection method with a null parameter or an empty string, the RsaProtectedConfigurationProvider class is used as the protection provider.

Para obtener más información sobre las secciones de configuración protegida, vea cifrar información de configuración mediante la configuración protegida.For more information about protected configuration sections, see Encrypting Configuration Information Using Protected Configuration.

Se aplica a

Consulte también: