WebConfigurationManager.OpenMappedWebConfiguration Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini kullanarak bir Configuration nesne olarak açar.
Aşırı Yüklemeler
OpenMappedWebConfiguration(WebConfigurationFileMap, String) |
Belirtilen Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini ve sanal yolu kullanarak bir Configuration nesne olarak açar. |
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String) |
Belirtilen Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini, sanal yolu ve site adını kullanarak bir Configuration nesne olarak açar. |
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String) |
Belirtilen Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini, sanal yolu, site adını ve konumu kullanarak bir Configuration nesne olarak açar. |
Örnekler
Aşağıdaki örnekte, sanal dizin hiyerarşisinin fiziksel bir dizinle nasıl eş adım adım gösterildiği gösterilmiştir. Burada gösterilen örnek aşırı yüklenmiş üyelerde kullanılır.
// Utility to map virtual directories to physical ones.
// In the current physical directory maps
// a physical sub-directory with its virtual directory.
// A web.config file is created for the
// default and the virtual directory at the appropriate level.
// You must create a physical directory called config at the
// level where your app is running.
static WebConfigurationFileMap CreateFileMap()
{
WebConfigurationFileMap fileMap =
new WebConfigurationFileMap();
// Get he physical directory where this app runs.
// We'll use it to map the virtual directories
// defined next.
string physDir = Environment.CurrentDirectory;
// Create a VirtualDirectoryMapping object to use
// as the root directory for the virtual directory
// named config.
// Note: you must assure that you have a physical subdirectory
// named config in the curremt physical directory where this
// application runs.
VirtualDirectoryMapping vDirMap =
new VirtualDirectoryMapping(physDir + "\\config", true);
// Add vDirMap to the VirtualDirectories collection
// assigning to it the virtual directory name.
fileMap.VirtualDirectories.Add("/config", vDirMap);
// Create a VirtualDirectoryMapping object to use
// as the default directory for all the virtual
// directories.
VirtualDirectoryMapping vDirMapBase =
new VirtualDirectoryMapping(physDir, true, "web.config");
// Add it to the virtual directory mapping collection.
fileMap.VirtualDirectories.Add("/", vDirMapBase);
# if DEBUG
// Test at debug time.
foreach (string key in fileMap.VirtualDirectories.AllKeys)
{
Console.WriteLine("Virtual directory: {0} Physical path: {1}",
fileMap.VirtualDirectories[key].VirtualDirectory,
fileMap.VirtualDirectories[key].PhysicalDirectory);
}
# endif
// Return the mapping.
return fileMap;
}
' Utility to map virtual directories to physical ones.
' In the current physical directory maps
' a physical sub-directory with its virtual directory.
' A web.config file is created for the
' default and the virtual directory at the appropriate level.
'You must create a physical directory called config at the
'level where your app is running.
Shared Function CreateFileMap() As WebConfigurationFileMap
Dim fileMap As New WebConfigurationFileMap()
' Get he physical directory where this app runs.
' We'll use it to map the virtual directories
' defined next.
Dim physDir As String = Environment.CurrentDirectory
' Create a VirtualDirectoryMapping object to use
' as the root directory for the virtual directory
' named config.
' Note: you must assure that you have a physical subdirectory
' named config in the curremt physical directory where this
' application runs.
Dim vDirMap As New VirtualDirectoryMapping(physDir + _
"\config", True)
' Add vDirMap to the VirtualDirectories collection
' assigning to it the virtual directory name.
fileMap.VirtualDirectories.Add("/config", vDirMap)
' Create a VirtualDirectoryMapping object to use
' as the default directory for all the virtual
' directories.
Dim vDirMapBase As New VirtualDirectoryMapping(physDir, _
True, "web.config")
' Add it to the virtual directory mapping collection.
fileMap.VirtualDirectories.Add("/", vDirMapBase)
#If DEBUG Then
Dim key As String
For Each key In fileMap.VirtualDirectories.AllKeys
Console.WriteLine("Virtual directory: {0} Physical path: {1}", _
fileMap.VirtualDirectories(key).VirtualDirectory, _
fileMap.VirtualDirectories(key).PhysicalDirectory)
Next key
#End If
' Return the mapping.
Return fileMap
End Function 'CreateFileMap
Açıklamalar
Sanal dizin hiyerarşinizi bir fiziksel dizine eşlemeniz gerektiğinde eşleme mekanizmasını kullanırsınız.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)
Belirtilen Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini ve sanal yolu kullanarak bir Configuration nesne olarak açar.
public:
static System::Configuration::Configuration ^ OpenMappedWebConfiguration(System::Web::Configuration::WebConfigurationFileMap ^ fileMap, System::String ^ path);
public static System.Configuration.Configuration OpenMappedWebConfiguration (System.Web.Configuration.WebConfigurationFileMap fileMap, string path);
static member OpenMappedWebConfiguration : System.Web.Configuration.WebConfigurationFileMap * string -> System.Configuration.Configuration
Public Shared Function OpenMappedWebConfiguration (fileMap As WebConfigurationFileMap, path As String) As Configuration
Parametreler
- fileMap
- WebConfigurationFileMap
WebConfigurationFileMap Varsayılan Web uygulaması yapılandırma dosyası yerine kullanılacak nesne.
- path
- String
Yapılandırma dosyasının sanal yolu.
Döndürülenler
Bir Configuration nesnesi.
Özel durumlar
Geçerli bir yapılandırma dosyası yüklenemedi.
Örnekler
Aşağıdaki örnekte yönteminin nasıl kullanılacağı gösterilmektedir OpenMappedWebConfiguration .
// Show how to use the OpenMappedWebConfiguration(
// WebConfigurationFileMap, string)
static void OpenMappedWebConfiguration1()
{
// Create the configuration directories mapping.
WebConfigurationFileMap fileMap =
CreateFileMap();
try
{
// Get the Configuration object for the mapped
// virtual directory.
System.Configuration.Configuration config =
WebConfigurationManager.OpenMappedWebConfiguration(fileMap,
"/config");
// Define a nique key for the creation of
// an appSettings element entry.
int appStgCnt = config.AppSettings.Settings.Count;
string asName = "AppSetting" + appStgCnt.ToString();
// Add a new element to the appSettings.
config.AppSettings.Settings.Add(asName,
DateTime.Now.ToLongDateString() + " " +
DateTime.Now.ToLongTimeString());
// Save to the configuration file.
config.Save(ConfigurationSaveMode.Modified);
// Display new appSettings.
Console.WriteLine("Count: [{0}]", config.AppSettings.Settings.Count);
foreach (string key in config.AppSettings.Settings.AllKeys)
{
Console.WriteLine("[{0}] = [{1}]", key,
config.AppSettings.Settings[key].Value);
}
}
catch (InvalidOperationException err)
{
Console.WriteLine(err.ToString());
}
Console.WriteLine();
}
' Show how to use the OpenMappedWebConfiguration(
' WebConfigurationFileMap, string)
Shared Sub OpenMappedWebConfiguration1()
' Create the configuration directories mapping.
Dim fileMap As WebConfigurationFileMap = CreateFileMap()
Try
' Get the Configuration object for the mapped
' virtual directory.
Dim config As System.Configuration.Configuration = _
WebConfigurationManager.OpenMappedWebConfiguration( _
fileMap, "/config")
' Define a nique key for the creation of
' an appSettings element entry.
Dim appStgCnt As Integer = config.AppSettings.Settings.Count
Dim asName As String = "AppSetting" + appStgCnt.ToString()
' Add a new element to the appSettings.
config.AppSettings.Settings.Add(asName, _
DateTime.Now.ToLongDateString() + " " + _
DateTime.Now.ToLongTimeString())
' Save to the configuration file.
config.Save(ConfigurationSaveMode.Modified)
' Display new appSettings.
Console.WriteLine("Count: [{0}]", _
config.AppSettings.Settings.Count)
Dim key As String
For Each key In config.AppSettings.Settings.AllKeys
Console.WriteLine("[{0}] = [{1}]", _
key, config.AppSettings.Settings(key).Value)
Next key
Catch err As InvalidOperationException
Console.WriteLine(err.ToString())
End Try
Console.WriteLine()
End Sub
Yukarıdaki örnekte, bir ConfigurationFileMap nesne oluşturmak için aşağıdaki özel yöntem kullanılır.
// Utility to map virtual directories to physical ones.
// In the current physical directory maps
// a physical sub-directory with its virtual directory.
// A web.config file is created for the
// default and the virtual directory at the appropriate level.
// You must create a physical directory called config at the
// level where your app is running.
static WebConfigurationFileMap CreateFileMap()
{
WebConfigurationFileMap fileMap =
new WebConfigurationFileMap();
// Get he physical directory where this app runs.
// We'll use it to map the virtual directories
// defined next.
string physDir = Environment.CurrentDirectory;
// Create a VirtualDirectoryMapping object to use
// as the root directory for the virtual directory
// named config.
// Note: you must assure that you have a physical subdirectory
// named config in the curremt physical directory where this
// application runs.
VirtualDirectoryMapping vDirMap =
new VirtualDirectoryMapping(physDir + "\\config", true);
// Add vDirMap to the VirtualDirectories collection
// assigning to it the virtual directory name.
fileMap.VirtualDirectories.Add("/config", vDirMap);
// Create a VirtualDirectoryMapping object to use
// as the default directory for all the virtual
// directories.
VirtualDirectoryMapping vDirMapBase =
new VirtualDirectoryMapping(physDir, true, "web.config");
// Add it to the virtual directory mapping collection.
fileMap.VirtualDirectories.Add("/", vDirMapBase);
# if DEBUG
// Test at debug time.
foreach (string key in fileMap.VirtualDirectories.AllKeys)
{
Console.WriteLine("Virtual directory: {0} Physical path: {1}",
fileMap.VirtualDirectories[key].VirtualDirectory,
fileMap.VirtualDirectories[key].PhysicalDirectory);
}
# endif
// Return the mapping.
return fileMap;
}
' Utility to map virtual directories to physical ones.
' In the current physical directory maps
' a physical sub-directory with its virtual directory.
' A web.config file is created for the
' default and the virtual directory at the appropriate level.
'You must create a physical directory called config at the
'level where your app is running.
Shared Function CreateFileMap() As WebConfigurationFileMap
Dim fileMap As New WebConfigurationFileMap()
' Get he physical directory where this app runs.
' We'll use it to map the virtual directories
' defined next.
Dim physDir As String = Environment.CurrentDirectory
' Create a VirtualDirectoryMapping object to use
' as the root directory for the virtual directory
' named config.
' Note: you must assure that you have a physical subdirectory
' named config in the curremt physical directory where this
' application runs.
Dim vDirMap As New VirtualDirectoryMapping(physDir + _
"\config", True)
' Add vDirMap to the VirtualDirectories collection
' assigning to it the virtual directory name.
fileMap.VirtualDirectories.Add("/config", vDirMap)
' Create a VirtualDirectoryMapping object to use
' as the default directory for all the virtual
' directories.
Dim vDirMapBase As New VirtualDirectoryMapping(physDir, _
True, "web.config")
' Add it to the virtual directory mapping collection.
fileMap.VirtualDirectories.Add("/", vDirMapBase)
#If DEBUG Then
Dim key As String
For Each key In fileMap.VirtualDirectories.AllKeys
Console.WriteLine("Virtual directory: {0} Physical path: {1}", _
fileMap.VirtualDirectories(key).VirtualDirectory, _
fileMap.VirtualDirectories(key).PhysicalDirectory)
Next key
#End If
' Return the mapping.
Return fileMap
End Function 'CreateFileMap
OpenMachineConfiguration Sanal dizin hiyerarşisini fiziksel dizin hiyerarşisine eşlemeyi gösteren bir örnek için bkz.
Açıklamalar
Bir kaynağın Configuration nesnesini almak için kodunuzun ayarları devraldığı tüm yapılandırma dosyalarında okuma ayrıcalıklarına sahip olması gerekir. Bir yapılandırma dosyasını güncelleştirmek için kodunuzun hem yapılandırma dosyası hem de bulunduğu dizin için yazma ayrıcalıklarına sahip olması gerekir.
Ayrıca bkz.
Şunlara uygulanır
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)
Belirtilen Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini, sanal yolu ve site adını kullanarak bir Configuration nesne olarak açar.
public:
static System::Configuration::Configuration ^ OpenMappedWebConfiguration(System::Web::Configuration::WebConfigurationFileMap ^ fileMap, System::String ^ path, System::String ^ site);
public static System.Configuration.Configuration OpenMappedWebConfiguration (System.Web.Configuration.WebConfigurationFileMap fileMap, string path, string site);
static member OpenMappedWebConfiguration : System.Web.Configuration.WebConfigurationFileMap * string * string -> System.Configuration.Configuration
Public Shared Function OpenMappedWebConfiguration (fileMap As WebConfigurationFileMap, path As String, site As String) As Configuration
Parametreler
- fileMap
- WebConfigurationFileMap
WebConfigurationFileMap Varsayılan Web uygulaması yapılandırma-dosyası eşlemesi yerine kullanılacak nesne.
- path
- String
Yapılandırma dosyasının sanal yolu.
- site
- String
Internet Information Services (IIS) yapılandırmasında gösterildiği gibi uygulama Web sitesinin adı.
Döndürülenler
Bir Configuration nesnesi.
Özel durumlar
Geçerli bir yapılandırma dosyası yüklenemedi.
Örnekler
Aşağıdaki örnekte yönteminin nasıl kullanılacağı gösterilmektedir OpenMappedWebConfiguration .
// Show how to use the OpenMappedWebConfiguration(
// WebConfigurationFileMap, string, string).
static void OpenMappedWebConfiguration2()
{
// Create the configuration directories mapping.
WebConfigurationFileMap fileMap =
CreateFileMap();
try
{
// Get the Configuration object for the mapped
// virtual directory.
System.Configuration.Configuration config =
WebConfigurationManager.OpenMappedWebConfiguration(
fileMap, "/config", "config");
// Define a nique key for the creation of
// an appSettings element entry.
int appStgCnt = config.AppSettings.Settings.Count;
string asName = "AppSetting" + appStgCnt.ToString();
// Add a new element to the appSettings.
config.AppSettings.Settings.Add(asName,
DateTime.Now.ToLongDateString() + " " +
DateTime.Now.ToLongTimeString());
// Save to the configuration file.
config.Save(ConfigurationSaveMode.Modified);
// Display new appSettings.
Console.WriteLine("Count: [{0}]",
config.AppSettings.Settings.Count);
foreach (string key in config.AppSettings.Settings.AllKeys)
{
Console.WriteLine("[{0}] = [{1}]", key,
config.AppSettings.Settings[key].Value);
}
}
catch (InvalidOperationException err)
{
Console.WriteLine(err.ToString());
}
Console.WriteLine();
}
' Show how to use the OpenMappedWebConfiguration(
' WebConfigurationFileMap, string, string).
Shared Sub OpenMappedWebConfiguration2()
' Create the configuration directories mapping.
Dim fileMap As WebConfigurationFileMap = CreateFileMap()
Try
' Get the Configuration object for the mapped
' virtual directory.
Dim config As System.Configuration.Configuration = _
WebConfigurationManager.OpenMappedWebConfiguration( _
fileMap, "/config", "config")
' Define a nique key for the creation of
' an appSettings element entry.
Dim appStgCnt As Integer = config.AppSettings.Settings.Count
Dim asName As String = "AppSetting" + appStgCnt.ToString()
' Add a new element to the appSettings.
config.AppSettings.Settings.Add(asName, _
DateTime.Now.ToLongDateString() + " " + _
DateTime.Now.ToLongTimeString())
' Save to the configuration file.
config.Save(ConfigurationSaveMode.Modified)
' Display new appSettings.
Console.WriteLine("Count: [{0}]", _
config.AppSettings.Settings.Count)
Dim key As String
For Each key In config.AppSettings.Settings.AllKeys
Console.WriteLine("[{0}] = [{1}]", _
key, config.AppSettings.Settings(key).Value)
Next key
Catch err As InvalidOperationException
Console.WriteLine(err.ToString())
End Try
Console.WriteLine()
End Sub
OpenMachineConfiguration Sanal dizin hiyerarşisini fiziksel dizin hiyerarşisine eşlemeyi gösteren bir örnek için bkz.
Açıklamalar
Bir kaynağın Configuration nesnesini almak için kodunuzun ayarları devraldığı tüm yapılandırma dosyalarında okuma ayrıcalıklarına sahip olması gerekir. Bir yapılandırma dosyasını güncelleştirmek için kodunuzun hem yapılandırma dosyası hem de bulunduğu dizin için yazma ayrıcalıklarına sahip olması gerekir.
Ayrıca bkz.
Şunlara uygulanır
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)
Belirtilen Web uygulaması yapılandırma dosyasını, okuma veya yazma işlemlerine izin vermek için belirtilen dosya eşlemesini, sanal yolu, site adını ve konumu kullanarak bir Configuration nesne olarak açar.
public:
static System::Configuration::Configuration ^ OpenMappedWebConfiguration(System::Web::Configuration::WebConfigurationFileMap ^ fileMap, System::String ^ path, System::String ^ site, System::String ^ locationSubPath);
public static System.Configuration.Configuration OpenMappedWebConfiguration (System.Web.Configuration.WebConfigurationFileMap fileMap, string path, string site, string locationSubPath);
static member OpenMappedWebConfiguration : System.Web.Configuration.WebConfigurationFileMap * string * string * string -> System.Configuration.Configuration
Public Shared Function OpenMappedWebConfiguration (fileMap As WebConfigurationFileMap, path As String, site As String, locationSubPath As String) As Configuration
Parametreler
- fileMap
- WebConfigurationFileMap
WebConfigurationFileMap Varsayılan Web uygulaması yapılandırma-dosyası eşlemesi yerine kullanılacak nesne.
- path
- String
Yapılandırma dosyasının sanal yolu.
- site
- String
Internet Information Services (IIS) yapılandırmasında gösterildiği gibi uygulama Web sitesinin adı.
- locationSubPath
- String
Yapılandırmanın geçerli olduğu kaynak.
Döndürülenler
Bir Configuration nesnesi.
Özel durumlar
Geçerli bir yapılandırma dosyası yüklenemedi.
Örnekler
Aşağıdaki örnekte yönteminin nasıl kullanılacağı gösterilmektedir OpenMappedWebConfiguration .
// Show how to use the OpenMappedWebConfiguration(
// WebConfigurationFileMap, string, string, string).
static void OpenMappedWebConfiguration3()
{
// Create the configuration directories mapping.
WebConfigurationFileMap fileMap =
CreateFileMap();
try
{
// Get the Configuration object for the mapped
// virtual directory.
System.Configuration.Configuration config =
WebConfigurationManager.OpenMappedWebConfiguration(
fileMap, "/config", "config", "config");
// Define a nique key for the creation of
// an appSettings element entry.
int appStgCnt = config.AppSettings.Settings.Count;
string asName = "AppSetting" + appStgCnt.ToString();
// Add a new element to the appSettings.
config.AppSettings.Settings.Add(asName,
DateTime.Now.ToLongDateString() + " " +
DateTime.Now.ToLongTimeString());
// Save to the configuration file.
config.Save(ConfigurationSaveMode.Modified);
// Display new appSettings.
Console.WriteLine("Count: [{0}]",
config.AppSettings.Settings.Count);
foreach (string key in config.AppSettings.Settings.AllKeys)
{
Console.WriteLine("[{0}] = [{1}]", key,
config.AppSettings.Settings[key].Value);
}
}
catch (InvalidOperationException err)
{
Console.WriteLine(err.ToString());
}
Console.WriteLine();
}
' Show how to use the OpenMappedWebConfiguration(
' WebConfigurationFileMap, string, string, string).
Shared Sub OpenMappedWebConfiguration3()
' Create the configuration directories mapping.
Dim fileMap As WebConfigurationFileMap = CreateFileMap()
Try
' Get the Configuration object for the mapped
' virtual directory.
Dim config As System.Configuration.Configuration = _
WebConfigurationManager.OpenMappedWebConfiguration( _
fileMap, "/config", "config", "config")
' Define a nique key for the creation of
' an appSettings element entry.
Dim appStgCnt As Integer = config.AppSettings.Settings.Count
Dim asName As String = "AppSetting" + appStgCnt.ToString()
' Add a new element to the appSettings.
config.AppSettings.Settings.Add(asName, _
DateTime.Now.ToLongDateString() + " " + _
DateTime.Now.ToLongTimeString())
' Save to the configuration file.
config.Save(ConfigurationSaveMode.Modified)
' Display new appSettings.
Console.WriteLine("Count: [{0}]", _
config.AppSettings.Settings.Count)
Dim key As String
For Each key In config.AppSettings.Settings.AllKeys
Console.WriteLine("[{0}] = [{1}]", _
key, config.AppSettings.Settings(key).Value)
Next key
Catch err As InvalidOperationException
Console.WriteLine(err.ToString())
End Try
Console.WriteLine()
End Sub
OpenMachineConfiguration Sanal dizin hiyerarşisini fiziksel dizin hiyerarşisine eşlemeyi gösteren bir örnek için bkz.
Açıklamalar
Bir kaynağın Configuration nesnesini almak için kodunuzun ayarları devraldığı tüm yapılandırma dosyalarında okuma ayrıcalıklarına sahip olması gerekir. Bir yapılandırma dosyasını güncelleştirmek için kodunuzun hem yapılandırma dosyası hem de bulunduğu dizin için yazma ayrıcalıklarına sahip olması gerekir.