Configuration.SaveAs Methode

Definition

Namespace:: System.Configuration

Assembly:: System.Configuration.ConfigurationManager.dll

Assembly:: System.Configuration.dll

Paket:: System.Configuration.ConfigurationManager v11.0.0-preview.2.26159.112

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Überlädt

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

SaveAs(String)

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Schreibt die Konfigurationseinstellungen in diesem Configuration Objekt 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 dateiname, in dem die Konfigurationsdatei gespeichert werden soll.

Ausnahmen

ConfigurationErrorsException

Die Konfigurationsdatei konnte nicht geschrieben werden.

- oder -

Die Konfigurationsdatei wurde geändert.

Hinweise

Die SaveAs Methode behält alle Konfigurationseinstellungen bei, die seit der Erstellung dieses Configuration Objekts in einer neuen Datei geändert wurden.

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

FilePath eine neue Konfigurationsdatei wird erstellt, um alle Einstellungen zu enthalten, die sich von der geerbten Konfiguration unterscheiden.

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

Gilt für:

SaveAs(String, ConfigurationSaveMode)

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Schreibt die Konfigurationseinstellungen in diesem Configuration Objekt 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 dateiname, in dem die Konfigurationsdatei gespeichert werden soll.

saveMode: ConfigurationSaveMode

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

Ausnahmen

ConfigurationErrorsException

Die Konfigurationsdatei konnte nicht geschrieben werden.

- oder -

Die Konfigurationsdatei wurde geändert.

Hinweise

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

Wenn keine Konfigurationsdatei am physischen Speicherort vorhanden ist, der durch die FilePath Eigenschaft dargestellt wird, wird eine neue Konfigurationsdatei erstellt, um alle Einstellungen zu enthalten, die sich von der geerbten Konfiguration unterscheiden.

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

Gilt für:

SaveAs(String, ConfigurationSaveMode, Boolean)

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Quelle:: Configuration.cs

Schreibt die Konfigurationseinstellungen in diesem Configuration Objekt 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 dateiname, in dem die Konfigurationsdatei gespeichert werden soll.

saveMode: ConfigurationSaveMode

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

forceSaveAll: Boolean

truezu speichern, auch wenn die Konfiguration nicht geändert wurde; andernfalls . false

Ausnahmen

ArgumentException

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

Beispiele

Im folgenden Codebeispiel wird die Verwendung der SaveAs Methode veranschaulicht.


// 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 Und forceSaveAll Parametern.

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

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

Configuration.SaveAs Methode

Definition

Überlädt

SaveAs(String)

Parameter

Ausnahmen

Hinweise

Gilt für:

SaveAs(String, ConfigurationSaveMode)

Parameter

Ausnahmen

Hinweise

Gilt für:

SaveAs(String, ConfigurationSaveMode, Boolean)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Feedback