Команды "checkout" и "edit"

Обновлен: Ноябрь 2007

Делает локальный файл изменяемым и меняет его статус ожидающие изменение на статус "Правка" в рабочей области. Edit является псевдонимом для команды Checkout.

Примечание.
Изменения извлеченных элементов не отображаются на сервере Team Foundation (подсистема контроля версий) до тех пор, пока не будет выполнена операция возврата. Дополнительные сведения см. в разделе Практическое руководство. Возврат ожидающих изменений.

Требуемые разрешения

Для использования команды checkout необходимо иметь разрешение Извлечение со значением Разрешить и являться либо владельцем рабочей области, либо иметь глобальное разрешение Администрирование рабочих областей со значением Разрешить. Кроме того, для использования параметра /lock со значением, отличным от "none", необходимо иметь разрешение Блокировка со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

tf checkout [/lock:(none|checkin|checkout)] [/recursive] 
[/type:encoding] itemspec

Параметры

Аргумент	Описание
encoding	Предоставляет значение для параметра /type. Альтернативными вариантами являются: Text — псевдоним для текущей кодировки Windows (Windows-1252 в системах США) или Юникод (на основе метки порядка следования байтов (BOM)), Binary и все другие кодировки файлов, поддерживаемые операционной системой Windows. Для автоматического определения типа используется параметр Auto. Дополнительные сведения см. в разделе Типы файлов.
itemspec	Указывает один или более файлов для извлечения. Допускается использование подстановочных знаков.

Параметр	Описание
/type	Используется для переопределения кодировки файла, который Team Foundation связывает с указанными файлами, вручную.
/recursive	Извлекает все файлы, соответствующие элемент, в текущем каталоге и всех его подкаталогах.
/lock	Запрещает извлечение и возврат указанных файлов другими пользователями. Дополнительные сведения см. в разделе Основные сведения о типах блокировки. Параметры блокировки None Значение по умолчанию. Блокировка не применяется. Если указанный файл заблокирован, параметр None снимает блокировку. Checkin Другие пользователи могут извлекать, но не могут возвращать исправления для указанных элементов, пока они заблокированы. Если какой-нибудь другой пользователь уже заблокировал один из указанных элементов, операция блокировки завершается неудачей. Checkout Запрещает извлечение любого из указанных элементов до отмены блокировки. Если какой-нибудь другой пользователь уже заблокировал один из заданных элементов, операция блокировки завершается неудачей.

Заметки

Действие по умолчанию команды checkout определяется установкой параметра Получить последнюю версию элемента при извлечении. Дополнительные сведения о просмотре или изменении этого параметра см. в разделе Практическое руководство. Настройка системы управления версиями Team Foundation для получения последних версий при извлечении.

Если параметр Получить последнюю версию элемента при извлечении включен, команда checkout действует так же, как в Visual SourceSafe При отсутствии последней версии элемента в рабочей области Team Foundation получит последнюю версию из Team Foundation Server и скопирует ее в эту область. Если элемент в рабочей области имеет более раннюю версию, она будет заменена на последнюю.

Если параметр Получить последнюю версию элемента при извлечении отключен, Team Foundation не получит последнюю версию сервера Team Foundation (подсистема контроля версий) во время операции извлечения. Вместо этого текущая версия рабочей области станет доступной для записи. Дополнительные сведения см. в разделе Практическое руководство. Получение исходного кода для командного проекта.

tf edit является псевдонимом для checkout.

По умолчанию несколько пользователей могут одновременно извлечь элемент системы управления версиями. При использовании команды tf для извлечения элемента, имеющего ожидающие изменения в другой рабочей области, сведения о характере этих изменений выводятся в командной строке. В большинстве сред совместной разработки вероятность возникновения конфликтов при слиянии ожидающих изменений из разных рабочих областей достаточно мала. Большинство конфликтов в Team Foundation разрешаются автоматически. При возникновении конфликтов, которые нельзя устранить автоматически, используется Команда "resolve" для безопасного выбора сохраняемых изменений. Для наблюдения за недавно произведенными изменениями в других рабочих областях и обнаружения конфликтов со своими ожидающими изменениями пользователь может использовать Команда "status". В качестве альтернативного способа для предотвращения извлечения или возврата элемента другими пользователями используется Команда "lock". Команду lock рекомендуется применять с осторожностью и уведомлять об этом членов команды, объясняя причину такого действия и планируемое временя отмены блокировки.

Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".

Примеры

В примере файл 314.cs становится доступным для записи и добавляется в список ожидающих изменений для рабочей области.

c:\pi> tf checkout 314.cs

В следующем примере извлекаются файлы 314.cs и 271.cs.

c:\pi>tf checkout 314.cs 271.cs

В следующем примере извлекается файл "page.xsl" и свойство кодировки для типа файла Team Foundationменяется на "text". "Text" — псевдоним для текущей кодировки Windows, например Windows-1252.

c:\pi>tf checkout /type:text page.xsl

См. также

Задачи

Пошаговое руководство. Управление версиями в Team Foundation с помощью командной строки

Практическое руководство. Извлечение и изменение элементов из системы управления версиями

Основные понятия

Основные сведения о типах блокировки

Параметры извлечения Team Foundation

Ссылки

Команда "get"

Команда "checkin"

Команда "unshelve"

Другие ресурсы

Команды служебной программы командной строки "tf"