Configuration.SaveAs Methode

Definitie

Naamruimte:: System.Configuration

Assembly:: System.Configuration.ConfigurationManager.dll

Assembly:: System.Configuration.dll

Pakket:: System.Configuration.ConfigurationManager v11.0.0-preview.4.26230.115

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee schrijft u de configuratie-instellingen in dit Configuration object naar het opgegeven XML-configuratiebestand.

Overloads

Name	Description
SaveAs(String)	Hiermee schrijft u de configuratie-instellingen in dit Configuration object naar het opgegeven XML-configuratiebestand.
SaveAs(String, ConfigurationSaveMode)	Hiermee schrijft u de configuratie-instellingen in dit Configuration object naar het opgegeven XML-configuratiebestand.
SaveAs(String, ConfigurationSaveMode, Boolean)	Hiermee schrijft u de configuratie-instellingen in dit Configuration object naar het opgegeven XML-configuratiebestand.

SaveAs(String)

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Hiermee schrijft u de configuratie-instellingen in dit Configuration object naar het opgegeven XML-configuratiebestand.

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

public void SaveAs(string filename);

member this.SaveAs : string -> unit

Public Sub SaveAs (filename As String)

Parameters

filename: String

Het pad en de bestandsnaam om het configuratiebestand op te slaan.

Uitzonderingen

ConfigurationErrorsException

Het configuratiebestand kan niet worden geschreven naar.

– of –

Het configuratiebestand is gewijzigd.

Opmerkingen

De SaveAs methode behoudt alle configuratie-instellingen die zijn gewijzigd sinds dit Configuration object is gemaakt in een nieuw bestand.

Als er geen configuratiebestand bestaat op de fysieke locatie die wordt vertegenwoordigd door de

FilePath eigenschap, een nieuw configuratiebestand wordt gemaakt om instellingen te bevatten die afwijken van de overgenomen configuratie.

Als het configuratiebestand is gewijzigd sinds dit Configuration object is gemaakt, treedt er een runtimefout op.

Van toepassing op

SaveAs(String, ConfigurationSaveMode)

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Hiermee schrijft u de configuratie-instellingen in dit Configuration object naar het opgegeven XML-configuratiebestand.

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)

Parameters

filename: String

Het pad en de bestandsnaam om het configuratiebestand op te slaan.

saveMode: ConfigurationSaveMode

Een ConfigurationSaveMode waarde die bepaalt welke eigenschapswaarden moeten worden opgeslagen.

Uitzonderingen

ConfigurationErrorsException

Het configuratiebestand kan niet worden geschreven naar.

– of –

Het configuratiebestand is gewijzigd.

Opmerkingen

De SaveAs methode behoudt configuratie-instellingen in het Configuration object naar een nieuw bestand op basis van de saveMode parameter.

Als er geen configuratiebestand bestaat op de fysieke locatie die wordt vertegenwoordigd door de FilePath eigenschap, wordt er een nieuw configuratiebestand gemaakt dat instellingen bevat die afwijken van de overgenomen configuratie.

Als het configuratiebestand is gewijzigd sinds dit Configuration object is gemaakt, treedt er een runtimefout op.

Van toepassing op

SaveAs(String, ConfigurationSaveMode, Boolean)

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Bron:: Configuration.cs

Hiermee schrijft u de configuratie-instellingen in dit Configuration object naar het opgegeven XML-configuratiebestand.

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)

Parameters

filename: String

Het pad en de bestandsnaam om het configuratiebestand op te slaan.

saveMode: ConfigurationSaveMode

Een ConfigurationSaveMode waarde die bepaalt welke eigenschapswaarden moeten worden opgeslagen.

forceSaveAll: Boolean

true om op te slaan, zelfs als de configuratie niet is gewijzigd; anders, false.

Uitzonderingen

ArgumentException

filename is null of een lege tekenreeks ("").

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de SaveAs methode gebruikt.


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

Opmerkingen

De SaveAs methode behoudt configuratie-instellingen in het Configuration object naar een nieuw bestand op basis van de saveMode en forceSaveAll parameters.

Als het configuratiebestand is gewijzigd sinds dit Configuration object is gemaakt, treedt er een runtimefout op.

Van toepassing op

Feedback

Is deze pagina nuttig?