IVsUIShell.SaveDocDataToFile 方法
帮助器方法。 IVsPersistDocData 实现接口的编辑改用。
命名空间: Microsoft.VisualStudio.Shell.Interop
程序集: Microsoft.VisualStudio.Shell.Interop(在 Microsoft.VisualStudio.Shell.Interop.dll 中)
语法
声明
Function SaveDocDataToFile ( _
grfSave As VSSAVEFLAGS, _
pPersistFile As Object, _
pszUntitledPath As String, _
<OutAttribute> ByRef pbstrDocumentNew As String, _
<OutAttribute> ByRef pfCanceled As Integer _
) As Integer
int SaveDocDataToFile(
VSSAVEFLAGS grfSave,
Object pPersistFile,
string pszUntitledPath,
out string pbstrDocumentNew,
out int pfCanceled
)
参数
- grfSave
类型:Microsoft.VisualStudio.Shell.Interop.VSSAVEFLAGS
[in] 指定文件保存选项。有关更多信息,请参见 VSSAVEFLAGS。
- pPersistFile
类型:System.Object
[in] 对文档数据将保存文件的 IUnknown 接口的指针。
- pszUntitledPath
类型:System.String
[in] 文档数据的未保存文档的文件路径将被保存。
- pbstrDocumentNew
类型:System.String%
[out] 新文档文件名。
- pfCanceled
类型:System.Int32%
[out] 设置为 true ,如果用户通过单击按钮 取消 中止保存。
返回值
类型:System.Int32
如果方法成功,则返回 S_OK。如果失败,它会返回一个错误代码。
备注
COM 签名
从 vsshell.idl:
HRESULT IVsUIShell::SaveDocDataToFile(
[in] VSSAVEFLAGS grfSave,
[in] IUnknown *pPersistFile,
[in] LPCOLESTR pszUntitledPath,
[out] BSTR *pbstrDocumentNew,
[out] BOOL *pfCanceled
);
此方法有助于实现 **保存 ** 对话框。 文档数据对象实现 IPersistFileFormat 执行保存操作。 此方法管理 **保存 ** 对话框使用作为输入传递的 IPersistFileFormat 指针。
标准情况是文档保存其所有信息保存到文件。 通常,保存操作失败,如果一个目标 (例如,不正确的磁盘已满,的磁盘的问题, write-protected,等等)。 对象比错误选择不应出于其他原因失败保存操作的位置。 因此,因此,如果失败的保存,用户通告的问题并导致即一个新的目标可以选择的对话框 ( 保存 对话框)。 对于文档保存一些信息到单独的存储和其他信息保存到文件的情况下,因此,如果第一条消息的保存到独立存储的失败,则点在尝试文件节的不同目标。 在这种情况下文档返回 OLE_E_PROMPTSAVECANCELED 的值从 Save的。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。