IVsTrackProjectDocumentsEvents2.OnQueryRenameFiles 方法

，该项目请求重命名文件时，此方法通知客户端。

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

语法

声明
Function OnQueryRenameFiles ( _
    pProject As IVsProject, _
    cFiles As Integer, _
    rgszMkOldNames As String(), _
    rgszMkNewNames As String(), _
    rgFlags As VSQUERYRENAMEFILEFLAGS(), _
    <OutAttribute> pSummaryResult As VSQUERYRENAMEFILERESULTS(), _
    <OutAttribute> rgResults As VSQUERYRENAMEFILERESULTS() _
) As Integer

int OnQueryRenameFiles(
    IVsProject pProject,
    int cFiles,
    string[] rgszMkOldNames,
    string[] rgszMkNewNames,
    VSQUERYRENAMEFILEFLAGS[] rgFlags,
    VSQUERYRENAMEFILERESULTS[] pSummaryResult,
    VSQUERYRENAMEFILERESULTS[] rgResults
)

参数

• pProject
  类型：Microsoft.VisualStudio.Shell.Interop.IVsProject
  [in] 请求项重命名文件。

• cFiles
  类型：System.Int32
  [in] 重命名的文件的数字。

• rgszMkOldNames
  类型：array<System.String[]
  [in] 旧文件的名称。

• rgszMkNewNames
  类型：array<System.String[]
  [in] 新的文件名。

• rgFlags
  类型：array<Microsoft.VisualStudio.Shell.Interop.VSQUERYRENAMEFILEFLAGS[]
  [in] 一些标志。有关 rgFlags 值列表，请参见 VSQUERYRENAMEFILEFLAGS。

• pSummaryResult
  类型：array<Microsoft.VisualStudio.Shell.Interop.VSQUERYRENAMEFILERESULTS[]
  [out] 摘要结果对象。此对象是为而不是结果的总和。 rgszMkOldNames传递的数组的文件。如果单个文件的结果是没有，则 pSummaryResult 与 VSQUERYRENAMEFILERESULTS_RenameNotOK相等;如果所有文件的结果是，则 pSummaryResult 与 VSQUERYRENAMEFILERESULTS_RenameOK相等。有关 pSummaryResult 值列表，请参见 VSQUERYRENAMEFILERESULTS。

• rgResults
  类型：array<Microsoft.VisualStudio.Shell.Interop.VSQUERYRENAMEFILERESULTS[]
  [out] 结果。有关 rgResults 值列表，请参见 VSQUERYRENAMEFILERESULTS。

返回值

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

备注

COM 签名

从 IVsTrackProjectDocumentsEvents2.idl

HRESULT IVsTrackProjectDocumentsEvents2::OnQueryRenameFiles(
   [in] IVsProject *pProject,
   [in] int cFiles, [in, size_is(cFiles)] const LPCOLESTR rgszMkOldNames[],
   [in, size_is(cFiles)] const LPCOLESTR rgszMkNewNames[],
   [in, size_is(cFiles)] const VSQUERYRENAMEFILEFLAGS rgflags[],
   [out] VSQUERYRENAMEFILERESULTS *pSummaryResult,
   [out, size_is(cFiles)] VSQUERYRENAMEFILERESULTS rgResults[]
);

使用 IVsTrackProjectDocumentsEvents2.OnQueryRenameFiles 指示所指定的文件是否在项目可以重命名。 ，如果允许操作会危及稳定状态，只拒绝查询。 例如，因此，如果新名称冲突使用现有的文件已在源代码管理下，源代码管理拒绝重命名查询。

.NET Framework 安全性

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

请参见

参考

IVsTrackProjectDocumentsEvents2 接口

Microsoft.VisualStudio.Shell.Interop 命名空间