Configuration.SaveAs Metodo

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Scrive le impostazioni di configurazione contenute in questo oggetto Configuration nel file di configurazione XML specificato.

Overload

SaveAs(String)	Scrive le impostazioni di configurazione contenute in questo oggetto Configuration nel file di configurazione XML specificato.
SaveAs(String, ConfigurationSaveMode)	Scrive le impostazioni di configurazione contenute in questo oggetto Configuration nel file di configurazione XML specificato.
SaveAs(String, ConfigurationSaveMode, Boolean)	Scrive le impostazioni di configurazione contenute in questo oggetto Configuration nel file di configurazione XML specificato.

SaveAs(String)

Source:

Configuration.cs

Scrive le impostazioni di configurazione contenute in questo oggetto Configuration nel file di configurazione XML specificato.

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

public void SaveAs (string filename);

member this.SaveAs : string -> unit

Public Sub SaveAs (filename As String)

Parametri

filename

String

Percorso e nome del file in cui salvare il file di configurazione.

Eccezioni

ConfigurationErrorsException

Non è stato possibile scrivere nel file di configurazione.

-oppure-

Il file di configurazione è stato modificato.

Commenti

Il SaveAs metodo mantiene le impostazioni di configurazione modificate dopo la creazione di questo Configuration oggetto in un nuovo file.

Se un file di configurazione non esiste nella posizione fisica rappresentata dall'oggetto

FilePath proprietà, verrà creato un nuovo file di configurazione per contenere tutte le impostazioni diverse dalla configurazione ereditata.

Se il file di configurazione è stato modificato dopo la creazione di questo Configuration oggetto, si verifica un errore di runtime.

SaveAs(String, ConfigurationSaveMode)

Source:

Configuration.cs

Scrive le impostazioni di configurazione contenute in questo oggetto Configuration nel file di configurazione XML specificato.

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)

Parametri

filename

String

Percorso e nome del file in cui salvare il file di configurazione.

saveMode

ConfigurationSaveMode

Valore ConfigurationSaveMode che determina i valori della proprietà da salvare.

Eccezioni

ConfigurationErrorsException

Non è stato possibile scrivere nel file di configurazione.

-oppure-

Il file di configurazione è stato modificato.

Commenti

Il SaveAs metodo mantiene le impostazioni di configurazione nell'oggetto Configuration in un nuovo file in base al saveMode parametro .

Se un file di configurazione non esiste nella posizione fisica rappresentata dalla FilePath proprietà, verrà creato un nuovo file di configurazione per contenere eventuali impostazioni diverse dalla configurazione ereditata.

Se il file di configurazione è stato modificato dopo la creazione di questo Configuration oggetto, si verifica un errore di runtime.

SaveAs(String, ConfigurationSaveMode, Boolean)

Source:

Configuration.cs

Scrive le impostazioni di configurazione contenute in questo oggetto Configuration nel file di configurazione XML specificato.

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)

Parametri

filename

String

Percorso e nome del file in cui salvare il file di configurazione.

saveMode

ConfigurationSaveMode

Valore ConfigurationSaveMode che determina i valori della proprietà da salvare.

forceSaveAll

Boolean

true per effettuare il salvataggio anche se la configurazione non è stata modificata; in caso contrario, false.

Eccezioni

ArgumentException

Il valore di filename è null oppure una stringa vuota ("").

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo SaveAs.

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

Commenti

Il SaveAs metodo mantiene le impostazioni di configurazione nell'oggetto Configuration in un nuovo file in base ai saveMode parametri e forceSaveAll .

Se un file di configurazione non esiste nella posizione fisica rappresentata dalla FilePath proprietà, verrà creato un nuovo file di configurazione per contenere eventuali impostazioni diverse dalla configurazione ereditata.

Se il file di configurazione è stato modificato dopo la creazione di questo Configuration oggetto, si verifica un errore di runtime.