Configuration.SaveAs 메서드

정의

네임스페이스:

System.Configuration

어셈블리:

System.Configuration.ConfigurationManager.dll

패키지:

System.Configuration.ConfigurationManager v8.0.0

이 Configuration 개체에 포함된 구성 설정을 지정된 XML 구성 파일에 씁니다.

오버로드

SaveAs(String)	이 Configuration 개체에 포함된 구성 설정을 지정된 XML 구성 파일에 씁니다.
SaveAs(String, ConfigurationSaveMode)	이 Configuration 개체에 포함된 구성 설정을 지정된 XML 구성 파일에 씁니다.
SaveAs(String, ConfigurationSaveMode, Boolean)	이 Configuration 개체에 포함된 구성 설정을 지정된 XML 구성 파일에 씁니다.

SaveAs(String)

Source:

Configuration.cs

이 Configuration 개체에 포함된 구성 설정을 지정된 XML 구성 파일에 씁니다.

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

public void SaveAs (string filename);

member this.SaveAs : string -> unit

Public Sub SaveAs (filename As String)

매개 변수

filename

String

구성 파일을 저장할 경로와 파일 이름입니다.

예외

ConfigurationErrorsException

구성 파일에 쓸 수 없는 경우

또는

구성 파일이 변경된 경우

설명

메서드는 SaveAs 이 Configuration 개체를 새 파일로 만든 이후 수정된 모든 구성 설정을 유지합니다.

구성 파일이 가 나타내는 물리적 위치에 없는 경우

FilePath 속성, 상속된 구성과 다른 설정을 포함하도록 새 구성 파일이 만들어집니다.

이 Configuration 개체를 만든 후 구성 파일이 변경된 경우 런타임 오류가 발생합니다.

SaveAs(String, ConfigurationSaveMode)

Source:

Configuration.cs

이 Configuration 개체에 포함된 구성 설정을 지정된 XML 구성 파일에 씁니다.

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)

매개 변수

filename

String

구성 파일을 저장할 경로와 파일 이름입니다.

saveMode

ConfigurationSaveMode

저장할 속성 값을 결정하는 ConfigurationSaveMode 값입니다.

예외

ConfigurationErrorsException

구성 파일에 쓸 수 없는 경우

또는

구성 파일이 변경된 경우

설명

메서드는 SaveAs 매개 변수를 기반으로 saveMode 개체의 Configuration 구성 설정을 새 파일에 유지합니다.

속성이 나타내는 실제 위치에 구성 파일이 없는 경우 상속된 FilePath 구성과 다른 설정을 포함하도록 새 구성 파일이 만들어집니다.

이 Configuration 개체를 만든 후 구성 파일이 변경된 경우 런타임 오류가 발생합니다.

SaveAs(String, ConfigurationSaveMode, Boolean)

Source:

Configuration.cs

이 Configuration 개체에 포함된 구성 설정을 지정된 XML 구성 파일에 씁니다.

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)

매개 변수

filename

String

구성 파일을 저장할 경로와 파일 이름입니다.

saveMode

ConfigurationSaveMode

저장할 속성 값을 결정하는 ConfigurationSaveMode 값입니다.

forceSaveAll

Boolean

구성이 수정되지 않은 경우에도 저장하려면 true이고, 그렇지 않으면 false입니다.

예외

ArgumentException

filename가 null이거나 빈 문자열("")인 경우

예제

다음 코드 예제에서는 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

설명

메서드는 SaveAs 및 forceSaveAll 매개 변수를 기반으로 saveMode 개체의 Configuration 구성 설정을 새 파일에 유지합니다.

속성이 나타내는 실제 위치에 구성 파일이 없는 경우 상속된 FilePath 구성과 다른 설정을 포함하도록 새 구성 파일이 만들어집니다.

이 Configuration 개체를 만든 후 구성 파일이 변경된 경우 런타임 오류가 발생합니다.