TFS Team Explorer Using Guideline(Check in - Check out Notes)

重点要求

• 签入前保证本地编译通过，并没有warning，通过stypeCop的检查。
• 签出工程文件不要保持太久，签出后，快速创建文件，然后签入。
• 每个bug或task处理只做一次签入签出操作，并添加签入注释。

签入保存

1. 重新生成解决方案 Rebuild solution。
2. 如果发现错误或警告，进行修改，保证本地编译通过，并没有warning，通过stypeCop的检查。
3. 当Rebuild不再出现错误或警告，则将自己修改的文件进行签入。
4. 签入时认真填写文件的修改注释 Comment，若是处理bug建议记录bug号。

图（一）签入举例：修改bug1215后签入文件AddOnsHelper
右键AddOnsHelper.cs选择Chech in，在窗口Comment栏输入此次修改bug的注释 -f 1215:there is no product in add on page 'on destination'，在窗口中的文件列表中检查勾选此次需要签入的文件（全部或部分）。需签入的全部文件：涉及此次bug所修改的所有文件，只有全部签入才能够通过编译或正常运行；需签入的部分文件：只签入必须有的文件，无意或测试所修改的文件是不需要签入的。
 
图（二） StypeCop检查举例：签入前对AddOnsHelper.cs进行检查

右键AddOnsHelper.cs选择Run StyleCop，在下边会出现检查结果（Error List -> Warnings），双击一条警告跳转到错误所在行，按照警告提示修改高亮代码，直至警告为零就通过了StyleCop检查，关于StyleCop的安装和使用请查看StyleCop。

签出编辑

1. 在 Solution Explorer 中，对整个Solution获取最新版本 Get Latest Version(recursive)。
2. 重新生成解决方案 Rebuild Solution，如果发现错误，则协调"签入错误者"迅速处理错误。
3. 如果是创建文件，签出工程文件后，应快速将工程和新文件一同签入，有两个方法：
   1. 快速创建"空"文件，立即将工程和新文件一同签入，然后再签出新文件完善内容；
   2. 在本地编辑好欲添加的文件，拷贝文件至需要的目录，在Solution explorer中点击Show all files，找到编辑好的文件右键选择 Include in project。
4. 将自己需要编写的程序文件签出（一般采用独享签出，也可以使用共享签出，视情况而定）。

图（三）如何查看文件的历史更新用户

图（四）如何查看文件的当前签出用户

     在团队资源管理器窗口（View - > Team Explorer），展开当前项目双击节点"Source Control"

取消更改（恢复修改之前的版本）

1. 在整个解方案上面右键"取消挂起的更改" Undo pending changes。
2. 钩选要取消更改的文件，点击 Undo Changes。

搁置更改（当一个task未完成，需要离开）

1. 在整个解决方案上面右键 "搁置挂起的更改" Shelve Pending Changes。
2. 输入搁置集名称 Shelveset name，格式为：某某某（xxxx-xx-xx）xxxx搁置。
3. 去掉"在本地保留挂起的更改" Preserve pending changes locally。
4. 按照上面签入保存进行操作。

取消搁置（将上次task进行完善补充）

1. Pending Changes。
2. unshelve