Поделиться через

Команда "Переименовать" (Team Foundation Version Control)

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Команда Team Foundation Version Control (TFVC) rename изменяет имя или путь к файлу или папке. Можно использовать команду rename или псевдонимы move или ren, чтобы переместить файл или папку в новое расположение.

Заметка

Результаты этой команды не отражаются на сервере, пока не выполните вход. Дополнительные сведения см. в статье Разработка кода и управление ожидающих изменений.

Необходимые условия

Чтобы использовать команду rename, укажите разрешение на Разрешить. Дополнительные сведения см. в разделе разрешения TFVC по умолчанию.

Синтаксис

tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem

Параметры

Аргументы

аргумент

описание

<olditem>

Исходное имя и путь к файлу или папке, которые необходимо переименовать. Можно указать путь к локальной рабочей области, например C:\myfiles\314.cs или путь к серверу TFVC, например $/myfiles/314.cs.

<newitem>

Новое имя файла или папки. Это можно использовать для указания другого локального или расположения пути к серверу TFVC.

<username>

Предоставляет значение для параметра /login. Можно указать значение имени пользователя как DOMAIN\username или username.

Параметры

параметра

описание

/lock

Включите этот параметр, чтобы запретить другим пользователям выполнять вход или проверять указанные элементы. Если этот параметр не указан, существующее состояние блокировки элемента не изменяется. Дополнительные сведения см. в статье Общие сведения о типах блокировки.

Параметры блокировки:

  • None: блокировка не применяется.
  • Checkin: другие пользователи могут извлечь указанные элементы, но они не могут регистрировать исправления для заблокированных файлов, пока не выпустите блокировку, выполнив вход. Если другие пользователи заблокировали любой из указанных элементов, операция блокировки завершается ошибкой.
  • Checkout. Запрещает другим пользователям выполнять вход или извлечение одного из указанных элементов до тех пор, пока не выпустите блокировку, выполнив вход. Если другие пользователи заблокировали любой из указанных элементов, операция блокировки завершается ошибкой.

/login

Указывает имя пользователя и пароль для проверки подлинности пользователя с помощью Azure DevOps.

Замечания

Вы можете использовать команду rename программы командной строки tf для перемещения или переименования элемента, управляемого версией в рабочей области. Используйте команду rename для перемещения нескольких файлов, указав подстановочные знаки. Возможность переименовать несколько управляемых версий файлов или папок доступна только из командной строки.

Используйте команду rename для выполнения следующих действий:

  • Переименуйте olditem в newitem, например tf rename 314.cs 315.cs.
  • Переместите olditem в новое расположение на сервере TFVC, предоставив newitem, путь которого отличается от olditem, например tf rename 314.cs ..\newdir\314.cs.

Если указать newitem, указывающую несуществующую папку, команда rename создает целевую папку. Если newitem является папкой, olditem становится дочерним элементом newitem.

Невозможно переименовать элемент, если:

  • Вы уже удалили его перед его возвратом в ту же рабочую область.
  • Новое имя уже существует на сервере TFVC и не является папкой.
  • Вы уже добавили, ветвление или переименовали ожидающий возврат элемента.
  • Элемент сопоставляется в рабочей области, но недоступен на локальном диске.
  • Элемент закрыт.

Вы можете переименовать элемент, для которого добавлен другой файл с тем же именем, ожидающий регистрации, но вы не можете переименовать элемент, который был ветвлен, но еще не установлен. При переименовании файла с ожидающими изменениями сохраняются изменения.

Элемент, который явно сопоставлен, нельзя переименовать, не изменив сопоставление. Например, если сопоставление рабочих папок $/ProjectX/MyApp с c:\MyApp, нельзя переименовать MyApp. Элементы можно переименовать в разделе MyApp, но не myApp.

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

Примеры

В следующем примере имя 314.cs изменяется на 1254.cs.

c:\projects>tf rename  314.cs  1254.cs

Следующий пример переименовывает 314.cs на 1254.cs и перемещает его в папку newdir.

c:\projects>tf rename 314.cs ..\newdir\1254.cs

В следующем примере имя Form1.vb изменяется на MainPage.vb и применяет к нему блокировку.

c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin