Configuration.SaveAs Methode

Quelle:

Configuration.cs

Quelle:

Configuration.cs

Quelle:

Configuration.cs

public:
 void SaveAs(System::String ^ filename);

public void SaveAs (string filename);

member this.SaveAs : string -> unit

Public Sub SaveAs (filename As String)

Parameter

Ausnahmen

Hinweise

Die SaveAs -Methode speichert alle Konfigurationseinstellungen, die geändert wurden, seit dieses Configuration Objekt in einer neuen Datei erstellt wurde.

Wenn keine Konfigurationsdatei am physischen Speicherort vorhanden ist, der durch den

FilePath wird eine neue Konfigurationsdatei erstellt, die alle Einstellungen enthält, die sich von der geerbten Konfiguration unterscheiden.

Wenn sich die Konfigurationsdatei seit der Erstellung dieses Configuration Objekts geändert hat, tritt ein Laufzeitfehler auf.

Quelle:

Configuration.cs

Quelle:

Configuration.cs

Quelle:

Configuration.cs

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)

Parameter

Ausnahmen

Hinweise

Die SaveAs -Methode speichert Konfigurationseinstellungen im Configuration -Objekt in einer neuen Datei basierend auf dem saveMode -Parameter.

Wenn an dem durch die FilePath -Eigenschaft dargestellten physischen Speicherort keine Konfigurationsdatei vorhanden ist, wird eine neue Konfigurationsdatei erstellt, die alle Einstellungen enthält, die sich von der geerbten Konfiguration unterscheiden.

Wenn sich die Konfigurationsdatei seit der Erstellung dieses Configuration Objekts geändert hat, tritt ein Laufzeitfehler auf.

Quelle:

Configuration.cs

Quelle:

Configuration.cs

Quelle:

Configuration.cs

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)

Parameter

Ausnahmen

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die SaveAs-Methode verwenden.

// 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

Hinweise

Die SaveAs -Methode speichert Konfigurationseinstellungen im Configuration -Objekt in einer neuen Datei basierend auf den saveMode Parametern und forceSaveAll .

Wenn an dem durch die FilePath -Eigenschaft dargestellten physischen Speicherort keine Konfigurationsdatei vorhanden ist, wird eine neue Konfigurationsdatei erstellt, die alle Einstellungen enthält, die sich von der geerbten Konfiguration unterscheiden.

Wenn sich die Konfigurationsdatei seit der Erstellung dieses Configuration Objekts geändert hat, tritt ein Laufzeitfehler auf.