Comandi Checkout ed Edit
Rende scrivibile il file locale e ne modifica lo stato Modifica in sospeso in "modifica" nell'area di lavoro. Edit è un alias per il comando Checkout. Per ulteriori informazioni, vedere Modifiche in sospeso.
Nota
Eventuali modifiche apportate a elementi estratti non risulteranno disponibili nel server per Controllo della versione di Team Foundation fino a quando non verrà eseguita un'operazione di archiviazione. Per ulteriori informazioni, vedere Archiviare modifiche in sospeso.
Autorizzazioni necessarie
Per utilizzare il comando checkout è necessario disporre dell'autorizzazione Estrai impostata su Consenti oppure essere il proprietario dell'area di lavoro o disporre dell'autorizzazione globale Amministra aree di lavoro impostata su Consenti. Inoltre, se si utilizza l'opzione /lock con un valore diverso da none, l'autorizzazione Blocca deve essere impostata su Consenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
tf checkout [/lock:(none|checkin|checkout)] [/recursive]
[/type:encoding] itemspec [/login:username,[password]]
Parametri
Argomento |
Oggetto di descrizione |
|---|---|
encoding |
Fornisce un valore per l'opzione /type. Tra le alternative sono inclusi Text che rappresenta un alias della codifica Windows corrente (Windows-1252 in sistemi statunitensi), Unicode (basata sull'indicatore per l'ordine dei byte, BOM) Binary e tutte le altre codifiche di file supportate dal sistema operativo Windows. È inoltre possibile utilizzare Auto che è in grado di rilevare il tipo automaticamente. Per ulteriori informazioni, vedere Gestione di tipi di file. |
itemspec |
Indica uno o più file da estrarre. Qui è possibile utilizzare caratteri jolly. |
username |
Fornisce un valore all'opzione /login. È possibile specificare un valore username come DOMINIO\NomeUtente o NomeUtente. |
Opzione |
Oggetto di descrizione |
|---|---|
/type |
Esegue l'override manuale della codifica file associata da Team Foundation ai file specificati. |
/recursive |
Estrae tutti i file corrispondenti a itemspec nella directory corrente e in tutte le sottocartelle. |
/lock |
Impedisce ad altri utenti di eseguire operazioni di archiviazione o estrazione sui file specificati. Per ulteriori informazioni, vedere Informazioni sui tipi di blocco. Opzioni di blocco:
|
/login |
Consente di specificare il nome utente e la password necessari per autenticare l'utente con Visual Studio Team Foundation Server. |
Note
Il comportamento predefinito del comando checkout sarà determinato dall'attivazione dell'impostazione Leggi l'ultima versione dell'elemento all'archiviazione. Per ulteriori informazioni su come visualizzare o modificare questa impostazione, vedere Abilitare il controllo della versione di Team Foundation per estrarre i file più recenti.
Se Leggi l'ultima versione dell'elemento all'archiviazione è attiva, il comportamento del comando checkout sarà simile al comportamento di estrazione in Visual SourceSafe. Se la versione più recente dell'elemento non è nell'area di lavoro, Team Foundation recupera la versione più recente da Team Foundation Server e la copia nell'area di lavoro. Se una versione precedente dello stesso elemento è nell'area di lavoro, l'elemento viene sovrascritto dalla versione più recente.
Se Leggi l'ultima versione dell'elemento all'archiviazione non è attiva, Team Foundation non ottiene l'ultima versione del server del Controllo della versione di Team Foundation durante un'operazione di estrazione. Viene invece resa scrivibile la versione corrente dell'area di lavoro. Per ulteriori informazioni, vedere Ottenere il codice sorgente per il progetto team.
È possibile utilizzare tf edit come alias di checkout.
Per impostazione predefinita, più utenti contemporaneamente possono estrarre lo stesso elemento incluso nel controllo della versione. Quando si utilizza tf per estrarre un elemento con modifiche in sospeso in un'altra area di lavoro, sulla riga di comando vengono visualizzate le informazioni sulla natura delle modifiche. Nella maggior parte degli ambienti di sviluppo collaborativi, è improbabile che venga apportata una modifica nella propria area di lavoro che rappresenta un potenziale conflitto di unione con una modifica in sospeso in un'altra area di lavoro o viceversa. Team Foundation consente di risolvere automaticamente la maggior parte dei conflitti che si verifica. In caso di conflitti che non possono essere risolti automaticamente, utilizzare Comando Resolve per decidere in modo sicuro quale modifica, propria o di altri utenti, si desidera mantenere. Per evitare che un altro utente possa apportare nella propria area di lavoro modifiche in conflitto con le modifiche in sospeso, è possibile utilizzare Comando Status per controllare le modifiche applicate di recente in altre aree di lavoro. In alternativa, è possibile utilizzare il Comando Lock per impedire ad altri utenti di eseguire operazioni di estrazione o archiviazione fino a quando non vengono archiviate e sbloccate le proprie modifiche. È consigliabile utilizzare il comando lock con discrezione e informare i colleghi del team dei motivi per i quali viene utilizzato, fornendo una stima dei tempi di rimozione del blocco.
Per ulteriori informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.
Esempi
L'esempio seguente consente di rendere il file 314.cs scrivibile su disco e di aggiungerlo all'elenco di modifiche in sospeso per l'area di lavoro.
c:\pi> tf checkout 314.cs
L'esempio riportato di seguito consente di estrarre entrambi i file 314.cs e 271.cs.
c:\pi>tf checkout 314.cs 271.cs
L'esempio seguente consente di estrarre il file page.xsl e di modificare la proprietà di codifica per il tipo di file di Team Foundation in testo. Text è un alias della codifica corrente di Windows, ad esempio Windows-1252.
c:\pi>tf checkout /type:text page.xsl
Vedere anche
Attività
Estrarre e modificare gli elementi inclusi nel controllo della versione
Riferimenti
Concetti
Informazioni sui tipi di blocco
Impostazioni di estrazione di Team Foundation