WebConfigurationManager.OpenWebConfiguration Metode

Referensi

Definisi

Ruang nama:: System.Web.Configuration

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Membuka file konfigurasi Aplikasi web sebagai Configuration objek.

Overload

OpenWebConfiguration(String)	Membuka file konfigurasi Aplikasi web sebagai objek menggunakan Configuration jalur virtual yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenWebConfiguration(String, String)	Membuka file konfigurasi Aplikasi web sebagai objek menggunakan Configuration jalur virtual dan nama situs yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenWebConfiguration(String, String, String)	Membuka file konfigurasi Aplikasi web sebagai objek menggunakan Configuration jalur virtual, nama situs, dan lokasi yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenWebConfiguration(String, String, String, String)	Membuka file konfigurasi Aplikasi web sebagai Configuration objek menggunakan jalur virtual, nama situs, lokasi, dan server yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenWebConfiguration(String, String, String, String, IntPtr)	Membuka file konfigurasi Aplikasi web sebagai Configuration objek menggunakan jalur virtual, nama situs, lokasi, server, dan konteks keamanan yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenWebConfiguration(String, String, String, String, String, String)	Membuka file konfigurasi Aplikasi web sebagai Configuration objek menggunakan jalur virtual, nama situs, lokasi, server, dan konteks keamanan yang ditentukan untuk mengizinkan operasi baca atau tulis.

OpenWebConfiguration(String)

Membuka file konfigurasi Aplikasi web sebagai objek menggunakan Configuration jalur virtual yang ditentukan untuk mengizinkan operasi baca atau tulis.

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path);

public static System.Configuration.Configuration OpenWebConfiguration (string path);

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

Public Shared Function OpenWebConfiguration (path As String) As Configuration

Parameter

path: String

Jalur virtual ke file konfigurasi. Jika null, file Web.config akar dibuka.

Mengembalikan

Configuration

Objek Configuration.

Pengecualian

ConfigurationErrorsException

File konfigurasi yang valid tidak dapat dimuat.

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan OpenWebConfiguration metode .


// Show how to use OpenWebConfiguration(string).
// It gets he appSettings section of a Web application 
// runnig on the local server. 
static void OpenWebConfiguration1()
{
    // Get the configuration object for a Web application
    // running on the local server. 
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenWebConfiguration("/configTest") 
        as System.Configuration.Configuration; 

    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine("[appSettings for app at: {0}]", "/configTest");
    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string).
' It gets he appSettings section of a Web application 
' runnig on the local server. 
Shared Sub OpenWebConfiguration1()
   ' Get the configuration object for a Web application
   ' running on the local server. 
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenWebConfiguration("/configTest")
   
   ' Get the appSettings.
     Dim appSettings As KeyValueConfigurationCollection = _
     config.AppSettings.Settings
   
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
   Console.WriteLine("[appSettings for app at: {0}]", "/configTest")
   Dim key As String
   For Each key In  appSettings.AllKeys
         Console.WriteLine("Name: {0} Value: {1}", _
         key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
End Sub

Keterangan

Untuk mendapatkan Configuration objek untuk sumber daya, kode Anda harus memiliki hak istimewa baca pada semua file konfigurasi tempatnya mewarisi pengaturan. Untuk memperbarui file konfigurasi, kode Anda juga harus memiliki hak tulis untuk file konfigurasi dan direktori tempatnya ada.

Lihat juga

Configuration

Berlaku untuk

OpenWebConfiguration(String, String)

Membuka file konfigurasi Aplikasi web sebagai objek menggunakan Configuration jalur virtual dan nama situs yang ditentukan untuk mengizinkan operasi baca atau tulis.

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path, System::String ^ site);

public static System.Configuration.Configuration OpenWebConfiguration (string path, string site);

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

Public Shared Function OpenWebConfiguration (path As String, site As String) As Configuration

Parameter

path: String

Jalur virtual ke file konfigurasi.

site: String

Nama situs Web aplikasi, seperti yang ditampilkan dalam konfigurasi Internet Information Services (IIS).

Mengembalikan

Configuration

Objek Configuration.

Pengecualian

ConfigurationErrorsException

File konfigurasi yang valid tidak dapat dimuat.

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan OpenWebConfiguration metode .


// Show how to use OpenWebConfiguration(string, string).
// It gets he appSettings section of a Web application 
// runnig on the local server. 
static void OpenWebConfiguration2()
{
    // Get the configuration object for a Web application
    // running on the local server. 
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenWebConfiguration("/configTest", 
        "Default Web Site")
        as System.Configuration.Configuration;

    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine(
        "[appSettings for app at: /configTest");
    Console.WriteLine(" and site: Default Web Site]");

    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string, string).
' It gets he appSettings section of a Web application 
' runnig on the local server. 
Shared Sub OpenWebConfiguration2()
   ' Get the configuration object for a Web application
   ' running on the local server. 
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenWebConfiguration( _
     "/configTest", "Default Web Site")
   
   ' Get the appSettings.
     Dim appSettings As KeyValueConfigurationCollection = _
     config.AppSettings.Settings
   
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
   Console.WriteLine("[appSettings for app at: /configTest")
   Console.WriteLine(" and site: Default Web Site]")
   
   Dim key As String
   For Each key In  appSettings.AllKeys
         Console.WriteLine("Name: {0} Value: {1}", _
         key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
End Sub

Keterangan

Lihat juga

Configuration

Berlaku untuk

OpenWebConfiguration(String, String, String)

Membuka file konfigurasi Aplikasi web sebagai objek menggunakan Configuration jalur virtual, nama situs, dan lokasi yang ditentukan untuk mengizinkan operasi baca atau tulis.

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path, System::String ^ site, System::String ^ locationSubPath);

public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath);

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

Public Shared Function OpenWebConfiguration (path As String, site As String, locationSubPath As String) As Configuration

Parameter

path: String

Jalur virtual ke file konfigurasi.

site: String

Nama situs Web aplikasi, seperti yang ditampilkan dalam konfigurasi Internet Information Services (IIS).

locationSubPath: String

Sumber daya khusus yang diterapkan konfigurasi.

Mengembalikan

Configuration

Objek Configuration.

Pengecualian

ConfigurationErrorsException

File konfigurasi yang valid tidak dapat dimuat.

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan OpenWebConfiguration metode .


// Show how to use OpenWebConfiguration(string, string, string).
// It gets he appSettings section of a Web application 
// runnig on the local server. 
static void OpenWebConfiguration3()
{
    // Get the configuration object for a Web application
    // running on the local server. 
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenWebConfiguration(
        "/configTest", "Default Web Site", null)
        as System.Configuration.Configuration;

    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine(
        "[appSettings for app at: /configTest");
    Console.WriteLine(" site: Default Web Site");
    Console.WriteLine(" and locationSubPath: null]");
    
    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string, string, string).
' It gets he appSettings section of a Web application 
' runnig on the local server. 
Shared Sub OpenWebConfiguration3()
   ' Get the configuration object for a Web application
   ' running on the local server. 
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenWebConfiguration( _
     "/configTest", "Default Web Site", Nothing)
   
   ' Get the appSettings.
     Dim appSettings As KeyValueConfigurationCollection = _
     config.AppSettings.Settings
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
   Console.WriteLine("[appSettings for app at: /configTest")
   Console.WriteLine(" site: Default Web Site")
   Console.WriteLine(" and locationSubPath: null]")
   
   Dim key As String
   For Each key In  appSettings.AllKeys
         Console.WriteLine("Name: {0} Value: {1}", _
         key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
End Sub

Keterangan

Lihat juga

Configuration

Berlaku untuk

OpenWebConfiguration(String, String, String, String)

Membuka file konfigurasi Aplikasi web sebagai Configuration objek menggunakan jalur virtual, nama situs, lokasi, dan server yang ditentukan untuk mengizinkan operasi baca atau tulis.

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path, System::String ^ site, System::String ^ locationSubPath, System::String ^ server);

public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath, string server);

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

Public Shared Function OpenWebConfiguration (path As String, site As String, locationSubPath As String, server As String) As Configuration

Parameter

path: String

Jalur virtual ke file konfigurasi.

site: String

Nama situs Web aplikasi, seperti yang ditampilkan dalam konfigurasi Internet Information Services (IIS).

locationSubPath: String

Sumber daya khusus yang diterapkan konfigurasi.

server: String

Nama jaringan server tempat aplikasi Web berada.

Mengembalikan

Configuration

Objek Configuration.

Pengecualian

ArgumentException

Parameter server tidak valid.

ConfigurationErrorsException

File konfigurasi yang valid tidak dapat dimuat.

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan OpenWebConfiguration metode .


// Show how to use OpenWebConfiguration(string, string, 
// string, string).
// It gets he appSettings section of a Web application 
// running on the specified server. 
// If the server is remote your application must have the
// required access rights to the configuration file. 
static void OpenWebConfiguration4()
{
    // Get the configuration object for a Web application
    // running on the specified server.
    // Null for the subPath signifies no subdir. 
    System.Configuration.Configuration config =
           WebConfigurationManager.OpenWebConfiguration(
            "/configTest", "Default Web Site", null, "myServer")
           as System.Configuration.Configuration;
    
    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine("[appSettings for Web app on server: myServer]");
    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string, string, 
' string, string).
' It gets he appSettings section of a Web application 
' running on the specified server. 
' If the server is remote your application must have the
' required access rights to the configuration file. 
Shared Sub OpenWebConfiguration4()
   ' Get the configuration object for a Web application
   ' running on the specified server.
   ' Null for the subPath signifies no subdir. 
   Dim config As System.Configuration.Configuration = WebConfigurationManager.OpenWebConfiguration("/configTest", "Default Web Site", Nothing, "myServer")
   
   ' Get the appSettings.
   Dim appSettings As KeyValueConfigurationCollection = config.AppSettings.Settings
   
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
   Console.WriteLine("[appSettings for Web app on server: myServer]")
   Dim key As String
   For Each key In  appSettings.AllKeys
      Console.WriteLine("Name: {0} Value: {1}", key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
End Sub

Keterangan

Untuk mendapatkan Configuration objek untuk sumber daya jarak jauh, kode Anda harus memiliki hak administratif di komputer jarak jauh.

Lihat juga

Configuration

Berlaku untuk

OpenWebConfiguration(String, String, String, String, IntPtr)

Membuka file konfigurasi Aplikasi web sebagai Configuration objek menggunakan jalur virtual, nama situs, lokasi, server, dan konteks keamanan yang ditentukan untuk mengizinkan operasi baca atau tulis.

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path, System::String ^ site, System::String ^ locationSubPath, System::String ^ server, IntPtr userToken);

public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath, string server, IntPtr userToken);

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

Public Shared Function OpenWebConfiguration (path As String, site As String, locationSubPath As String, server As String, userToken As IntPtr) As Configuration

Parameter

path: String

Jalur virtual ke file konfigurasi.

site: String

Nama situs Web aplikasi, seperti yang ditampilkan dalam konfigurasi Internet Information Services (IIS).

locationSubPath: String

Sumber daya khusus yang diterapkan konfigurasi.

server: String

Nama jaringan server tempat aplikasi Web berada.

userToken: IntPtr
nativeint

Token akun yang akan digunakan.

Mengembalikan

Configuration

Objek Configuration.

Pengecualian

ArgumentException

Parameter server atau userToken tidak valid.

ConfigurationErrorsException

File konfigurasi yang valid tidak dapat dimuat.

Contoh

Contoh berikut menunjukkan cara menggunakan OpenWebConfiguration metode untuk mengakses informasi konfigurasi.


// Show how to use OpenWebConfiguration(string, string, 
// string, string, IntPtr).
// It gets he appSettings section of a Web application 
// running on a remote server. 
// If the serve is remote your application shall have the
// requires access rights to the configuration file. 
static void OpenWebConfiguration6()
{

    IntPtr userToken = 
        System.Security.Principal.WindowsIdentity.GetCurrent().Token;
   
    string user = 
        System.Security.Principal.WindowsIdentity.GetCurrent().Name;
    
    // Get the configuration object for a Web application
    // running on a remote server.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenWebConfiguration(
        "/configTest", "Default Web Site", null, 
        "myServer", userToken) as System.Configuration.Configuration;

    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine(
        "[appSettings for Web app on server: myServer user: {0}]", user);
    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string, string, 
' string, string, IntPtr).
' It gets he appSettings section of a Web application 
' running on a remote server. 
' If the serve is remote your application shall have the
' requires access rights to the configuration file. 
Shared Sub OpenWebConfiguration6()
   
     Dim userToken As IntPtr = _
     System.Security.Principal.WindowsIdentity.GetCurrent().Token
   
     Dim user As String = _
     System.Security.Principal.WindowsIdentity.GetCurrent().Name
   
   ' Get the configuration object for a Web application
   ' running on a remote server.
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenWebConfiguration( _
     "/configTest", "Default Web Site", _
     Nothing, "myServer", userToken)
   
   ' Get the appSettings.
     Dim appSettings As KeyValueConfigurationCollection = _
     config.AppSettings.Settings
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
     Console.WriteLine( _
     "[appSettings for Web app on server: myServer user: {0}]", user)
   Dim key As String
   For Each key In  appSettings.AllKeys
         Console.WriteLine("Name: {0} Value: {1}", _
         key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
End Sub

Keterangan

Metode ini digunakan untuk mengakses file konfigurasi menggunakan peniruan identitas.

Catatan

Token akun biasanya diambil dari instans WindowsIdentity kelas atau melalui panggilan ke kode yang tidak dikelola, seperti panggilan ke Windows API LogonUser. Untuk informasi selengkapnya tentang panggilan ke kode yang tidak dikelola, lihat Mengonsumsi Fungsi DLL Yang Tidak Dikelola.

Untuk mendapatkan Configuration objek untuk sumber daya jarak jauh, kode Anda harus memiliki hak administratif di komputer jarak jauh.

Lihat juga

Berlaku untuk

OpenWebConfiguration(String, String, String, String, String, String)

public:
 static System::Configuration::Configuration ^ OpenWebConfiguration(System::String ^ path, System::String ^ site, System::String ^ locationSubPath, System::String ^ server, System::String ^ userName, System::String ^ password);

public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath, string server, string userName, string password);

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

Public Shared Function OpenWebConfiguration (path As String, site As String, locationSubPath As String, server As String, userName As String, password As String) As Configuration

Parameter

path: String

Jalur virtual ke file konfigurasi.

site: String

Nama situs Web aplikasi, seperti yang ditampilkan dalam konfigurasi Internet Information Services (IIS).

locationSubPath: String

Sumber daya khusus yang diterapkan konfigurasi.

server: String

Nama jaringan server tempat aplikasi Web berada.

userName: String

Nama pengguna lengkap (Domain\User) yang digunakan saat membuka file.

password: String

Kata sandi untuk nama pengguna.

Mengembalikan

Configuration

Objek Configuration.

Pengecualian

ArgumentException

Parameter server atau userName dan password tidak valid.

ConfigurationErrorsException

Tidak dapat memuat file konfigurasi yang valid.

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan OpenWebConfiguration metode .


// Show how to use OpenWebConfiguration(string, string, 
// string, string, string, string).
// It gets he appSettings section of a Web application 
// running on a remote server. 
// If the server is remote your application must have the
// required access rights to the configuration file. 
static void OpenWebConfiguration5()
{
    // Get the current user.
    string user =
        System.Security.Principal.WindowsIdentity.GetCurrent().Name;
    
    // Assign the actual password.
    string password = "userPassword";

    // Get the configuration object for a Web application
    // running on a remote server.
    System.Configuration.Configuration config =
        WebConfigurationManager.OpenWebConfiguration(
        "/configTest", "Default Web Site", null, "myServer",
        user, password) as System.Configuration.Configuration;

    // Get the appSettings.
    KeyValueConfigurationCollection appSettings =
         config.AppSettings.Settings;

    // Loop through the collection and
    // display the appSettings key, value pairs.
    Console.WriteLine(
        "[appSettings for Web app on server: myServer user: {0}]", user);
    foreach (string key in appSettings.AllKeys)
    {
        Console.WriteLine("Name: {0} Value: {1}",
        key, appSettings[key].Value);
    }

    Console.WriteLine();
}

' Show how to use OpenWebConfiguration(string, string, 
' string, string, string, string).
' It gets he appSettings section of a Web application 
' running on a remote server. 
' If the server is remote your application must have the
' required access rights to the configuration file. 
Shared Sub OpenWebConfiguration5()
   ' Get the current user.
     Dim user As String = _
     System.Security.Principal.WindowsIdentity.GetCurrent().Name
   
   ' Assign the actual password.
   Dim password As String = "userPassword"
   
   ' Get the configuration object for a Web application
   ' running on a remote server.
     Dim config As System.Configuration.Configuration = _
     WebConfigurationManager.OpenWebConfiguration( _
     "/configTest", "Default Web Site", _
     Nothing, "myServer", user, password)
   
   ' Get the appSettings.
     Dim appSettings As KeyValueConfigurationCollection = _
     config.AppSettings.Settings
   
   
   ' Loop through the collection and
   ' display the appSettings key, value pairs.
     Console.WriteLine( _
     "[appSettings for Web app on server: myServer user: {0}]", user)
   Dim key As String
   For Each key In  appSettings.AllKeys
         Console.WriteLine("Name: {0} Value: {1}", _
         key, appSettings(key).Value)
   Next key
   
   Console.WriteLine()
End Sub

Keterangan

Metode ini digunakan untuk mengakses file konfigurasi menggunakan peniruan identitas.

Untuk mendapatkan Configuration objek untuk sumber daya jarak jauh, kode Anda harus memiliki hak administratif di komputer jarak jauh.

Anda mungkin perlu menjalankan Alat Pendaftaran IIS ASP.NET (Aspnet_regiis.exe) dengan -config+ opsi untuk mengaktifkan akses ke file konfigurasi di komputer jarak jauh.

Lihat juga

Berlaku untuk

Bagikan melalui

WebConfigurationManager.OpenWebConfiguration Metode

Definisi

Overload

OpenWebConfiguration(String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

OpenWebConfiguration(String, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

OpenWebConfiguration(String, String, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

OpenWebConfiguration(String, String, String, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

OpenWebConfiguration(String, String, String, String, IntPtr)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

OpenWebConfiguration(String, String, String, String, String, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: