IVsTrackProjectDocuments3 接口
此接口允许批锁的过程，协调文件和一个高级 OnQueryAddFiles 方法。
命名空间： Microsoft.VisualStudio.Shell.Interop
程序集： Microsoft.VisualStudio.Shell.Interop.8.0（在 Microsoft.VisualStudio.Shell.Interop.8.0.dll 中）
语法
声明
<GuidAttribute("53544C4D-9097-4325-9270-754EB85A6351")> _
<InterfaceTypeAttribute()> _
Public Interface IVsTrackProjectDocuments3
[GuidAttribute("53544C4D-9097-4325-9270-754EB85A6351")]
[InterfaceTypeAttribute()]
public interface IVsTrackProjectDocuments3
IVsTrackProjectDocuments3 类型公开以下成员。
方法
| 名称 | 说明 | |
|---|---|---|
.gif "公共方法") |
BeginQueryBatch | 在其中一个对话框询问用户 okay 存在而不是多个对话框，一个开始查询批处理每个文件的。 |
|
CancelQueryBatch | 取消查询批处理系列。 |
|
EndQueryBatch | 指示一次批处理查询处理完成并确定是否应允许批处理操作执行。 |
|
HandsOffFiles | ，该项目会影响许多的文件并希望在发布时，的文件的任何锁定调用此方法。 |
|
HandsOnFiles | 指示完成操作的指定文件的项目。 |
|
OnQueryAddFilesEx | ，该项目将文件移至项目目录中，新位置此方法是 OnQueryAddFiles 方法的扩展版本中使用。 |
页首
备注
OnQueryAddFiles 方法的更高级版本将文件复制到项目目录中的新位置在从源代码管理中提取后的项目。
批处理方法必须平衡;即每调用 BeginQueryBatch 方法必须与调用与 EndQueryBatch 方法或 CancelQueryBatch 方法。 批处理方法为每个文件使用，以便用户显示相关操作的单个对话框在所有文件而不是多个对话框，一个。 如果任何查询添加它不是好继续操作， CancelQueryBatch 应调用取消整个批处理操作。 否则，因此，如果任何查询指示可继续， EndQueryBatch 方法应调用。 例如：
BOOL fRenameCanCont = FALSE;
pTrackProjectDocuments3->BeginQueryBatch();
QueryFolderRename(pFolderNode, strOldPath, strNewPath, &fRenameCanCont);
if (fRenameCanCont)
pTrackProjectDocuments3->EndQueryBatch(&fRenameCanCont);
else
pTrackProjectDocuments3->CancelQueryBatch();
bool fRenameCanCont = false;
pTrackProjectDocuments3.BeginQueryBatch();
QueryFolderRename(pFolderNode, strOldPath, strNewPath, fRenameCanCont);
if (fRenameCanCont)
pTrackProjectDocuments3.EndQueryBatch(&fRenameCanCont);
else
pTrackProjectDocuments3.CancelQueryBatch();
在此示例中， QueryFolderRename 假定为重复调用 OnQueryRenameFile 方法的原因一系列操作的用户定义的 helper 函数。
对实现者的说明
此接口由 Visual Studio 源代码管理包实现。 ，如果该包实现 IVsTrackProjectDocumentsEvents3 接口， Visual Studio 方法调用此接口至此有效的源代码管理包。
备注
此接口从 IVsTrackProjectDocuments2 接口未派生，不过，它在同一对象通常实现。IVsTrackProjectDocuments3 接口可通过自讨苦吃从 SVsTrackProjectDocuments 服务。
对调用者的说明
此接口提供允许访问源代码管理系统的多访问，而无需为每个文件提供提示的一个批处理机制。 此外，此接口来同步对文件的读/写访问并提供扩展到 OnQueryAddFiles 方法。