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:

  • Nessuna correzione

    Default. Non viene applicato alcun blocco. Se sul file specificato esiste un blocco, l’opzione None lo rimuove.

  • Checkin

    Altri utenti possono estrarre gli elementi specificati, ma non archiviare revisioni in file bloccati fino a quando il blocco non viene rilasciato. Se uno qualsiasi degli elementi specificati è stato bloccato da un qualsiasi altro utente, l'operazione di blocco non viene eseguita.

  • Checkout

    Impedisce ad altri utenti di estrarre uno qualsiasi degli elementi specificati fino al rilascio del blocco. Se uno qualsiasi degli elementi specificati è stato bloccato da un qualsiasi altro utente, l'operazione di blocco non viene eseguita.

/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

Comando Get

Comando Checkin

Comando Unshelve

Concetti

Informazioni sui tipi di blocco

Impostazioni di estrazione di Team Foundation

Altre risorse

Comandi dell'utilità della riga di comando Tf