IVsPersistHierarchyItem2.SaveItem 方法 (VSSAVEFLAGS, String, UInt32, IntPtr, Int32%)

保存层次结构项目到磁盘。

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

语法

声明
Function SaveItem ( _
    dwSave As VSSAVEFLAGS, _
    pszSilentSaveAsName As String, _
    itemid As UInteger, _
    punkDocData As IntPtr, _
    <OutAttribute> ByRef pfCanceled As Integer _
) As Integer

int SaveItem(
    VSSAVEFLAGS dwSave,
    string pszSilentSaveAsName,
    uint itemid,
    IntPtr punkDocData,
    out int pfCanceled
)

参数

• dwSave
  类型：Microsoft.VisualStudio.Shell.Interop.VSSAVEFLAGS
  [in] 值从 VSSAVEFLAGS 枚举所采用的标志。

• pszSilentSaveAsName
  类型：System.String
  [in] 要应用的文件名，当 dwSave 设置为 VSSAVE_SilentSave。

• itemid
  类型：System.UInt32
  [in] 从 VSITEMID保存的层次结构项目项的标识符。

• punkDocData
  类型：System.IntPtr
  [in] 对已保存的层次结构项目的 IUnknown 接口的指针。

• pfCanceled
  类型：System.Int32%
  [out] true ，如果保存操作已取消。

返回值

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

备注

COM 签名

从 vsshell.idl:

HRESULT IVsPersistHierarchyItem2::SaveItem(
   [in] VSSAVEFLAGS dwSave,
   [in] LPCOLESTR pszSilentSaveAsName,
   [in] VSITEMID itemid,
   [in] IUnknown *punkDocData,
   [out] BOOL *pfCanceled
);

此方法的调用方负责确定文档是否运行文档表，应通过在正确的 punkDocData 参数。 ，当 punkDocData 是 nullnull 引用（在 Visual Basic 中为 Nothing）时，调用 FindAndLockDocument 方法此方法实现并不是必需的。

在文档保存时，调用此方法以确保拥有的层次结构建立控件。 然后该层次结构可以使用所有私有机制保存文档。 有关使用标准编辑的层次结构， SaveItem 方法的实现是调用下列:

• 对于 VSSAVE_Save 和 VSSAVE_SaveAs，它将 IVsPersistDocData 的 QueryInterface 文档中的数据对象并调用 SaveDocData。

• 对于 VSSAVE_SilentSave，则请将 IPersistFileFormat 的 QueryInterface 文档中的数据对象并使用该接口在调用传递参数 VSSAVE_SilentSave, pPersistFile, pszSilentSaveAsNamelpstrUntitledPath, &bstrDocumentNew的方法 SaveDocDataToFile 和&fCanceled)。

.NET Framework 安全性

• 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。

请参见

参考

IVsPersistHierarchyItem2 接口

SaveItem 重载

Microsoft.VisualStudio.Shell.Interop 命名空间