Átnevezés parancs (Team Foundation verziókövetés)

  • Cikk

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

A Team Foundation Verziókövetés (TFVC) rename parancsa megváltoztatja egy fájl vagy mappa nevét vagy elérési útját. A parancs vagy az aliasok moverenhasználatával rename áthelyezhet egy fájlt vagy mappát egy új helyre.

Feljegyzés

A parancs eredményei mindaddig nem jelennek meg a kiszolgálón, amíg be nem jelentkezik. További információ: Kód fejlesztése és függőben lévő módosítások kezelése.

Előfeltételek

A rename parancs használatához engedélyeznie kell a kivételi engedélyt. További információ: Alapértelmezett TFVC-engedélyek.

Syntax

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

Paraméterek

Argumentumok

Argumentum

Leírás

<olditem>

Az átnevezni kívánt fájl vagy mappa eredeti neve és elérési útja. Megadhat egy helyi munkaterület elérési útját, például a C:\myfiles\314.cs vagy egy TFVC-kiszolgáló elérési útját, például $/myfiles/314.cs.

<newitem>

A fájl vagy mappa új neve. Ezzel megadhat egy másik helyi vagy egy TFVC-kiszolgáló elérési útját.

<username>

Értéket ad a /login beállításnak. Megadhatja a felhasználónevet vagy a DOMAIN\usernameusernamenevet.

Beállítások

Beállítás

Leírás

/lock

Ezzel a beállítással megakadályozhatja, hogy más felhasználók bejelentkezhessenek vagy kivenni a megadott elemeket. Ha ez a beállítás nincs megadva, az elem meglévő zárolási állapota nem módosul. További információ: A zárolási típusok ismertetése.

Zárolási beállítások:

  • None: Nincs zárolás alkalmazva.
  • Checkin: Más felhasználók megtekinthetik a megadott elemeket, de a zárolás feloldásáig nem tudnak korrektúrákat beadni a zárolt fájlokba. Ha bármely más felhasználó zárolta a megadott elemek bármelyikét, a zárolási művelet meghiúsul.
  • Checkout: Megakadályozza, hogy más felhasználók a megadott elemek bármelyikét be- vagy kijelentkeztetik, amíg fel nem oldja a zárolást egy bejelentkezéssel. Ha bármely más felhasználó zárolta a megadott elemek bármelyikét, a zárolási művelet meghiúsul.

/login

Megadja a felhasználónevet és a jelszót, amellyel hitelesítheti a felhasználót az Azure DevOpsszal.

Megjegyzések

A parancssori segédprogram parancsával tf áthelyezhet vagy átnevezhet rename egy verzióvezérelt elemet a munkaterületen. rename A paranccsal több fájlt is áthelyezhet helyettesítő karakterek megadásával. Több verzió által vezérelt fájl vagy mappa átnevezésének lehetősége csak a parancssorból érhető el.

rename A parancs használatával hajtsa végre a következő műveleteket:

  • Nevezze át a olditem következőrenewitem:tf rename 314.cs 315.cs
  • Helyezze át az olditem új helyre a TFVC-kiszolgálón azáltal, hogy megad egy newitem olyan elérési utat, amely eltér az olditemadott kiszolgálóétól, például tf rename 314.cs ..\newdir\314.cs.

Ha olyan newitem mappát ad meg, amely nem létező mappát határoz meg, a rename parancs létrehozza a célmappát. Ha newitem mappa, olditem akkor a mappa gyermekévé newitemválik.

Az elemek nem nevezhetők át, ha:

  • Már törölte, mielőtt be lett jelentkezve ugyanahhoz a munkaterülethez.
  • Az új név már létezik a TFVC-kiszolgálón, és nem mappa.
  • Már hozzáadta, elágaztatott vagy átnevezte az elem függőben lévő beadását.
  • Az elem le van képezve a munkaterületen, de nem érhető el a helyi lemezen.
  • Az elem álcázva van.

Átnevezhet egy elemet, amelyhez egy másik, azonos nevű fájlt adtak hozzá a bejelentkezéshez, de nem nevezhet át elágaztatott, de még be nem jelentkezett elemet. Ha átnevez egy függőben lévő módosításokat tartalmazó fájlt, a módosítások megmaradnak.

A kifejezetten megfeleltetett elemek nem nevezhetők át a leképezés első módosítása nélkül. Ha például a $/ProjectX/MyApp munkamappa-leképezése a következőre van: c:\MyApp, akkor nem nevezheti át a MyAppot. A MyApp alatt átnevezheti az elemeket, magát a MyAppot azonban nem.

A parancssori segédprogram használatáról további információt a tf Team Foundation verziókövetési parancsainak használata című témakörben talál.

Példák

Az alábbi példa a 314.cs nevét 1254.cs-ra módosítja.

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

Az alábbi példa átnevezi 314.cs1254.cs , és áthelyezi a newdir mappába.

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

Az alábbi példa Form1.vb nevét MainPage.vb értékre módosítja, és zárolást alkalmaz rá.

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