SectionInformation.ProtectSection(String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 poskytovatele ochrany, který se má použít.
Výjimky
Vlastnost AllowLocation je nastavena na hodnotu false
.
-nebo-
Cílový oddíl už je chráněným datovým oddílem.
Příklady
Následující příklad ukazuje, jak používat 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 disk.
Ve výchozím nastavení jsou zahrnuti 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 jako zprostředkovatel ochrany se použije třída .
Další informace o oddílech chráněné konfigurace najdete v tématu Šifrování informací o konfiguraci pomocí chráněné konfigurace.