Comando Folderdiff (controllo della versione di Team Foundation)

Articolo
04/04/2024

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Usare il comando TFVC folderdiff per visualizzare e confrontare una rappresentazione visiva delle differenze tra i file in due cartelle del server, in una cartella del server e in una cartella locale o in due cartelle locali.

Prerequisiti

Per usare il folderdiff comando, è necessario disporre dell'autorizzazione Lettura impostata su Consenti. Per altre informazioni, vedere Autorizzazioni tfvc predefinite.

Sintassi

tf folderdiff [sourcePath] targetPath [/recursive] [/noprompt] [/collection:TeamProjectCollectionUrl] [/filter:filter] [/filterLocalPathsOnly] [/login:username,[password]] [/view:same,different,sourceOnly,targetOnly]

Parametri

Argomenti

Argomento

Descrizione

<sourcePath>

Percorso di origine locale o server nell'operazione di confronto. Se questo argomento non viene fornito ed targetPath è il percorso mappato locale, sourcePath è il percorso del server a cui esegue il mapping.

<targetPath>

Percorso di destinazione locale o server nell'operazione di confronto.

<filter>

Elenco delimitato da punto e virgola di maschere di filtro di inclusione ed esclusione per l'opzione /filter . Il valore predefinito è *o includere tutti. Per una descrizione dettagliata dei filtri e delle maschere, vedere la sezione Osservazioni.

<TeamProjectCollectionUrl>

URL della raccolta di progetti che contiene i file per i quali si desidera visualizzare e confrontare le differenze, ad esempio http://myserver:8080/tfs/DefaultCollection.

<username>

Fornisce un valore all'opzione /login . È possibile specificare un valore di nome utente come DOMAIN\username o username.

Opzioni

Opzione

Descrizione

/recursive

Facoltativo. Confronta completamente le due cartelle in modo ricorsivo.

/noprompt

Facoltativo. Viene eseguito tf folderdiff senza visualizzare l'output nella finestra Differenza cartelle di Visual Studio. La finestra del prompt dei comandi visualizza invece l'output.

/filter

Facoltativo. Specifica un elenco di maschere di inclusione e filtro utilizzate per confrontare i nomi di file e cartelle da confrontare.

/filterLocalPathsOnly

Facoltativo. Specifica che verranno filtrati solo i percorsi locali, a meno che non esista il percorso del server corrispondente.

/view

Facoltativo. Specifica le informazioni da includere nell'output utilizzando un elenco delimitato da virgole dei valori seguenti:

same visualizza i file con lo stesso contenuto nelle directory di origine e di destinazione.
different visualizza i file con contenuto diverso nelle directory di origine e di destinazione.
sourceOnly visualizza i file esistenti solo nella directory di origine.
targetOnly visualizza i file esistenti solo nella directory di destinazione.

Il valore predefinito è different,sourceOnly,targetOnly.

/collection

Specifica la raccolta di progetti.

/login

Specifica il nome utente e la password per autenticare l'utente con Azure DevOps.

Osservazioni:

La finestra del prompt dei comandi visualizza l'output se si specifica /noprompt. In caso contrario, nella finestra Differenza cartella di Visual Studio viene visualizzato l'output.

Quando il sistema confronta la cartella mappata locale con la cartella del server a cui è mappato, l'output nella finestra Differenza cartella include un elenco di modifiche in sospeso. Inoltre, l'output nella finestra Differenza cartella indica se la cartella locale contiene o meno la copia più recente.

L'output visualizzato nella finestra del prompt dei comandi elenca tutti i file nelle cartelle nelle cinque sezioni seguenti:

Elementi presenti solo nella cartella del server.
Elementi presenti solo nella cartella locale.
Elementi con contenuto diverso.
Elementi con contenuto identico. È necessario specificare l'argomento same con l'opzione /view .
Riepilogo.

Filtri di file e cartelle

Un filtro è un elenco ordinato di maschere dei nomi usate per corrispondere al nome dei file e delle cartelle da confrontare. Le maschere possono contenere il carattere jolly del punto interrogativo ? in modo che corrisponda esattamente a un carattere e al carattere jolly asterisco * in modo che corrisponda a zero o più caratteri.

Le maschere vengono delimitate in un filtro usando punti ;e virgola. Le maschere di cartella devono terminare con una barra rovesciata \. Per specificare una maschera di esclusione, anteporre alla maschera un punto !esclamativo .

Il filtro si applica ai nomi di file e cartelle usando le regole seguenti:

Quando un filtro specifica le maschere di file e cartelle, le maschere di file e cartelle vengono separate in un elenco di maschera file e in un elenco di maschere di cartelle. Le maschere di file si applicano solo ai nomi di file. Le maschere di cartella si applicano solo ai nomi delle cartelle.
Per trovare una corrispondenza con il nome di un file o di una cartella, il comando confronta il nome con ogni maschera nel filtro nell'ordine in cui è stato specificato. Non appena il nome corrisponde a una maschera, il nome viene considerato una corrispondenza.
Se le maschere di file nel filtro contengono una maschera di inclusione, i file che non corrispondono ad alcuna maschera file vengono esclusi.
Se le maschere di file nel filtro contengono solo maschere di esclusione, vengono inclusi i file che non corrispondono ad alcuna maschera file.
Se le maschere di cartella nel filtro contengono una maschera di inclusione, le cartelle che non corrispondono a nessuna delle maschere di cartella vengono escluse.
Se le maschere di cartella nel filtro contengono solo maschere di esclusione, vengono incluse cartelle che non corrispondono a nessuna delle maschere di cartella.

Nella tabella seguente sono elencati esempi di maschera nome filtro.

Maschera nome	Descrizione
`*.cs`	Corrisponde a tutti i file C#.
`My*.bmp`	Trova la corrispondenza con tutti i file bitmap che iniziano con My.
`!*.exe`	Esclude tutti i file eseguibili.
`!objd\`	Esclude tutte le cartelle objd .

Nella tabella seguente sono elencati esempi di filtro.

Filtra	Descrizione
`*.cs;!objd\;!obj\;!bin\`	Trova la corrispondenza con tutti i file C# tranne quelli nelle cartelle objd, obj o bin .
`!.resx;!.ini;!resources\;!junk\`	Esclude tutti i file resx e .ini , tutti i file nella cartella resources e tutti i file in qualsiasi cartella con un nome che include la parola indesiderata.

Per altre informazioni su come usare l'utilità della tf riga di comando, vedere Usare i comandi di controllo della versione di Team Foundation.

Esempi

L'esempio seguente confronta i file nella cartella del server e una cartella locale, organizza i file nella cartella locale in modo ricorsivo e visualizza l'output nella finestra del prompt dei comandi.

tf folderdiff $/<serverFolder> F:\<localFolder> /recursive /noprompt

Condividi tramite