ConfigurationUserLevel 列舉

定義

用於指定哪個組態檔要由 Configuration 物件來表示。Used to specify which configuration file is to be represented by the Configuration object.

public enum class ConfigurationUserLevel
public enum ConfigurationUserLevel
type ConfigurationUserLevel = 
Public Enum ConfigurationUserLevel
繼承
ConfigurationUserLevel

欄位

None 0

取得套用至所有使用者的 ConfigurationGets the Configuration that applies to all users.

PerUserRoaming 10

取得套用至目前使用者的漫遊 ConfigurationGets the roaming Configuration that applies to the current user.

PerUserRoamingAndLocal 20

取得套用至目前使用者的本機 ConfigurationGets the local Configuration that applies to the current user.

範例

下列範例顯示如何使用 ConfigurationUserLevel 列舉。The following example shows how to use the ConfigurationUserLevel enumeration.


using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Configuration;
using System.Collections;
using System.Collections.Specialized;
using System.Diagnostics;
using System.Text;

public class UsingConsoleConfigElement
{

    static void GetConfigurationFile()
    {

        try
        {
            // Get the current application configuration file.
            Configuration config =
              ConfigurationManager.OpenExeConfiguration(
               ConfigurationUserLevel.None);

            Console.WriteLine(config.FilePath);
        }
        catch (ConfigurationErrorsException e)
        {
            Console.WriteLine("[Exception error: {0}]",
                e.ToString());
        }
    }

    // Get the roaming configuration file associated 
    // with the current user.
    static void GetRoamingConfigurationFile()
    {

        try
        {
            // Get the roaming configuration 
            // that applies to the current user.
            Configuration roamingConfig =
              ConfigurationManager.OpenExeConfiguration(
               ConfigurationUserLevel.PerUserRoaming);

            Console.WriteLine(roamingConfig.FilePath);
        }
        catch (ConfigurationErrorsException e)
        {
            Console.WriteLine("[Exception error: {0}]",
                e.ToString());
        }
    }

    static void Main(string[] args)
    {
        Console.Write("Roaming configuration file: ");
        GetRoamingConfigurationFile();
        Console.WriteLine();
        Console.Write("Configuration file: ");
        GetConfigurationFile();
        Console.WriteLine("Enter any key to exit");
        Console.ReadLine();
    }
}

Imports System.Collections.Generic
Imports System.Linq
Imports System.Text
Imports System.Configuration
Imports System.Collections
Imports System.Collections.Specialized
Imports System.Diagnostics


Public Class UsingConsoleConfigElement

    Private Shared Sub GetConfigurationFile()

        Try
            ' Get the current application configuration file.
            Dim config As Configuration = _
                ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None)

            Console.WriteLine(config.FilePath)

        Catch e As ConfigurationErrorsException
            Console.WriteLine("[Exception error: {0}]", e.ToString())
        End Try


    End Sub

    ' Get the roaming configuration file associated 
    ' with the current user.
    Private Shared Sub GetRoamingConfigurationFile()


      Try
          ' Get the roaming configuration 
          ' that applies to the current user.
            Dim roamingConfig As Configuration = _
                ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.PerUserRoaming)

          Console.WriteLine(roamingConfig.FilePath)

      Catch e As ConfigurationErrorsException
          Console.WriteLine("[Exception error: {0}]", e.ToString())
      End Try


    End Sub

    
    Shared Sub Main(ByVal args() As String)
        Console.Write("Roaming configuration file: ")
            GetRoamingConfigurationFile()
            Console.WriteLine()
        Console.Write("Configuration file: ")
            GetConfigurationFile()
        Console.WriteLine("Enter any key to exit")
        Console.ReadLine()
    End Sub
End Class

備註

使用 ConfigurationUserLevel 來指定由 ConfigurationManager.OpenExeConfigurationWebConfigurationManager.OpenMachineConfiguration傳回的設定物件所要表示的設定檔。Use ConfigurationUserLevel to specify which configuration file is to be represented by the Configuration object returned by ConfigurationManager.OpenExeConfiguration and WebConfigurationManager.OpenMachineConfiguration.

應用程式佈建檔位於與應用程式相同的目錄中,並具有相同的名稱,但副檔名為 .config。Application configuration files are in the same directory as the application and have the same name, but with a .config extension. 例如,C:\System\Public.exe 的設定檔案是 C:\System\Public.exe.config。For example, the configuration file for C:\System\Public.exe is C:\System\Public.exe.config.

應用程式會使用適用于所有使用者的全域設定、個別使用者適用的不同設定,以及適用于漫遊使用者的設定。Applications use a global configuration that applies to all users, separate configurations that apply to individual users, and configurations that apply to roaming users.

適用於

另請參閱