# dotNet.clr 库模块帮助文档

## dotNet 成员列表 <a id="dotNet" href="#dotNet">&#x23;</a>

### dotNet.clr <a id="dotNet.clr" href="#dotNet.clr">&#x23;</a>
CLR 运行时支持库。  
导入此库时如果当前是主线程则将应用程序根目录（"/"）设为当前目录。

### dotNet.clr("v4.0") <a id="dotNet.clr" href="#dotNet.clr">&#x23;</a>
创建 CLR 运行时,  
可以使用多个参数指定多个允许加载的版本号,  
不指定参数可以自动选择合适的版本,  
如果之前已成功创建此对象,则会使用之前指定的 .Net 运行时版本,  

注意 .NET 3.5 的 CLR 运行时是 v2.0,.Net 4.x 的 CLR 运行时是 v4.0,  
Win7 自带 CLR 2.0运行时,Win10,Win11 自带 CLR 4.0 运行时  

aardio 可以自适应 CLR 2.0/4.0，对 .Net 版本没有严格要求，  
一般不需要自己去创建应用程序域，例如加载程序集，直接写   
dotNet.load 或 dotNet.loadFile 就可以

### dotNet.clr() <a id="dotNet.clr" href="#dotNet.clr">&#x23;</a>
[返回对象:dotNetClrObject](#dotNetClrObject)

## dotNetClrObject 成员列表 <a id="dotNetClrObject" href="#dotNetClrObject">&#x23;</a>

### dotNetClrObject.createAppDomain("域名称") <a id="dotNetClrObject.createAppDomain" href="#dotNetClrObject.createAppDomain">&#x23;</a>
创建应用程序域,参数可选  

如果尚未创建默认单例应用程序域，  
则不指定 @domainName 参数时创建并返回为默认单例应用程序域，  
无参数调用 dotNet.appDomain 总是返回默认单例应用程序域，  
引入 dotNet 库也会自动创建默认应用程序域

### dotNetClrObject.createAppDomain() <a id="dotNetClrObject.createAppDomain" href="#dotNetClrObject.createAppDomain">&#x23;</a>
[返回对象:dotNetAppDomainObject](#dotNetAppDomainObject)

### dotNetClrObject.majorVersion <a id="dotNetClrObject.majorVersion" href="#dotNetClrObject.majorVersion">&#x23;</a>
CLR 运行时版本号，数值。  
只有可能是 2 或 4，不会有其他主版本。  

注意 CLR 版本不完全等于 .NET 版本  

获取完整 CLR 版本号或检测 .NET Framework 版本请查看  
aardio 提供的 System.Environment.Version 库

### dotNetClrObject.runtimeHost <a id="dotNetClrObject.runtimeHost" href="#dotNetClrObject.runtimeHost">&#x23;</a>
[返回对象:dotNetCorRuntimeHostObject](#dotNetCorRuntimeHostObject)

### dotNetClrObject.version <a id="dotNetClrObject.version" href="#dotNetClrObject.version">&#x23;</a>
CLR 运行时版本。  
这个值只有可能是 "v2.0.50727" 或 "v4.0.30319"。  
注意 CLR 版本不完全等于 .NET 版本  

获取完整 CLR 版本号或检测 .NET Framework 版本请查看  
aardio 提供的 System.Environment.Version 库

## dotNetClrObject.AppDomainSetup 成员列表 <a id="dotNetClrObject.AppDomainSetup" href="#dotNetClrObject.AppDomainSetup">&#x23;</a>

### dotNetClrObject.AppDomainSetup.ApplicationBase <a id="dotNetClrObject.AppDomainSetup.ApplicationBase" href="#dotNetClrObject.AppDomainSetup.ApplicationBase">&#x23;</a>
获取或设置包含该应用程序的目录的名称。

### dotNetClrObject.AppDomainSetup.ApplicationName <a id="dotNetClrObject.AppDomainSetup.ApplicationName" href="#dotNetClrObject.AppDomainSetup.ApplicationName">&#x23;</a>
获取或设置应用程序的名称。

### dotNetClrObject.AppDomainSetup.CachePath <a id="dotNetClrObject.AppDomainSetup.CachePath" href="#dotNetClrObject.AppDomainSetup.CachePath">&#x23;</a>
获取和设置特定于应用程序的区域名称,在该区域中影像复制文件。

### dotNetClrObject.AppDomainSetup.ConfigurationFile <a id="dotNetClrObject.AppDomainSetup.ConfigurationFile" href="#dotNetClrObject.AppDomainSetup.ConfigurationFile">&#x23;</a>
获取和设置应用程序域的配置文件的名称。

### dotNetClrObject.AppDomainSetup.DynamicBase <a id="dotNetClrObject.AppDomainSetup.DynamicBase" href="#dotNetClrObject.AppDomainSetup.DynamicBase">&#x23;</a>
获取或设置将在其中存储和访问动态生成文件的目录。

### dotNetClrObject.AppDomainSetup.LicenseFile <a id="dotNetClrObject.AppDomainSetup.LicenseFile" href="#dotNetClrObject.AppDomainSetup.LicenseFile">&#x23;</a>
获取或设置与此域关联的许可证文件的位置。

### dotNetClrObject.AppDomainSetup.PrivateBinPath <a id="dotNetClrObject.AppDomainSetup.PrivateBinPath" href="#dotNetClrObject.AppDomainSetup.PrivateBinPath">&#x23;</a>
获取或设置目录列表,它与 ApplicationBase 目录结合来探测专用程序集。

### dotNetClrObject.AppDomainSetup.PrivateBinPathProbe <a id="dotNetClrObject.AppDomainSetup.PrivateBinPathProbe" href="#dotNetClrObject.AppDomainSetup.PrivateBinPathProbe">&#x23;</a>
获取或设置用于定位应用程序的专用二进制目录路径。

### dotNetClrObject.AppDomainSetup.ShadowCopyDirectories <a id="dotNetClrObject.AppDomainSetup.ShadowCopyDirectories" href="#dotNetClrObject.AppDomainSetup.ShadowCopyDirectories">&#x23;</a>
获取或设置目录的名称,这些目录包含要影像复制的程序集。

### dotNetClrObject.AppDomainSetup.ShadowCopyFiles <a id="dotNetClrObject.AppDomainSetup.ShadowCopyFiles" href="#dotNetClrObject.AppDomainSetup.ShadowCopyFiles">&#x23;</a>
获取或设置指示影像复制是打开还是关闭的字符串

## dotNetCorRuntimeHostObject 成员列表 <a id="dotNetCorRuntimeHostObject" href="#dotNetCorRuntimeHostObject">&#x23;</a>

### dotNetCorRuntimeHostObject.Stop() <a id="dotNetCorRuntimeHostObject.Stop" href="#dotNetCorRuntimeHostObject.Stop">&#x23;</a>
停止 .Net 运行时
