Uso di migrate.exe

Migrazioni Code First può essere usato per aggiornare un database dall'interno di Visual Studio, ma può anche essere eseguito tramite lo strumento da riga di comando migrate.exe. Questa pagina contiene una rapida panoramica su come usare migrate.exe per eseguire migrazioni su un database.

Copiare migrate.exe

Quando si installa Entity Framework usando NuGet migrate.exe si trova all'interno della cartella degli strumenti del pacchetto scaricato. Nella <cartella> del progetto\packages\EntityFramework.<version>\tools

Dopo aver eseguito migrate.exe, è necessario copiarlo nel percorso dell'assembly che contiene le migrazioni.

Se l'applicazione è destinata a .NET 4 e non alla versione 4.5, sarà necessario copiare il file Redirect.config nel percorso e rinominarlo migrate.exe.config. In questo modo migrate.exe ottiene i reindirizzamenti di binding corretti per poter individuare l'assembly Entity Framework.

.NET 4.5	.NET 4.0

Dopo aver spostato migrate.exe nella cartella corretta, sarà possibile usarlo per eseguire le migrazioni nel database. Tutte le utilità sono progettate per eseguire migrazioni. Non può generare migrazioni o creare uno script SQL.

Visualizzare le opzioni

Migrate.exe /?

Nella pagina precedente verrà visualizzata la pagina della Guida associata a questa utilità, si noti che sarà necessario avere EntityFramework.dll nella stessa posizione in cui si esegue migrate.exe per poter funzionare.

Eseguire la migrazione alla migrazione più recente

Migrate.exe MyMvcApplication.dll /startupConfigurationFile="..\\web.config"

Quando si esegue migrate.exe, l'unico parametro obbligatorio è l'assembly, ovvero l'assembly che contiene le migrazioni che si sta tentando di eseguire, ma userà tutte le impostazioni basate sulle convenzioni se non si specifica il file di configurazione.

Eseguire la migrazione a una migrazione specifica

Migrate.exe MyApp.exe /startupConfigurationFile="MyApp.exe.config" /targetMigration="AddTitle"

Se si desidera eseguire migrazioni fino a una migrazione specifica, è possibile specificare il nome della migrazione. Verranno eseguite tutte le migrazioni precedenti in base alle esigenze fino a raggiungere la migrazione specificata.

Specificare la directory di lavoro

Migrate.exe MyApp.exe /startupConfigurationFile="MyApp.exe.config" /startupDirectory="c:\\MyApp"

Se l'assembly ha dipendenze o legge i file relativi alla directory di lavoro, sarà necessario impostare startupDirectory.

Specificare la configurazione della migrazione da usare

Migrate.exe MyAssembly CustomConfig /startupConfigurationFile="..\\web.config"

Se sono presenti più classi di configurazione della migrazione, le classi che ereditano da DbMigrationConfiguration, è necessario specificare quale deve essere usato per questa esecuzione. Questo parametro viene specificato specificando il secondo parametro facoltativo senza un'opzione come sopra.

Fornire stringa di connessione

Migrate.exe BlogDemo.dll /connectionString="Data Source=localhost;Initial Catalog=BlogDemo;Integrated Security=SSPI" /connectionProviderName="System.Data.SqlClient"

Se si desidera specificare un stringa di connessione nella riga di comando, è necessario specificare anche il nome del provider. Se non si specifica il nome del provider, verrà generata un'eccezione.

Problemi comuni