Команды Checkout и Edit
Делает локальный файл доступным для записи в рабочей области и изменяет его состояние Ожидающее изменение на "Изменить". Edit является псевдонимом команды Checkout. Дополнительные сведения см. в разделе об ожидающее изменение.
Примечание
Изменения извлеченных элементов не отображаются на сервере Team Foundation (подсистема контроля версий) до тех пор, пока не будет выполнена операция возврата.Дополнительные сведения см. в разделе Возврат ожидающих изменений.
Необходимые разрешения
Для использования команды checkout необходимо иметь разрешение Извлечение со значением Разрешить и являться либо владельцем рабочей области, либо иметь глобальное разрешение Администрирование рабочих областей со значением Разрешить. Кроме того, для использования параметра /lock со значением, отличным от "none", необходимо иметь разрешение Блокировка со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf checkout [/lock:(none|checkin|checkout)] [/recursive]
[/type:encoding] itemspec [/login:username,[password]]
Параметры
Аргумент |
Описание |
|---|---|
encoding |
Предоставляет значение для параметра /type. Альтернативными вариантами являются: Text — псевдоним для текущей кодировки Windows (Windows-1252 в системах США) или Юникод (на основе метки порядка следования байтов (BOM)), Binary и все другие кодировки файлов, поддерживаемые операционной системой Windows. Для автоматического определения типа используется параметр Auto. Дополнительные сведения см. в разделе Управление типами файлов. |
itemspec |
Указывает один или более файлов для извлечения. Допускается использование подстановочных знаков. |
username |
Предоставляет значение для параметра /login. Можно задать значение для имени пользователя как ДОМЕН\имя_пользователя или как имя_пользователя. |
Параметр |
Описание |
|---|---|
/type |
Используется для переопределения кодировки файла, который Team Foundation связывает с указанными файлами, вручную. |
/recursive |
Извлекает все файлы, соответствующие элемент, в текущем каталоге и всех его подкаталогах. |
/lock |
Запрещает извлечение и возврат указанных файлов другими пользователями. Дополнительные сведения см. в разделе Основные сведения о типах блокировки. Параметры блокировки
|
/login |
Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server. |
Заметки
Действие по умолчанию команды 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