IVsSolutionBuildManager2.SaveDocumentsBeforeBuild 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
项目调用此方法,以确保在启动生成或运行操作之前保存项目的可生成/可运行组件。
public:
int SaveDocumentsBeforeBuild(Microsoft::VisualStudio::Shell::Interop::IVsHierarchy ^ pHier, System::UInt32 itemid, System::UInt32 docCookie);
public:
int SaveDocumentsBeforeBuild(Microsoft::VisualStudio::Shell::Interop::IVsHierarchy ^ pHier, unsigned int itemid, unsigned int docCookie);
int SaveDocumentsBeforeBuild(Microsoft::VisualStudio::Shell::Interop::IVsHierarchy const & pHier, unsigned int itemid, unsigned int docCookie);
public int SaveDocumentsBeforeBuild (Microsoft.VisualStudio.Shell.Interop.IVsHierarchy pHier, uint itemid, uint docCookie);
abstract member SaveDocumentsBeforeBuild : Microsoft.VisualStudio.Shell.Interop.IVsHierarchy * uint32 * uint32 -> int
Public Function SaveDocumentsBeforeBuild (pHier As IVsHierarchy, itemid As UInteger, docCookie As UInteger) As Integer
参数
- pHier
- IVsHierarchy
中指向 IVsHierarchy 项目的对象的指针。
- itemid
- UInt32
中指定 VSITEMID 。 这是 VSITEMID 对应于项目层次结构中的单个文档的。
- docCookie
- UInt32
中指定文档 cookie;向注册时返回的文档的抽象句柄 IVsRunningDocumentTable 。
返回
如果该方法成功,则它会返回 S_OK。 如果该方法失败,则会返回错误代码。
注解
COM 签名
从 vsshell:
HRESULT IVsSolutionBuildManager2::SaveDocumentsBeforeBuild(
[in] IVsHierarchy *pHier,
[in] VSITEMID itemid,
[in] VSCOOKIE docCookie
);
如果项目实现自己的生成/运行机制来支持比整个项目更细化的级别,则项目将调用此方法,以确保环境在开始生成或运行之前保存其可生成或可运行组件。
此方法遵循环境属性给定的用户设置 VSSPROPID_PreBuildRunPreview ,并提示保存或不保存。
还不会保存向注册的文档 RDT_CanBuildFromMemory 。