System.AppDomain.GetData 方法
方法描述
为指定名称获取存储在当前应用程序域中的值。
语法定义(C# System.AppDomain.GetData 方法 的用法)
public Object GetData( string name )
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| name | System-String | 预定义应用程序域属性的名称，或已定义的应用程序域属性的名称。 |
| 返回值 | System.Object | name 属性的值，或 null （如果属性不存在）。 |
提示和注释
使用此方法可在内部缓存的名称数据对中检索项的值，这些名称数据对描述 AppDomain 此实例的属性。
该缓存自动包含在创建应用程序域时插入的预定义的系统项。 您可使用 GetData 方法或等效的 AppDomainSetup 属性检查它们的值。
您可使用 SetData 方法插入或修改用户定义的名称数据对，以及使用 GetData 方法检查它们的值。
下表介绍了每个预定义系统项的 name 及其相应的 AppDomainSetup 属性。
“name”的值
Property
"APPBASE"
ApplicationBase
"LOADER_OPTIMIZATION"
LoaderOptimization
"APP_CONFIG_FILE"
ConfigurationFile
"DYNAMIC_BASE"
DynamicBase
"DEV_PATH"
（无属性）
"APP_NAME"
ApplicationName
"PRIVATE_BINPATH"
PrivateBinPath
"BINPATH_PROBE_ONLY"
PrivateBinPathProbe
"SHADOW_COPY_DIRS"
ShadowCopyDirectories
"FORCE_CACHE_INSTALL"
ShadowCopyFiles
"CACHE_BASE"
CachePath
（应用程序特定的）
LicenseFile
"APP_LAUNCH_URL"
（无属性）
注意
“APP_LAUNCH_URL”表示进行任何重定向之前由用户最初请求的 URL。 仅当用浏览器（如 Internet Explorer）启动应用程序时，它才可用。 并非所有浏览器都提供此值。
System.AppDomain.GetData 方法例子
然后，此示例演示如何使用 GetData 方法从这些值对检索数据，并将其显示在控制台中。
using System;
using System.Reflection;
class ADGetData
{
public static void Main()
{
// appdomain setup information
AppDomain currentDomain = AppDomain.CurrentDomain;
//Create a new value pair for the appdomain
currentDomain.SetData("ADVALUE", "Example value");
//get the value specified in the setdata method
Console.WriteLine("ADVALUE is: " + currentDomain.GetData("ADVALUE"));
//get a system value specified at appdomainsetup
Console.WriteLine("System value for loader optimization: {0}",
currentDomain.GetData("LOADER_OPTIMIZATION"));
}
}
/* This code example produces the following output:
ADVALUE is: Example value
System value for loader optimization: NotSpecified
*/
异常
| 异常 | 异常描述 |
|---|---|
| ArgumentNullException | name 为 null。 |
| AppDomainUnloadedException | 尝试对已卸载的应用程序域进行操作。 |
版本信息
.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。