Comando Add
Aggiornamento: novembre 2007
Aggiunge nuovi file e cartelle da un percorso del file system locale a un server Controllo della versione di Team Foundation.
.gif "Nota") Nota: |
|---|
I risultati di questo comando non risulteranno disponibili nel server Controllo della versione di Team Foundation finché non verrà eseguita un'operazione di archiviazione. Per ulteriori informazioni, vedere Procedura: archiviare le modifiche in sospeso. |
Autorizzazioni necessarie
Per utilizzare il comando add è necessario essere proprietario dell'area di lavoro e disporre dell'autorizzazione Estrai per la cartella padre dei nuovi elementi impostati su Consenti. È inoltre necessario avere l'autorizzazione Blocca impostata su Consenti se viene utilizzato /lock:checkout o /lock:checkin. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
tf add itemspec [/lock:none|checkin|checkout] [/type:filetype]
[/noprompt] [/recursive]
Parametri
Argomento |
Descrizione |
|---|---|
itemspec |
Identifica i file o le cartelle da aggiungere. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation sui parametri itemspec per determinare gli elementi all'interno dell'ambito, vedere Sintassi della riga di comando (Team System). |
filetype |
Viene utilizzato con l'opzione /type. Per ulteriori informazioni, vedere Tipi di file. |
Opzione |
Descrizione |
|---|---|
/type |
Esegue l'override della corrispondenza del tipo di file e aggiunge i file al server Controllo della versione di Team Foundation che utilizza il tipo specificato. Per ulteriori informazioni, vedere Tipi di file. Il rilevamento del tipo di file si basa sul contenuto del primo kilobyte del file. |
/lock |
Specifica un tipo di blocco o rimuove un blocco da un elemento. Opzioni di blocco:
|
/noprompt |
Non vengono visualizzati prompt che richiedono l'input da parte dell'utente. |
/recursive |
Aggiunge tutti gli elementi inclusi nella directory specificate e nelle eventuali sottodirectory. |
Note
Prima di poter aggiungere un elemento al controllo della versione, è necessario impostare un'area di lavoro locale e definire i mapping delle cartelle di lavoro. Per ulteriori informazioni su come iniziare, vedere Procedura dettagliata: utilizzo del controllo delle versioni di Team Foundation dalla riga di comando.
Add è un comando di tipo Modifiche in sospeso. Consente di pianificare l'aggiunta di elementi specificati al server Controllo della versione di Team Foundation nell'area di lavoro in attesa del completamento di un'operazione di archiviazione. Per eseguire un comando di tipo pending change, la directory corrente deve essere mappata a un'area di lavoro e al server Controllo della versione di Team Foundation corrispondente.
Quando si utilizza il comando Add per aggiungere un nuovo elemento al controllo della versione, l'elemento viene effettivamente aggiunto al server del Controllo della versione di Team Foundation solo dopo l'archiviazione delle ultime modifiche apportate all'area di lavoro. L'elemento viene invece aggiunto all'elenco delle modifiche in sospeso per l'area di lavoro corrente. Per eseguire il commit dell'operazione di aggiunta delle modifiche in sospeso nel server Controllo della versione di Team Foundation, è possibile archiviare direttamente il file aggiunto oppure archiviare tutte le modifiche in sospeso nell'area di lavoro locale. Per evitare che un altro utente possa aggiungere un file o una cartella con lo stesso nome di quella delle aggiunte in sospeso al server del Controllo della versione di Team Foundation prima di poter archiviare le proprie modifiche in sospeso, è possibile includere l'opzione /lock con il parametro Checkout. Per ulteriori informazioni, vedere Procedura: archiviare le modifiche in sospeso.
Se si aggiunge il file 314.cs al controllo della versione utilizzando tf add /teamproject/projects/math/314.cs, ciascuna cartella verrà considerata un'aggiunta in sospeso se non esiste già, finché non verranno archiviate le modifiche. Quando si archiviano le modifiche, se una delle cartelle nel percorso specificato (/teamproject, /teamproject/projects o /teamproject/projects/math) non è già presente nel server del Controllo della versione di Team Foundation, verrà creata automaticamente in Team Foundation.
Utilizzare il comando Add per definire la struttura iniziale dei file di un server Controllo della versione di Team Foundation. Per ulteriori informazioni, vedere la classe Procedura dettagliata: utilizzo del controllo delle versioni di Team Foundation dalla riga di comando.
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 riportato di seguito consente di aggiungere i file 314.c e 1256.c all'elenco delle modifiche in sospeso dell'area di lavoro cui è associata la cartella di lavoro C:\Pi.
c:\pi>tf add 314.cs 1256.c
L'esempio riportato di seguito consente di aggiungere tutti i file in codice C# (con estensione cs) presenti nella directory corrente e nelle eventuali sottodirectory all'elenco delle aggiunte in sospeso per l'area di lavoro corrente.
c:\projects>tf add *.cs /recursive
L'esempio riportato di seguito consente di aggiungere tutti i file e le cartelle il cui nome include "hello" presenti nella directory corrente e nelle eventuali sottodirectory all'elenco delle aggiunte in sospeso per l'area di lavoro cui è mappato c:\projects.
c:\projects>tf add *hello* /recursive
Vedere anche
Attività
Procedura: archiviare le modifiche in sospeso
Procedura: bloccare e sbloccare cartelle o file
Concetti
Informazioni sui tipi di blocco