Configuration.SaveAs Metoda

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v8.0.0

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

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

ConfigurationErrorsException

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.

SaveAs(String, ConfigurationSaveMode)

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

ConfigurationErrorsException

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.

SaveAs(String, ConfigurationSaveMode, Boolean)

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

trueuložit i v případě, že konfigurace nebyla změněna; v opačném případě . false

Výjimky

ArgumentException

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.