Configuration.SaveAs Methode
Definition
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 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
- Quelle:
- Configuration.cs
- 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 -> unitPublic Sub SaveAs (filename As String)Parameter
- filename
- String
Der Pfad und der Dateiname für das Speichern der Konfigurationsdatei.
Ausnahmen
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.
Gilt für:
SaveAs(String, ConfigurationSaveMode)
- Quelle:
- Configuration.cs
- Quelle:
- Configuration.cs
- 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 -> unitPublic 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
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.
Gilt für:
SaveAs(String, ConfigurationSaveMode, Boolean)
- Quelle:
- Configuration.cs
- Quelle:
- Configuration.cs
- 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 -> unitPublic 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
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.
