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

Team Foundation source 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 source controlled item status in Solution Explorer, see How to: Identify Source Control Item Status in Solution Explorer. Source 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. The source control status icons that identify source control item status, are explained in the following table:

ICON	Status	Description
None	Blank	Represents an item whose Team Foundation source control state is unknown.
	Checked in	Represents an item that is under Team Foundation source 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 source control because the item is a child of a source-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 source control	Represents an item that is not under Team Foundation source control because the user has explicitly excluded the item from source control.
	Pending addition	Represents an item that is not currently on the source control server, but is being added to source 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 source control during the next check-in.
	Pending Undelete	Represents an item that will be undeleted from source 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 solution or project to source control. For more information, see Adding Projects and Solutions to Source 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 source 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 solution 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

Tasks

How to: Add a Project or Solution to Source Control
How to: Bind and Unbind Projects and Solutions
How to: Identify Source Control Item Status in Solution Explorer

Other Resources

Understanding Source Control with Solution Explorer