Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Artikel ini berlaku untuk: ✔️ .NET 6 SDK dan versi yang lebih baru
Penting
Perintah dotnet vstest digantikan oleh dotnet test, yang sekarang dapat digunakan untuk menjalankan rakitan. Lihat pengujian dotnet.
Nama
dotnet vstest - Menjalankan pengujian dari rakitan yang ditentukan.
Sinopsis
dotnet vstest [<TEST_FILE_NAMES>] [--Blame] [--Collect:<DATA_COLLECTOR_NAME>]
[--Diag:<PATH_TO_LOG_FILE>] [-e|--Environment:<NAME="VALUE">]
[--Framework:<FRAMEWORK>] [--InIsolation] [-lt|--ListTests:<FILE_NAME>]
[--logger:<LOGGER_URI/FRIENDLY_NAME>] [--Parallel]
[--Platform:<PLATFORM_TYPE>] [--ResultsDirectory:<PATH>]
[--Settings:<SETTINGS_FILE>] [--TestAdapterPath:<PATH>]
[--TestCaseFilter:<EXPRESSION>] [--Tests:<TEST_NAMES>] [[--] <args>...]
dotnet vstest -?|--Help
Description
Perintah dotnet vstest menjalankan VSTest.Console aplikasi baris perintah untuk menjalankan pengujian unit otomatis. Opsi dalam artikel ini diteruskan ke vstest.console. Untuk daftar lengkap opsi baris perintah, lihat opsi baris perintahvstest.console.exe.
Arguments
TEST_FILE_NAMESJalankan pengujian dari rakitan yang ditentukan. Pisahkan beberapa nama rakitan pengujian dengan spasi. Penggunaan wildcard didukung.
Opsi
--BlameMenjalankan tes dalam mode menyalahkan. Opsi ini berguna dalam mengisolasi pengujian bermasalah yang menyebabkan host pengujian mengalami crash. Ini membuat file output di direktori saat ini sebagai Sequence.xml yang menangkap urutan eksekusi pengujian sebelum crash.
--Collect:<DATA_COLLECTOR_NAME>Mengaktifkan pengumpul data untuk eksekusi pengujian. Misalnya,
--Collect:"Code Coverage"mengumpulkan cakupan kode dengan pengumpul Visual Studio bawaan, dan--Collect:"XPlat Code Coverage"menggunakan pengumpul Coverlet lintas platform. Untuk informasi selengkapnya, lihat Memantau dan menganalisis pengujian.--Diag:<PATH_TO_LOG_FILE>Mengaktifkan log verbose untuk platform pengujian. Log ditulis ke file yang disediakan.
-e|--Environment:<NAME="VALUE">Mengatur nilai variabel lingkungan untuk proses host pengujian. Membuat variabel jika tidak ada, ambil alih jika tidak. Menggunakan opsi ini memaksa pengujian berjalan dalam proses yang terisolasi. Tentukan opsi beberapa kali untuk mengatur beberapa variabel.
--Framework:<FRAMEWORK>Versi .NET Framework target yang digunakan untuk eksekusi pengujian. Contoh nilai yang valid adalah
.NETFramework,Version=v7.0. Nilai lain yang didukung adalahFramework40, ,Framework45FrameworkCore10, danFrameworkUap10.--InIsolationMenjalankan pengujian dalam proses yang terisolasi. Ini membuat prosesvstest.console.exe cenderung dihentikan pada kesalahan dalam pengujian, tetapi pengujian mungkin berjalan lebih lambat.
-lt|--ListTests:<FILE_NAME>Mencantumkan semua pengujian yang ditemukan dari kontainer pengujian yang diberikan.
--logger:<LOGGER_URI/FRIENDLY_NAME>Tentukan pencatat untuk hasil pengujian.
Untuk menerbitkan hasil pengujian ke Team Foundation Server, gunakan penyedia pencatat
TfsPublisher:/logger:TfsPublisher; Collection=<team project collection url>; BuildName=<build name>; TeamProject=<team project name> [;Platform=<Defaults to "Any CPU">] [;Flavor=<Defaults to "Debug">] [;RunTitle=<title>]Untuk mencatat hasil ke File Hasil Pengujian Visual Studio (TRX), gunakan penyedia pencatat
trx. Sakelar ini membuat file di direktori hasil pengujian dengan nama file log yang diberikan. JikaLogFileNametidak disediakan, nama file unik dibuat untuk menyimpan hasil pengujian./logger:trx [;LogFileName=<Defaults to unique file name>]
--ParallelJalankan pengujian secara paralel. Secara default, semua inti yang tersedia pada komputer tersedia untuk digunakan. Tentukan jumlah inti eksplisit dengan mengatur
MaxCpuCountproperti di bawah simpulRunConfigurationdalam file runsettings .--Platform:<PLATFORM_TYPE>Arsitektur platform target yang digunakan untuk eksekusi pengujian. Nilai yang valid adalah
x86, ,ARMx64,ARM64,S390x,Ppc64le,RiscV64, danLoongArch64.--ResultsDirectory:<PATH>Direktori hasil pengujian akan dibuat di jalur yang ditentukan jika tidak ada.
--Settings:<SETTINGS_FILE>Pengaturan yang digunakan saat menjalankan pengujian.
--TestAdapterPath:<PATH>Gunakan adaptor pengujian kustom dari jalur tertentu (jika ada) dalam uji coba.
--TestCaseFilter:<EXPRESSION>Jalankan pengujian yang cocok dengan ekspresi yang diberikan.
<EXPRESSION>adalah format<property>Operator<value>[|&<EXPRESSION>], di mana Operator adalah salah satu dari=,!=, atau~. Operator~memiliki semantik 'berisi' dan berlaku untuk properti string sepertiDisplayName.()Tanda kurung digunakan untuk mengelompokkan subekspresi. Untuk informasi selengkapnya, lihat Filter TestCase.--Tests:<TEST_NAMES>Jalankan pengujian dengan nama yang cocok dengan nilai yang disediakan. Pisahkan beberapa nilai dengan koma.
-?|--HelpMencetak bantuan singkat untuk perintah.
@<file>Membaca file respons untuk opsi lainnya.
argsMenentukan argumen tambahan untuk diteruskan ke adapter. Argumen ditentukan sebagai pasangan nilai nama formulir
<n>=<v>, di mana<n>adalah nama argumen dan<v>merupakan nilai argumen. Gunakan spasi untuk memisahkan beberapa argumen.
Examples
Jalankan pengujian di mytestproject.dll:
dotnet vstest mytestproject.dll
Jalankan pengujian di mytestproject.dll, mengekspor ke folder kustom dengan nama kustom:
dotnet vstest mytestproject.dll --logger:"trx;LogFileName=custom_file_name.trx" --ResultsDirectory:custom/file/path
Jalankan pengujian di mytestproject.dll dan myothertestproject.exe:
dotnet vstest mytestproject.dll myothertestproject.exe
Jalankan TestMethod1 pengujian:
dotnet vstest /Tests:TestMethod1
Jalankan TestMethod1 dan TestMethod2 uji:
dotnet vstest /Tests:TestMethod1,TestMethod2
Lihat juga
-
VSTest.Console.exe opsi baris perintah (Microsoft Learn) - referensi resmi Microsoft Learn untuk alat ini
VSTest.Console.exe, termasuk opsi yangdotnet vstesttidak diekspos. Mulai di sini untuk dokumentasi yang stabil dan dikumpulkan. -
VSTest.Console.exe opsi baris perintah (repositori microsoft/vstest) - referensi yang diturunkan sumber dalam repositori
microsoft/vstest. Gunakan untuk detail opsi paling up-to-tanggal dan sakelar internal, ditambah tautan ke runsetting, pemfilteran, dan dokumen diagnostik terkait. -
Variabel lingkungan VSTest (microsoft/vstest) - variabel lingkungan yang dikenal vsTest dan host pengujian, seperti
VSTEST_DUMP_FORCEPROCDUMPdanVSTEST_DOTNET_ROOT_*variabel yang ditetapkan SDK .NET saat meluncurkanvstest.console.