Configuration.SaveAs Metodo

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

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

Overload

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

SaveAs(String)

Origine:

Configuration.cs

Scrive le impostazioni di configurazione contenute in questo Configuration oggetto 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 file in cui salvare il file di configurazione.

Eccezioni

ConfigurationErrorsException

Impossibile scrivere il file di configurazione.

oppure

Il file di configurazione è stato modificato.

Commenti

Il SaveAs metodo rende persistenti tutte 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 da

FilePath 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 run-time.

SaveAs(String, ConfigurationSaveMode)

Origine:

Configuration.cs

Scrive le impostazioni di configurazione contenute in questo Configuration oggetto 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 file in cui salvare il file di configurazione.

saveMode

ConfigurationSaveMode

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

Eccezioni

ConfigurationErrorsException

Impossibile scrivere il file di configurazione.

oppure

Il file di configurazione è stato modificato.

Commenti

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

Se un file di configurazione non esiste nel percorso fisico rappresentato 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 run-time.

SaveAs(String, ConfigurationSaveMode, Boolean)

Origine:

Configuration.cs

Scrive le impostazioni di configurazione contenute in questo Configuration oggetto 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 file in cui salvare il file di configurazione.

saveMode

ConfigurationSaveMode

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

forceSaveAll

Boolean

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

Eccezioni

ArgumentException

filename è null o una stringa vuota ("").

Esempio

Nell'esempio di codice seguente viene illustrato come usare il SaveAs metodo .

// 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 rende persistenti 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 nel percorso fisico rappresentato 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 run-time.