Configuration.SaveAs メソッド

ソース:

Configuration.cs

ソース:

Configuration.cs

ソース:

Configuration.cs

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

public void SaveAs (string filename);

member this.SaveAs : string -> unit

Public Sub SaveAs (filename As String)

パラメーター

例外

注釈

メソッドは SaveAs 、この Configuration オブジェクトが新しいファイルに作成されてから変更されたすべての構成設定を保持します。

構成ファイルが、 によって表される物理的な場所に存在しない場合は、

FilePath プロパティを使用すると、継承された構成とは異なる設定を含む新しい構成ファイルが作成されます。

この Configuration オブジェクトの作成後に構成ファイルが変更された場合は、実行時エラーが発生します。

ソース:

Configuration.cs

ソース:

Configuration.cs

ソース:

Configuration.cs

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)

パラメーター

例外

注釈

メソッドは SaveAs 、 パラメーターに基づいて、 オブジェクトの Configuration 構成設定を新しいファイルに saveMode 保持します。

プロパティによって表される物理的な場所に構成ファイルが存在しない場合は、継承された FilePath 構成とは異なる設定を含む新しい構成ファイルが作成されます。

この Configuration オブジェクトの作成後に構成ファイルが変更された場合は、実行時エラーが発生します。

ソース:

Configuration.cs

ソース:

Configuration.cs

ソース:

Configuration.cs

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)

パラメーター

例外

例

次のコード例は、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、 および パラメーターに基づいて、 Configuration オブジェクトの構成設定を新しいファイルにsaveModeforceSaveAll保持します。

プロパティによって表される物理的な場所に構成ファイルが存在しない場合は、継承された FilePath 構成とは異なる設定を含む新しい構成ファイルが作成されます。

この Configuration オブジェクトの作成後に構成ファイルが変更された場合は、実行時エラーが発生します。