Team Foundation Check-Out Settings

Team Foundation version control supports two check-out settings. The settings determine how the check-out operation works. You can configure the check-out operation to check out the local version in your workspace. Another option is to configure the check-out operation to first get the latest version of items into your workspace, and then check them out. The latter configuration resembles Visual SourceSafe behavior.

Checking Out Items

The default check-out behavior for Team Foundation version control checks out the local version of items in your workspace. Even if a new version of the item exists on the server, Team Foundation version control does not get that version.

This check-out behavior is useful when you perform a get operation to retrieve a set of files. Typically, the configuration of version-controlled files on your computer represents a point-in-time snapshot of specific files—files that are known to work together—from Team Foundation version control. Therefore, they can be built and tested together.

As a developer working in a workspace, you are isolated from the changes that are made by other developers. It is in your control to accept changes from other developers by performing a get operation, as appropriate. In ideal circumstances, when you do this you will update the complete configuration of version-controlled files, and not just one or two files. This is because changes in one file typically depend on corresponding changes to other files. This check-out setting makes sure that you always have a consistent snapshot of files that can be built and tested.

When you check in your changes, Team Foundation will give you the option to merge your changes with any changes that were made on the server version. You will be prompted by the resolve conflicts dialog box if any conflicts are detected.

Getting Latest Version on Check-Out

You can also configure the check-out behavior to get the latest version, or tip, of an item every time that you check it out. This behavior is the same as Visual SourceSafe. If you are a developer who is used to working with the Visual SourceSafe check-out model, you will find this setting more familiar.

When the check-out setting is configured to get the latest version, Team Foundation version control first gets the latest version of the items from the server into your workspace. Then the items are checked out.

Where to Configure Check-Out Settings

You can configure the check-out settings for the team project, or only for your computer. When you configure the check-out settings for a team project, you configure the default behavior for all developers who use that team project. For more information about how to configure check-out settings for a team project, see Configure Check-Out Settings.

You can also configure the check-out settings on your computer. This affects the check-out behavior for your computer, but it does not change the check-out behavior for any other team member. For more information about how to configure check-out settings for your computer, see Enable Team Foundation Version Control to Get the Latest Files on Check-Out.

The default check-out behavior for a team project can also be configured in the process template. For more information, see Defining the Initial Configuration of Team Foundation Version Control.

See Also

Tasks

Enable Team Foundation Version Control to Get the Latest Files on Check-Out

Other Resources

Getting a Local Copy of Files from the Version Control Server