Configuration.SaveAs Metode

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Menulis pengaturan konfigurasi yang terkandung dalam objek ini Configuration ke file konfigurasi XML yang ditentukan.

Overload

SaveAs(String)	Menulis pengaturan konfigurasi yang terkandung dalam objek ini Configuration ke file konfigurasi XML yang ditentukan.
SaveAs(String, ConfigurationSaveMode)	Menulis pengaturan konfigurasi yang terkandung dalam objek ini Configuration ke file konfigurasi XML yang ditentukan.
SaveAs(String, ConfigurationSaveMode, Boolean)	Menulis pengaturan konfigurasi yang terkandung dalam objek ini Configuration ke file konfigurasi XML yang ditentukan.

SaveAs(String)

Sumber:

Configuration.cs

Menulis pengaturan konfigurasi yang terkandung dalam objek ini Configuration ke file konfigurasi XML yang ditentukan.

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

Jalur dan nama file untuk menyimpan file konfigurasi.

Pengecualian

ConfigurationErrorsException

File konfigurasi tidak dapat ditulis.

-atau-

File konfigurasi telah berubah.

Keterangan

Metode ini SaveAs mempertahankan pengaturan konfigurasi apa pun yang telah dimodifikasi sejak objek ini Configuration dibuat ke file baru.

Jika file konfigurasi tidak ada di lokasi fisik yang diwakili oleh

FilePath properti , file konfigurasi baru akan dibuat untuk berisi pengaturan apa pun yang berbeda dari konfigurasi yang diwariskan.

Jika file konfigurasi telah berubah sejak objek ini Configuration dibuat, kesalahan run-time terjadi.

SaveAs(String, ConfigurationSaveMode)

Sumber:

Configuration.cs

Menulis pengaturan konfigurasi yang terkandung dalam objek ini Configuration ke file konfigurasi XML yang ditentukan.

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

Jalur dan nama file untuk menyimpan file konfigurasi.

saveMode

ConfigurationSaveMode

ConfigurationSaveMode Nilai yang menentukan nilai properti mana yang akan disimpan.

Pengecualian

ConfigurationErrorsException

File konfigurasi tidak dapat ditulis.

-atau-

File konfigurasi telah berubah.

Keterangan

Metode ini SaveAs mempertahankan pengaturan konfigurasi dalam Configuration objek ke file baru berdasarkan saveMode parameter .

Jika file konfigurasi tidak ada di lokasi fisik yang diwakili oleh FilePath properti , file konfigurasi baru akan dibuat untuk berisi pengaturan apa pun yang berbeda dari konfigurasi yang diwariskan.

Jika file konfigurasi telah berubah sejak objek ini Configuration dibuat, kesalahan run-time terjadi.

SaveAs(String, ConfigurationSaveMode, Boolean)

Sumber:

Configuration.cs

Menulis pengaturan konfigurasi yang terkandung dalam objek ini Configuration ke file konfigurasi XML yang ditentukan.

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

Jalur dan nama file untuk menyimpan file konfigurasi.

saveMode

ConfigurationSaveMode

ConfigurationSaveMode Nilai yang menentukan nilai properti mana yang akan disimpan.

forceSaveAll

Boolean

true untuk menyimpan meskipun konfigurasi tidak dimodifikasi; jika tidak, false.

Pengecualian

ArgumentException

filename null atau string kosong ("").

Contoh

Contoh kode berikut menunjukkan cara menggunakan SaveAs metode .

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

Keterangan

Metode ini SaveAs mempertahankan pengaturan konfigurasi dalam Configuration objek ke file baru berdasarkan saveMode parameter dan forceSaveAll .

Jika file konfigurasi tidak ada di lokasi fisik yang diwakili oleh FilePath properti , file konfigurasi baru akan dibuat untuk berisi pengaturan apa pun yang berbeda dari konfigurasi yang diwariskan.

Jika file konfigurasi telah berubah sejak objek ini Configuration dibuat, kesalahan run-time terjadi.