WebConfigurationManager.OpenMachineConfiguration Метод

Определение

Пространство имен:

System.Web.Configuration

Сборка:

System.Web.dll

Открывает файл конфигурации компьютера в качестве объекта Configuration для выполнения операций чтения или записи.

Перегрузки

OpenMachineConfiguration()	Открывает файл конфигурации компьютера на текущем компьютере в качестве объекта Configuration для выполнения операций чтения или записи.
OpenMachineConfiguration(String)	Открывает файл конфигурации компьютера на текущем компьютере в качестве объекта Configuration для выполнения операций чтения или записи.
OpenMachineConfiguration(String, String)	Открывает указанный файл конфигурации компьютера на указанном сервере в качестве объекта Configuration для выполнения операций чтения или записи.
OpenMachineConfiguration(String, String, IntPtr)	Открывает указанный файл конфигурации компьютера на указанном сервере в качестве объекта Configuration с помощью указанного контекста безопасности для выполнения операций чтения или записи.
OpenMachineConfiguration(String, String, String, String)	Открывает указанный файл конфигурации компьютера на указанном сервере в качестве объекта Configuration с помощью указанного контекста безопасности для выполнения операций чтения или записи.

OpenMachineConfiguration()

Открывает файл конфигурации компьютера на текущем компьютере в качестве объекта Configuration для выполнения операций чтения или записи.

public:
 static System::Configuration::Configuration ^ OpenMachineConfiguration();

public static System.Configuration.Configuration OpenMachineConfiguration ();

static member OpenMachineConfiguration : unit -> System.Configuration.Configuration

Public Shared Function OpenMachineConfiguration () As Configuration

Возвращаемое значение

Configuration

Объект Configuration.

Исключения

ConfigurationErrorsException

Верный файл конфигурации не может быть загружен.

Примеры

В следующем примере показано, как получить доступ к сведениям о конфигурации OpenMachineConfiguration с помощью метода.

// Show how to use OpenMachineConfiguration().
// It gets the machine.config file on the current 
// machine and displays section information. 
static void OpenMachineConfiguration1()
{
    // Get the machine.config file on the current machine.
    System.Configuration.Configuration config =
            WebConfigurationManager.OpenMachineConfiguration();

    // Loop to get the sections. Display basic information.
    Console.WriteLine("Name, Allow Definition");
    int i = 0;
    foreach (ConfigurationSection section in config.Sections)
    {
        Console.WriteLine(
            section.SectionInformation.Name + "\t" +
        section.SectionInformation.AllowExeDefinition);
        i += 1;
    }
    Console.WriteLine("[Total number of sections: {0}]", i);

    // Display machine.config path.
    Console.WriteLine("[File path: {0}]", config.FilePath); 
}

' Show how to use OpenMachineConfiguration().
' It gets the machine.config file on the current 
' machine and displays section information. 
Shared Sub OpenMachineConfiguration1()
   ' Get the machine.config file on the current machine.
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenMachineConfiguration()
   
   ' Loop to get the sections. Display basic information.
   Console.WriteLine("Name, Allow Definition")
   Dim i As Integer = 0
   Dim section As ConfigurationSection
   For Each section In  config.Sections
         Console.WriteLine((section.SectionInformation.Name + _
         ControlChars.Tab + _
         section.SectionInformation.AllowExeDefinition.ToString()))
         i += 1
     Next section
     Console.WriteLine("[Total number of sections: {0}]", i)

     ' Display machine.config path.
     Console.WriteLine("[File path: {0}]", config.FilePath)
 End Sub

Комментарии

Метод OpenMachineConfiguration открывает файл конфигурации компьютера на компьютере, на котором выполняется приложение. Этот файл находится в стандартном каталоге сборки %windir%\Microsoft.NET\Framework\version\config.

См. также раздел

• Configuration

OpenMachineConfiguration(String)

Открывает файл конфигурации компьютера на текущем компьютере в качестве объекта Configuration для выполнения операций чтения или записи.

public:
 static System::Configuration::Configuration ^ OpenMachineConfiguration(System::String ^ locationSubPath);

public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath);

static member OpenMachineConfiguration : string -> System.Configuration.Configuration

Public Shared Function OpenMachineConfiguration (locationSubPath As String) As Configuration

Параметры

locationSubPath

String

Путь приложения, к которому применяется конфигурация компьютера.

Возвращаемое значение

Configuration

Объект Configuration.

Исключения

ConfigurationErrorsException

Верный файл конфигурации не может быть загружен.

Примеры

В следующем примере показано, как получить доступ к сведениям о конфигурации OpenMachineConfiguration с помощью метода.

// Show how to use OpenMachineConfiguration(string).
// It gets the machine.config file applicabe to the
// specified resource and displays section 
// basic information. 
static void OpenMachineConfiguration2()
{
    // Get the machine.config file applicabe to the
    // specified reosurce.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenMachineConfiguration("configTest");

    // Loop to get the sections. Display basic information.
    Console.WriteLine("Name, Allow Definition");
    int i = 0;
    foreach (ConfigurationSection section in config.Sections)
    {
        Console.WriteLine(
            section.SectionInformation.Name + "\t" +
        section.SectionInformation.AllowExeDefinition);
        i += 1;
    }
    Console.WriteLine("[Total number of sections: {0}]", i);

    // Display machine.config path.
    Console.WriteLine("[File path: {0}]", config.FilePath);
}

' Show how to use OpenMachineConfiguration(string).
' It gets the machine.config file applicabe to the
' specified resource and displays section 
' basic information. 
Shared Sub OpenMachineConfiguration2()
    ' Get the machine.config file applicabe to the
    ' specified reosurce.
    Dim config As System.Configuration.Configuration = _
    WebConfigurationManager.OpenMachineConfiguration( _
    "configTest")

    ' Loop to get the sections. Display basic information.
    Console.WriteLine("Name, Allow Definition")
    Dim i As Integer = 0
    Dim section As ConfigurationSection
    For Each section In config.Sections
        Console.WriteLine((section.SectionInformation.Name + _
        ControlChars.Tab + _
        section.SectionInformation.AllowExeDefinition.ToString()))
        i += 1
    Next section
    Console.WriteLine("[Total number of sections: {0}]", i)

    ' Display machine.config path.
    Console.WriteLine("[File path: {0}]", config.FilePath)
End Sub

Комментарии

Этот метод открывает файл конфигурации компьютера, применимый к каталогу, указанному параметром locationSubPath .

См. также раздел

• Configuration

OpenMachineConfiguration(String, String)

Открывает указанный файл конфигурации компьютера на указанном сервере в качестве объекта Configuration для выполнения операций чтения или записи.

public:
 static System::Configuration::Configuration ^ OpenMachineConfiguration(System::String ^ locationSubPath, System::String ^ server);

public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath, string server);

static member OpenMachineConfiguration : string * string -> System.Configuration.Configuration

Public Shared Function OpenMachineConfiguration (locationSubPath As String, server As String) As Configuration

Параметры

locationSubPath

String

Путь приложения, к которому применяется конфигурация.

server

String

Полное имя сервера для возврата конфигурации.

Возвращаемое значение

Configuration

Объект Configuration.

Исключения

ConfigurationErrorsException

Верный файл конфигурации не может быть загружен.

Примеры

В следующем примере показано, как получить доступ к сведениям о конфигурации OpenMachineConfiguration с помощью метода.

// Show how to use OpenMachineConfiguration(string, string).
// It gets the machine.config file on the specified server and
// applicabe to the specified reosurce and displays section 
// basic information. 
static void OpenMachineConfiguration3()
{
    // Get the machine.config file applicabe to the
    // specified reosurce and on the specified server.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenMachineConfiguration("configTest", 
        "myServer");

    // Loop to get the sections. Display basic information.
    Console.WriteLine("Name, Allow Definition");
    int i = 0;
    foreach (ConfigurationSection section in config.Sections)
    {
        Console.WriteLine(
            section.SectionInformation.Name + "\t" +
        section.SectionInformation.AllowExeDefinition);
        i += 1;
    }
    Console.WriteLine("[Total number of sections: {0}]", i);

    // Display machine.config path.
    Console.WriteLine("[File path: {0}]", config.FilePath);
}

' Show how to use OpenMachineConfiguration(string, string).
' It gets the machine.config file on the specified server and
' applicabe to the specified reosurce and displays section 
' basic information. 
Shared Sub OpenMachineConfiguration3()
    ' Get the machine.config file applicabe to the
    ' specified reosurce and on the specified server.
    Dim config As System.Configuration.Configuration = _
    WebConfigurationManager.OpenMachineConfiguration( _
    "configTest", "myServer")

    ' Loop to get the sections. Display basic information.
    Console.WriteLine("Name, Allow Definition")
    Dim i As Integer = 0
    Dim section As ConfigurationSection
    For Each section In config.Sections
        Console.WriteLine((section.SectionInformation.Name + _
        ControlChars.Tab + _
        section.SectionInformation.AllowExeDefinition.ToString()))
        i += 1
    Next section
    Console.WriteLine("[Total number of sections: {0}]", i)

    ' Display machine.config path.
    Console.WriteLine("[File path: {0}]", config.FilePath)
End Sub

Комментарии

Этот метод открывает файл конфигурации компьютера, расположенный в каталоге, указанном параметром, и на компьютере, указанном locationSubPath параметром server .

См. также раздел

• Configuration

OpenMachineConfiguration(String, String, IntPtr)

Открывает указанный файл конфигурации компьютера на указанном сервере в качестве объекта Configuration с помощью указанного контекста безопасности для выполнения операций чтения или записи.

public:
 static System::Configuration::Configuration ^ OpenMachineConfiguration(System::String ^ locationSubPath, System::String ^ server, IntPtr userToken);

public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath, string server, IntPtr userToken);

static member OpenMachineConfiguration : string * string * nativeint -> System.Configuration.Configuration

Public Shared Function OpenMachineConfiguration (locationSubPath As String, server As String, userToken As IntPtr) As Configuration

Параметры

locationSubPath

String

Путь приложения, к которому применяется конфигурация.

server

String

Полное имя сервера для возврата конфигурации.

userToken

IntPtr

nativeint

токен учетной записи для использования.

Возвращаемое значение

Configuration

Объект Configuration.

Исключения

ArgumentException

Верные значения не предоставляются для параметров server или userToken.

ConfigurationErrorsException

Верный файл конфигурации не может быть загружен.

Примеры

В следующем примере показано, как получить доступ к сведениям о конфигурации OpenMachineConfiguration с помощью метода.

// Show how to use OpenMachineConfiguration(string, string).
// It gets the machine.config file on the specified server,
// applicabe to the specified reosurce, for the specified user
// and displays section basic information. 
static void OpenMachineConfiguration4()
{
    // Get the current user token.
    IntPtr userToken =
          System.Security.Principal.WindowsIdentity.GetCurrent().Token;

    // Get the machine.config file applicabe to the
    // specified reosurce, on the specified server for the
    // specified user.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenMachineConfiguration("configTest",
        "myServer", userToken);

    // Loop to get the sections. Display basic information.
    Console.WriteLine("Name, Allow Definition");
    int i = 0;
    foreach (ConfigurationSection section in config.Sections)
    {
        Console.WriteLine(
            section.SectionInformation.Name + "\t" +
        section.SectionInformation.AllowExeDefinition);
        i += 1;
    }
    Console.WriteLine("[Total number of sections: {0}]", i);

    // Display machine.config path.
    Console.WriteLine("[File path: {0}]", config.FilePath);
}

' Show how to use OpenMachineConfiguration(string, string).
' It gets the machine.config file on the specified server,
' applicabe to the specified reosurce, for the specified user
' and displays section basic information. 
Shared Sub OpenMachineConfiguration4()
    ' Get the current user token.
    Dim userToken As IntPtr = _
    System.Security.Principal.WindowsIdentity.GetCurrent().Token

    ' Get the machine.config file applicabe to the
    ' specified reosurce, on the specified server for the
    ' specified user.
    Dim config As System.Configuration.Configuration = _
    WebConfigurationManager.OpenMachineConfiguration( _
    "configTest", "myServer", userToken)

    ' Loop to get the sections. Display basic information.
    Console.WriteLine("Name, Allow Definition")
    Dim i As Integer = 0
    Dim section As ConfigurationSection
    For Each section In config.Sections
        Console.WriteLine((section.SectionInformation.Name + _
        ControlChars.Tab + _
        section.SectionInformation.AllowExeDefinition.ToString()))
        i += 1
    Next section
    Console.WriteLine("[Total number of sections: {0}]", i)

    ' Display machine.config path.
    Console.WriteLine("[File path: {0}]", config.FilePath)
End Sub

Комментарии

Этот метод используется для доступа к файлу конфигурации с помощью олицетворения.

Примечание

Маркер учетной записи обычно извлекается из экземпляра WindowsIdentity класса или посредством вызова неуправляемого кода, например вызова API LogonUserWindows. Дополнительные сведения о вызовах неуправляемого кода см. в разделе "Использование неуправляемых функций DLL".

См. также раздел

• Configuration
• WindowsIdentity
• Использование неуправляемых функций DLL

OpenMachineConfiguration(String, String, String, String)

Открывает указанный файл конфигурации компьютера на указанном сервере в качестве объекта Configuration с помощью указанного контекста безопасности для выполнения операций чтения или записи.

public:
 static System::Configuration::Configuration ^ OpenMachineConfiguration(System::String ^ locationSubPath, System::String ^ server, System::String ^ userName, System::String ^ password);

public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath, string server, string userName, string password);

static member OpenMachineConfiguration : string * string * string * string -> System.Configuration.Configuration

Public Shared Function OpenMachineConfiguration (locationSubPath As String, server As String, userName As String, password As String) As Configuration

Параметры

locationSubPath

String

Путь приложения, к которому применяется конфигурация.

server

String

Полное имя сервера для возврата конфигурации.

userName

String

Полное имя пользователя (Domain\User) для использования при открытии файла.

password

String

Пароль для имени пользователя.

Возвращаемое значение

Configuration

Объект Configuration.

Исключения

ArgumentException

Параметры server или userName и password были неверны.

ConfigurationErrorsException

Верный файл конфигурации не может быть загружен.

Примеры

В следующем примере показано, как получить доступ к сведениям о конфигурации OpenMachineConfiguration с помощью метода.

// Show how to use OpenMachineConfiguration(string, string).
// It gets the machine.config file on the specified server,
// applicabe to the specified reosurce, for the specified user
// and displays section basic information. 
static void OpenMachineConfiguration5()
{
    // Set the user id and password.
    string user =
          System.Security.Principal.WindowsIdentity.GetCurrent().Name;
    // Substitute with actual password.
    string password = "userPassword";

    // Get the machine.config file applicabe to the
    // specified reosurce, on the specified server for the
    // specified user.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenMachineConfiguration("configTest",
        "myServer", user, password);

    // Loop to get the sections. Display basic information.
    Console.WriteLine("Name, Allow Definition");
    int i = 0;
    foreach (ConfigurationSection section in config.Sections)
    {
        Console.WriteLine(
            section.SectionInformation.Name + "\t" +
        section.SectionInformation.AllowExeDefinition);
        i += 1;
    }
    Console.WriteLine("[Total number of sections: {0}]", i);

    // Display machine.config path.
    Console.WriteLine("[File path: {0}]", config.FilePath);
}

 ' Show how to use OpenMachineConfiguration(string, string).
 ' It gets the machine.config file on the specified server,
 ' applicabe to the specified reosurce, for the specified user
 ' and displays section basic information. 
 Shared Sub OpenMachineConfiguration5()
     ' Set the user id and password.
     Dim user As String = _
     System.Security.Principal.WindowsIdentity.GetCurrent().Name
     ' Substitute with actual password.
     Dim password As String = "userPassword"

     ' Get the machine.config file applicabe to the
     ' specified reosurce, on the specified server for the
     ' specified user.
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenMachineConfiguration( _
     "configTest", "myServer", user, password)

     ' Loop to get the sections. Display basic information.
     Console.WriteLine("Name, Allow Definition")
     Dim i As Integer = 0
     Dim section As ConfigurationSection
     For Each section In config.Sections
         Console.WriteLine((section.SectionInformation.Name + _
         ControlChars.Tab + _
         section.SectionInformation.AllowExeDefinition.ToString()))
         i += 1
     Next section
     Console.WriteLine("[Total number of sections: {0}]", i)

     ' Display machine.config path.
     Console.WriteLine("[File path: {0}]", config.FilePath)
 End Sub

Комментарии

Этот метод используется для доступа к файлу конфигурации с помощью олицетворения.

См. также раздел

• Configuration