Configuration.SaveAs Methode

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Schreibt die in diesem Configuration-Objekt enthaltenen Konfigurationseinstellungen in die angegebene XML-Konfigurationsdatei.

Überlädt

SaveAs(String)	Schreibt die in diesem Configuration-Objekt enthaltenen Konfigurationseinstellungen in die angegebene XML-Konfigurationsdatei.
SaveAs(String, ConfigurationSaveMode)	Schreibt die in diesem Configuration-Objekt enthaltenen Konfigurationseinstellungen in die angegebene XML-Konfigurationsdatei.
SaveAs(String, ConfigurationSaveMode, Boolean)	Schreibt die in diesem Configuration-Objekt enthaltenen Konfigurationseinstellungen in die angegebene XML-Konfigurationsdatei.

SaveAs(String)

Quelle:

Configuration.cs

Schreibt die in diesem Configuration-Objekt enthaltenen Konfigurationseinstellungen in die angegebene XML-Konfigurationsdatei.

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

public void SaveAs (string filename);

member this.SaveAs : string -> unit

Public Sub SaveAs (filename As String)

Parameter

filename

String

Der Pfad und der Dateiname für das Speichern der Konfigurationsdatei.

Ausnahmen

ConfigurationErrorsException

In die Konfigurationsdatei konnte nicht geschrieben werden.

- oder -

Die Konfigurationsdatei hat sich geändert.

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.

SaveAs(String, ConfigurationSaveMode)

Quelle:

Configuration.cs

Schreibt die in diesem Configuration-Objekt enthaltenen Konfigurationseinstellungen in die angegebene XML-Konfigurationsdatei.

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

filename

String

Der Pfad und der Dateiname für das Speichern der Konfigurationsdatei.

saveMode

ConfigurationSaveMode

Ein ConfigurationSaveMode-Wert, der bestimmt, welche Eigenschaftswerte gespeichert werden sollen.

Ausnahmen

ConfigurationErrorsException

In die Konfigurationsdatei konnte nicht geschrieben werden.

- oder -

Die Konfigurationsdatei hat sich geändert.

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.

SaveAs(String, ConfigurationSaveMode, Boolean)

Quelle:

Configuration.cs

Schreibt die in diesem Configuration-Objekt enthaltenen Konfigurationseinstellungen in die angegebene XML-Konfigurationsdatei.

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

filename

String

Der Pfad und der Dateiname für das Speichern der Konfigurationsdatei.

saveMode

ConfigurationSaveMode

Ein ConfigurationSaveMode-Wert, der bestimmt, welche Eigenschaftswerte gespeichert werden sollen.

forceSaveAll

Boolean

true, um auch dann zu speichern, wenn die Konfiguration nicht geändert wurde, andernfalls false.

Ausnahmen

ArgumentException

filename ist NULL oder eine leere Zeichenfolge ("").

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.