NetBox 的路径系统

为了方便调试与发布，NetBox 定义了一套不同与操作系统的虚拟路径管理系统。在 NetBox 中，除了直接的文件访问对象（比如 File 对象和 FileSystemObject）外，其他的路径系统都是以 NetBox 运行目录为根目录的，所有试图超越根目录向上级目录的访问都将被限制在根目录上面，此类路径的使用，可以在手册中找到大量的例子。

一、执行方式

NetBox 中大部分应用都是以此方式运行。当以执行方式运行时，NetBox 以应用程序内部优先的方式打开文件。当同一个文件，应用程序内部和磁盘文件都有此文件时，将打开应用程序内部文件用于操作。

在 NetBox 中涉及到此类路径的有下面的对象：

#include 预处理指令
HttpServer 对象的 AddHost 方法
HttpServerHost 对象的 AddFolder 方法、EventSink 属性
JobServer 对象的 Create 方法
TcpServer 对象的 Create 方法
NetBox 对象的 LoadObject 方法、LoadLibrary 方法、RegisterClass 方法
Response 对象的 MapToFile 方法
Script 对象的 Load 方法
ScriptObject 对象的 Load 方法

二、只读方式

当需要直接访问应用程序内部文件，比如初始化数据等，可以使用只读方式打开应用程序内部文件，NetBox 中 File 对象和容器对象的装载方法 Load 方法都是以此方式运行。当以只读方式运行时，NetBox 同样以应用程序内部优先的方式打开文件。当同一个文件，应用程序内部和磁盘文件都有此文件时，将打开应用程序内部文件用于操作。应用程序内部的可执行脚本将不可读。

在 NetBox 中涉及到此类路径的有下面的对象：

Dictionary 对象的 Load 方法
File 对象的 Open 方法
List 对象的 Load 方法
Queue 对象的 Load 方法

三、文件方式

通常情况下，使用 NetBox 的路径系统可以满足大部分需求，有些时候，可能希望从 NetBox 的虚拟路径系统映射到系统路径，此时可以使用 NetBox 对象的 MapPath 方法来转换路径。经过转换的文件名即可直接传递给支持此类路径的对象使用。当使用文件方式运行时，NetBox 将优先访问系统中的文件，如果文件存在，则直接访问文件。如果文件不存在，则在应用程序内部查找与其对应的资源，然后根据应用的打开方式，或者创建临时文件，或者创建同名文件，复制数据后返回给应用。

上一节只读方式的对象全部支持此种方式。几乎所有的第三方对象也是以此种方式访问文件。比如 Scripting.SystemFileObject，ADO 访问 MDB 数据库，等等。

由于此方式对用户透明，所以可以用于大量场合。最典型的例子是可以直接将初始化 mdb 数据库直接编译进应用程序，当使用 ado 第一次访问此数据库时，NetBox 将自动取出初始化数据库用于访问。

四、URL 方式

NetBox 虚拟路径内的文件也可以在 Netbox 环境中使用 netbox: 协议直接访问，以便于创建基于 HTML 界面的桌面应用程序。比如在 netbox 运行路径中有一个文件：\wwwroot\default.htm，使用 netbox: 协议访问时的路径就是：netbox:/wwwroot/default.htm。需要注意的是作为 netbox: 协议的路径分割符是“/”而不是“\”。当使用 url 方式访问时，所有的执行方式和执行权限都与只读方式相同。

可以使用 netbox: 协议的对象有下面这些：

HtmlWindow 对象的 Open 方法

除此之外，只读方式的所有的对象也全部支持此方法。同时，HtmlWindow 窗口中运行的 HTML 和也都以这种方式访问应用程序资源。