How to: Identify Version Control Item Status in Source Control Explorer

Team Foundation version control item status is reflected in Source Control Explorer and Solution Explorer. This topic describes the status icons associated with Source Control Explorer. For information about identifying version-controlled item status in Solution Explorer, see How to: Identify Version Control Item Status in Solution Explorer. Version control status icons appear to the left of the files and folders in Source Control Explorer. In conjunction, you can view the Pending Change column status to the right.

Version Control Status Icons

The version control status icons that identify version control item status, are explained in the following table:

ICON	Status	Description
None	Blank	Represents an item whose Team Foundation version control state is unknown.
	Checked in	Represents an item that is under Team Foundation version control and has no pending changes against it.
	Checked out	Represents an item for which the current user has a pending change in their current workspace, and the item is not exclusively locked.
	Orphaned	Represents an item that has been orphaned because of a dependency break.
	Editable	Represents an item that is writable.
	Read-only	Represents an item that is not writable.
	Disabled	Represents an item that should have been added to Team Foundation version control because the item is a child of a version-controlled solution or project, but could not be added.
	Checked out exclusive	Represents an item for which the current user has a pending change in their current workspace, and the item is exclusively locked by the current user.
	Checked out shared other	Represents an item that the current user does not have checked out in their current workspace, but the item does have a pending change in another workspace that is owned by either this user or another user.
	Checked out exclusive other	Represents an item that the current user does not have checked out in his or her current workspace, but the item does have a pending change in another workspace that is owned by another user and is exclusively locked there.
	Excluded from version control	Represents an item that is not under Team Foundation version control because the user has explicitly excluded the item from version control.
	Pending addition	Represents an item that is not currently on the version control server, but is being added to version control by the current user and has a pending change of add.
	Synchronously opened	Represents an item that belongs to a project that Visual Studio is opening asynchronously.
	Branch	Represents an item that will be part of a branch operation during the next check-in.
	Merge	Represents an item that will be part of a merge operation during the next check-in.
	Pending Delete	Represents an item that will be deleted from version control during the next check-in.
	Pending Undelete	Represents an item that will be undeleted from version control during the next check-in.
	Unmapped Team Project	Represents items that are not currently mapped to a team project server.
	Unmapped Folder	Represents items that are in a folder which is not currently mapped.
	Deleted Folder	Represents a folder that will be deleted during the next check-in.

These icons can be used to determine pending changes as demonstrated in the following procedure.

Required Permissions

To perform this procedure, you must be a member of the Administrators or Users security group on the computer where Visual Studio is installed. For more information, see Team Foundation Server Permissions.

To identify pending changes in Solution Explorer

1. Create a workspace. For more information, see How to: Create a Workspace.

2. Add a file or folder to version control. For more information, see Adding Projects and Solutions to Version Control.

3. On the View menu, click Other Windows, and then click Source Control Explorer.

4. Notice that the project or solution items have a pending addition status icon as described in the previous table. Also, notice that the Pending Change column has the status of add.

   Note

   Make sure that you have the correct workspace chosen in Source Control Explorer by using the Workspace drop-down list at the top of the window.

   Conducting other actions on version-controlled items, for example deleting an item, will cause the applicable status icon to display and the Pending Change column to update accordingly.

5. Then perform a check-in by right-clicking the folder in the Source Control Explorer window. The blue padlocks to the left of the items in the Solution Explorer indicate that the items are checked in.

See Also

Concepts

Understanding Version Control with Solution Explorer

How to: Add a Project or Solution to Version Control

How to: Bind and Unbind Projects and Solutions

How to: Identify Version Control Item Status in Solution Explorer