Configuration.SaveAs 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í.
Zapíše nastavení konfigurace obsažené v tomto Configuration objektu do zadaného konfiguračního souboru XML.
Přetížení
SaveAs(String) |
Zapíše nastavení konfigurace obsažené v tomto Configuration objektu do zadaného konfiguračního souboru XML. |
SaveAs(String, ConfigurationSaveMode) |
Zapíše nastavení konfigurace obsažené v tomto Configuration objektu do zadaného konfiguračního souboru XML. |
SaveAs(String, ConfigurationSaveMode, Boolean) |
Zapíše nastavení konfigurace obsažené v tomto Configuration objektu do zadaného konfiguračního souboru XML. |
SaveAs(String)
- Zdroj:
- Configuration.cs
- Zdroj:
- Configuration.cs
- Zdroj:
- Configuration.cs
Zapíše nastavení konfigurace obsažené v tomto Configuration objektu do zadaného konfiguračního souboru XML.
public:
void SaveAs(System::String ^ filename);
public void SaveAs (string filename);
member this.SaveAs : string -> unit
Public Sub SaveAs (filename As String)
Parametry
- filename
- String
Cesta a název souboru, do které chcete konfigurační soubor uložit.
Výjimky
Konfigurační soubor nelze zapsat do.
-nebo-
Konfigurační soubor se změnil.
Poznámky
Metoda SaveAs zachová všechna nastavení konfigurace, která byla změněna od vytvoření tohoto Configuration objektu, do nového souboru.
Pokud konfigurační soubor neexistuje ve fyzickém umístění představované
FilePath vytvoří se nový konfigurační soubor, který bude obsahovat všechna nastavení, která se liší od zděděné konfigurace.
Pokud se konfigurační soubor od vytvoření tohoto Configuration objektu změnil, dojde k chybě za běhu.
Platí pro
SaveAs(String, ConfigurationSaveMode)
- Zdroj:
- Configuration.cs
- Zdroj:
- Configuration.cs
- Zdroj:
- Configuration.cs
Zapíše nastavení konfigurace obsažené v tomto Configuration objektu do zadaného konfiguračního souboru XML.
public:
void SaveAs(System::String ^ filename, System::Configuration::ConfigurationSaveMode saveMode);
public void SaveAs (string filename, System.Configuration.ConfigurationSaveMode saveMode);
member this.SaveAs : string * System.Configuration.ConfigurationSaveMode -> unit
Public Sub SaveAs (filename As String, saveMode As ConfigurationSaveMode)
Parametry
- filename
- String
Cesta a název souboru, do které chcete konfigurační soubor uložit.
- saveMode
- ConfigurationSaveMode
Hodnota ConfigurationSaveMode , která určuje, které hodnoty vlastností se mají uložit.
Výjimky
Konfigurační soubor nelze zapsat do.
-nebo-
Konfigurační soubor se změnil.
Poznámky
Metoda SaveAs zachová nastavení konfigurace v objektu Configuration do nového souboru na základě parametru saveMode
.
Pokud konfigurační soubor neexistuje ve fyzickém umístění reprezentované FilePath vlastností, vytvoří se nový konfigurační soubor, který bude obsahovat všechna nastavení, která se liší od zděděné konfigurace.
Pokud se konfigurační soubor od vytvoření tohoto Configuration objektu změnil, dojde k chybě za běhu.
Platí pro
SaveAs(String, ConfigurationSaveMode, Boolean)
- Zdroj:
- Configuration.cs
- Zdroj:
- Configuration.cs
- Zdroj:
- Configuration.cs
Zapíše nastavení konfigurace obsažené v tomto Configuration objektu do zadaného konfiguračního souboru XML.
public:
void SaveAs(System::String ^ filename, System::Configuration::ConfigurationSaveMode saveMode, bool forceSaveAll);
public void SaveAs (string filename, System.Configuration.ConfigurationSaveMode saveMode, bool forceSaveAll);
member this.SaveAs : string * System.Configuration.ConfigurationSaveMode * bool -> unit
Public Sub SaveAs (filename As String, saveMode As ConfigurationSaveMode, forceSaveAll As Boolean)
Parametry
- filename
- String
Cesta a název souboru, do které chcete konfigurační soubor uložit.
- saveMode
- ConfigurationSaveMode
Hodnota ConfigurationSaveMode , která určuje, které hodnoty vlastností se mají uložit.
- forceSaveAll
- Boolean
true
uložit i v případě, že konfigurace nebyla změněna; v opačném případě . false
Výjimky
filename
je null nebo prázdný řetězec ("").
Příklady
Následující příklad kódu ukazuje, jak použít metodu SaveAs .
// Show how to use different modalities to save
// a configuration file.
static void SaveConfigurationFile()
{
try
{
// Get the current configuration file.
System.Configuration.Configuration config =
ConfigurationManager.OpenExeConfiguration(
ConfigurationUserLevel.None) as Configuration;
// Save the full configuration file and force save even if the file was not modified.
config.SaveAs("MyConfigFull.config", ConfigurationSaveMode.Full, true);
Console.WriteLine("Saved config file as MyConfigFull.config using the mode: {0}",
ConfigurationSaveMode.Full.ToString());
config =
ConfigurationManager.OpenExeConfiguration(
ConfigurationUserLevel.None) as Configuration;
// Save only the part of the configuration file that was modified.
config.SaveAs("MyConfigModified.config", ConfigurationSaveMode.Modified, true);
Console.WriteLine("Saved config file as MyConfigModified.config using the mode: {0}",
ConfigurationSaveMode.Modified.ToString());
config =
ConfigurationManager.OpenExeConfiguration(
ConfigurationUserLevel.None) as Configuration;
// Save the full configuration file.
config.SaveAs("MyConfigMinimal.config");
Console.WriteLine("Saved config file as MyConfigMinimal.config using the mode: {0}",
ConfigurationSaveMode.Minimal.ToString());
}
catch (ConfigurationErrorsException err)
{
Console.WriteLine("SaveConfigurationFile: {0}", err.ToString());
}
}
' Show how to use different modalities to save
' a configuration file.
Public Shared Sub SaveConfigurationFile()
Try
' Get the current configuration file.
Dim config As System.Configuration.Configuration = TryCast(ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None), Configuration)
' Save the full configuration file and force save even if the file was not modified.
config.SaveAs("MyConfigFull.config", ConfigurationSaveMode.Full, True)
Console.WriteLine("Saved config file as MyConfigFull.config using the mode: {0}", ConfigurationSaveMode.Full.ToString())
config = TryCast(ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None), Configuration)
' Save only the part of the configuration file that was modified.
config.SaveAs("MyConfigModified.config", ConfigurationSaveMode.Modified, True)
Console.WriteLine("Saved config file as MyConfigModified.config using the mode: {0}", ConfigurationSaveMode.Modified.ToString())
config = TryCast(ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None), Configuration)
' Save the full configuration file.
config.SaveAs("MyConfigMinimal.config")
Console.WriteLine("Saved config file as MyConfigMinimal.config using the mode: {0}", ConfigurationSaveMode.Minimal.ToString())
Catch err As ConfigurationErrorsException
Console.WriteLine("SaveConfigurationFile: {0}", err.ToString())
End Try
End Sub
Poznámky
Metoda SaveAs zachová nastavení konfigurace v objektu Configuration do nového souboru na saveMode
základě parametrů a forceSaveAll
.
Pokud konfigurační soubor neexistuje ve fyzickém umístění reprezentované FilePath vlastností, vytvoří se nový konfigurační soubor, který bude obsahovat všechna nastavení, která se liší od zděděné konfigurace.
Pokud se konfigurační soubor od vytvoření tohoto Configuration objektu změnil, dojde k chybě za běhu.