扩展性问题疑难解答

更新:2007 年 11 月

本主题描述在扩展 Visual Studio Team System Architecture Edition 中的分布式系统设计器时可能遇到的问题。

  • 创建和导出自定义原型

  • 导入和安装自定义原型

  • 从工具箱中删除原型

  • 系统定义模型 (SDM) SDK 问题

创建和导出自定义原型

在创建自定义原型时可能会出现下列问题。

权限要求

如果是在 Windows Server 2003 或 Windows XP 上运行 Visual Studio,则您必须至少具有超级用户权限才能创建所有用户的自定义原型。如果是在 Windows Vista 上运行 Visual Studio,则必须具有管理员权限。如果要将原型导出到受限制的位置,则必须提供管理员凭据才能将原型导出到该位置。

有关更多信息,请参见下列主题:

已存在同名的原型文件

如果尝试创建的原型与现有的原型文件具有相同的文件名,Visual Studio 会显示以下消息:

“VS1021: 以下原型文件已存在于工具箱中: <文件名>。要覆盖此文件,请单击‘确定’。”

缺少原型文件

如果在尝试导出原型时缺少原型的 .*prototype 文件,Visual Studio 会显示以下消息:

“VS1011: 找不到此工具箱项的原型文件: <原型的路径和文件名>。”

若要解决此问题,请按照下列步骤操作。

在缺少相关文件时导出原型

  1. 将原型从工具箱拖到关系图。

  2. 将关系图上的结果形状添加到工具箱中。

  3. 从工具箱中导出原型。

有关更多信息,请参见如何:从分布式系统设计器中导出自定义原型

导入和安装自定义原型

当您导入在分布式系统设计器中创建的自定义原型,或者安装从系统定义模型 (SDM) 软件开发工具包 (SDK) 创建的自定义原型时,可能会出现下列问题。有关更多信息,请参见如何:导入或安装新的自定义原型

权限要求

如果是在 Windows Server 2003 或 Windows XP 上运行 Visual Studio,则您必须至少具有超级用户权限才能导入所有用户的自定义原型。如果是在 Windows Vista 上运行 Visual Studio,则必须提供管理员凭据才能在您的计算机上导入所有用户的自定义原型。

若要安装在分布式系统设计器中创建或通过 SDM SDK 创建的自定义原型,必须具有超级用户或管理员权限才能为这些原型添加相应的注册表项。

原型中所包含的 Office 应用程序的模板属性显示一个路径

如果导入通过早期版本的分布式系统设计器中创建的原型,而且该原型包含一个或多个 Office 应用程序,则这些应用程序的“模板”属性可能显示路径,而不是模板名。

若要修复此问题,请将“模板”属性更改为所需的模板。

针对 .sdmdocument 文件更新注册表

如果您添加或移除从 SDM SDK 创建的原型的 .sdmdocument 文件,并更新注册表以反映这些更改,那么,当您只是关闭和重新打开设计器时,Visual Studio 将不刷新这些文件,而是改用缓存中的文件。

若要解决此问题,请关闭并重新打开 Visual Studio 以刷新由 Visual Studio 加载的 .sdmdocument 文件。

说明:

当您首次打开 Visual Studio 时,Visual Studio 会加载 .sdmdocument 文件。当您首次打开分布式系统设计器时,Visual Studio 会将这些文件保存到缓存中。

原型无效或已损坏

如果尝试导入的原型不是有效的原型文件或者已损坏,Visual Studio 会显示以下消息:

“VS1010: Visual Studio 无法导入所选文件。它不是兼容的原型文件。请选择兼容的原型文件。”

有效的原型文件具有 .*prototype 文件扩展名。

已存在同名的原型

如果尝试导入的原型已经存在于工具箱中,Visual Studio 会显示以下消息:

“VS1021: 以下原型文件已存在于工具箱中: <文件名>。要覆盖此文件,请单击‘确定’。”

原型已经导入

如果尝试导入的原型文件的源和目标相同,Visual Studio 会显示以下消息:

“VS 1020: Visual Studio 无法导入所选文件。该文件中的原型已导入。”

工具箱显示为空

如果工具箱显示为空,请确认“PrototypesFolder1”注册表值未包含空值或格式不正确的值(需要管理员权限)。

如果在 Windows XP 上运行 Visual Studio,请确认“PrototypesFolder1”注册表值是否包含下列值:

原型文件类型

注册表位置

确认 PrototypesFolder1 是否包含

仅供您使用的自定义原型文件

HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\9.0\EnterpriseTools\DesignerPrototypeFolders

<用户名>\Local Settings\Application Data\Microsoft\VisualStudio\9.0\ DesignerPrototypeFolders\Prototypes\

供其他用户使用的自定义原型文件

HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\9.0\EnterpriseTools\DesignerPrototypeFolders

…\Program Files\Microsoft Visual Studio 9.0\Common7\Tools\DesignerPrototypes\Prototypes\

如果是在 Windows Vista 上运行 Visual Studio:

原型文件类型

注册表位置

确认 PrototypesFolder1 是否包含

仅供您使用的自定义原型文件

HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\9.0\EnterpriseTools\DesignerPrototypeFolders

<用户名>\AppData\Local\Microsoft\VisualStudio\9.0\DesignerPrototypes\Prototypes

供其他用户使用的自定义原型文件

HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\9.0\EnterpriseTools\DesignerPrototypeFolders

…\Program Files\Microsoft Visual Studio 9.0\Common7\Tools\DesignerPrototypes\Prototypes

默认的应用程序或逻辑服务器的名称与 DefaultRootName 属性中指定的对应名称不匹配

当您使用 SDM SDK 创建自定义原型时,Visual Studio 可能不使用由 SDM 设计数据中的 DefaultRootName 属性指定的名称作为关系图面上应用程序和逻辑服务器的默认名称。应用程序和逻辑服务器的形状上将显示名称“Application1”或“GenericServer1”。

若要解决此问题,请按照下列步骤操作。

更改默认名称

  1. 在使用 protogen.exe 生成初始原型之后,安装该原型。

  2. 打开相应的设计器并将原型从工具箱拖到关系图面上。

    相应的形状随即显示在关系图上。

  3. 用所需的默认名称重命名关系图上的形状。

  4. 根据重命名后的形状创建一个原型。

  5. 导出重命名后的原型并分发它。

有关更多信息,请参见下列主题:

从工具箱中删除原型

在从工具箱中删除原型时可能会出现下列问题。

原型重新出现在工具箱中

如果您从工具箱中删除某个原型并重新启动 Visual Studio,则该原型可能会重新出现在工具箱中。

若要解决此问题,必须删除 .adprototype 或 .lddprototype 支持文件并重置工具箱。

说明:

您必须具有管理员权限才能删除位于受限制位置中的任何文件。

如果是在 Windows XP 上运行 Visual Studio:

  • 请在以下位置查找已经由您创建且仅供您使用的自定义原型文件并删除它:

    …\Documents and Settings\<用户名>\Local Settings\Application Data\Microsoft\VisualStudio\9.0\DesignerPrototypeFolders\Prototypes

  • 请在以下位置查找已经由您创建且供其他用户使用的自定义原型文件并删除它:

    …\Program Files\Microsoft Visual Studio 9.0\Common7\Tools\DesignerPrototypes\Prototypes

如果是在 Windows Vista 上运行 Visual Studio:

  • 请在以下位置查找已经由您创建且仅供您使用的自定义原型文件并删除它:

    …\Users\<username>\AppData\Local\Microsoft\VisualStudio\9.0\DesignerPrototypes\Prototypes

  • 请在以下位置查找已经由您创建且供其他用户使用的自定义原型文件并删除它:

    …\Program Files\Microsoft Visual Studio 9.0\Common7\Tools\DesignerPrototypes\Prototypes

系统定义模型 (SDM) SDK 问题

如果在装有 Visual Studio 2005 Team Edition for Architects 和 Visual Studio 2005 SDM SDK 的计算机上安装或卸载 Visual Studio Team System 2008 Architecture Edition,则 Visual Studio 2005 SDM SDK 版本的 Protogen.exe 可能会停止工作。

若要修复此问题,请使用以下解决方法之一。在使用这些解决方法之前,请确保对要更改或删除的任何注册表项信息或文件进行备份。这是一项预防措施,以备您在需要还原信息时使用。

  • 如果您安装了 Team System 2008 Architecture Edition,请编辑以下位置中的注册表项,使其指向 Visual Studio 2005 原型文件夹:

    HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\9.0\EnterpriseTools\DesignerPrototypeFolders

    如果您卸载了 Team System 2008 Architecture Edition,请按如下方式,向指定的位置中添加一个新的注册表项:

    名称 =“PrototypesFolder1”

    值 = <Visual Studio 2005 原型文件夹的路径>

  • 如果您安装了 Team System 2008 Architecture Edition,请将以下位置中的 *.prototypetemplate 文件替换为这些文件的 Visual Studio 2005 版本。如果您卸载了 Team System 2008 Architecture Edition,请创建以下位置(如果它已不存在):

    …\Microsoft Visual Studio 9.0\Common7\Tools\DesignerPrototypes\Prototypes

  • 卸载 Team System 2008 Architecture Edition 并删除以下注册表位置:

    HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\9.0

请参见

其他资源

扩展分布式系统设计器