通过

IVsExternalFilesManager2.TransferDocument 方法 (String, String, IVsWindowFrame)

  • 项目

调用文档到杂项文件项目。

命名空间：  Microsoft.VisualStudio.Shell.Interop
程序集：  Microsoft.VisualStudio.Shell.Interop（在 Microsoft.VisualStudio.Shell.Interop.dll 中）

语法

声明
Function TransferDocument ( _
    pszMkDocumentOld As String, _
    pszMkDocumentNew As String, _
    punkWindowFrame As IVsWindowFrame _
) As Integer

int TransferDocument(
    string pszMkDocumentOld,
    string pszMkDocumentNew,
    IVsWindowFrame punkWindowFrame
)

参数

  • pszMkDocumentOld
    类型：System.String
    [in] 指定原始路径将调用的文件。
  • pszMkDocumentNew
    类型：System.String
    [in] 指定新文件的路径。

返回值

类型：System.Int32
如果方法成功，则返回 S_OK。如果失败，它会返回一个错误代码。

备注

COM 签名

从 vsshell.idl:

HRESULT IVsExternalFilesManager2::TransferDocument(
   [in] LPCOLESTR pszMkDocumentOld,
   [in] LPCOLESTR pszMkDocumentNew,
   [in] IVsWindowFrame *punkWindowFrame
);

这是 打开外部文件 命令的实现在系统 文件 菜单上的。如果项目中不能服务此文件，并且杂项文件 (外部文件) 项目尚不存在，环境创建杂项文件再次项目并重试。

使用外部文件管理器 (IVsExternalFilesManager)，该环境中，杂项文件项目中实现。此接口使您可以操作杂项文件项目。

如果您有一个万维网项目，则项目系统的定义紧密绑定到该条件网页位于模式网站的层次结构的特定目录。如果项目具有打开文件从网站，并且用户选择执行在该文件中 **保存 ** 保存到软盘，则该文件可能不再被视为属于网站的文件，因为它在网站的目录不存在。**保存 ** 环境模型中打开编辑器在新位置跟踪文件。即编辑器在新位置继续编辑新文件，并且旧文件在原始位置保持不变并且不再处于打开状态。由于新文件不再是网站项目的成员，项目系统传递打开编辑器对杂项文件项目。

若要完成此调用，该项目层次结构/itemID 所有者 (在此示例中， Web 项目) 调用 SID_SVsExternalFilesManager 的 Query Service 接收指向 IVsExternalFilesManager。该项目并调用传入旧的 TransferDocument 文档标记 (pszMkDocumentString) 文档的，当在 Web 项目。此标记可以是 URL、 http:// 或 UNC 路径并为键到运行的原始文档表 (RDT)。它还将新 pszMkDocumentString 和新打开帧指针。杂项文件项目文件传输到其项目，然后将它的新项 ID，通过调用方法 RenameDocument 然后更新 RDT。侦听 RDT 事件随后的窗架和不同的实体了解更新这些引用到文档中。

.NET Framework 安全性

请参见

参考

IVsExternalFilesManager2 接口

TransferDocument 重载

Microsoft.VisualStudio.Shell.Interop 命名空间