MSTest.exe komut satırı seçenekleri

MSTest.exe testleri çalıştırmak için kullanılan komut satırı komutudur.Bu komut, test çalışmasını özelleştirmek için kullanabileceğiniz birkaç seçeneğe sahiptir.Bu seçeneklerden birçoğunu birbirleriyle kullanabilirsiniz. Aslında, aşağıdaki bölümlerde gösterildiği gibi belirli seçenekleri diğer seçeneklerle birlikte kullanmalısınız.MSTest.exe komut satırında bu seçenekleri herhangi bir sırada belirleyebilirsiniz.

MSTest.exe seçenekleri veya bu seçenekler için belirlediğiniz değerleri büyük/küçük harfe duyarlı bir şekilde yorumlamaz.

Aşağıdaki tablolar, MSTest.exe için tüm seçenekleri ve bunların kısa açıklamalarını listeler.Komut satırına MSTest/h yazarak benzer bir özeti görebilirsiniz.

Genel Komut Satırı Seçenekleri

Test Sonuçlarını Yayınlamak için Komut Satırı Seçenekleri

Bu seçenekler hakkında daha fazla bilgi için, bkz. Test sonuçlarını yayımlamak için Komut Satırı seçenekleri.

MSTest Seçeneklerini Kullanma

Aşağıdaki bölümlerde, MSTest.exe için seçeneklerin çoğu daha ayrıntılı açıklanmaktadır.Test sonuçlarını yayımlamak üzere kullanılan seçenekler buraya dahil edilmez.Bu seçenekler hakkında daha fazla bilgi için, bkz. Test sonuçlarını yayımlamak için Komut Satırı seçenekleri.

/testcontainer

/testcontainer:[file name]

Test kapsayıcı, çalıştırmak istediğiniz testleri içeren bir dosyadır.Örneğin, düzenli testler için, test kapsayıcı düzenli testi tanımlayan .orderedtest dosyasıdır.Birim testler için, birim testi kaynak dosyalarını içeren test projesinden bütünleştirilmiş kod yapısı olur.

[!NOT]

Birim testler için, test kodunu içeren bütünleştirilmiş koddur, test ettiğiniz uygulamanın kodunu içeren bütünleştirilmiş kod değil.Örneğin, çözümünüz BankAccount adında bir proje ve BankAccountTest adlı karşılık gelen bir test projesi içeriyorsa /testcontainer:BankAccountTest.dll belirtin.

[!NOT]

Test meta veriler dosyası çalıştırabileceğiniz testleri de listelediği için, /testcontainer ve /testmetadata seçeneklerini aynı komut satırında belirlememeniz gerekir. Bunu yapmanız belirsizlik yaratır ve hataya neden olabilir.

/testmetadata

/testmetadata:[file name]

Testleri birden çok test kapsayıcıda çalıştırmak için /testmetadata seçeneğini kullanabilirsiniz.

Test meta veri dosyası, Test Listesi Düzenleyici penceresini kullanarak test listeleri oluşturduğunuzda, çözümünüz için oluşturulur.Bu dosya Test Listesi Düzenleyicisi penceresinde listelenen tüm testler hakkında bilgileri içerir.Bunlar, çözümünüzdeki tüm test projelerinde mevcut olan tüm testlerdir.

Test meta veri dosyası, çözüm klasöründe oluşturulan bir XML dosyasıdır.Bu dosya Çözüm Gezgini'nde Çözüm Öğeleri düğümü altında görüntülenir.Bir test meta verisinin dosya uzantısı .vsmdi'dir ve Test Listesi Düzenleyicisi penceresiyle ilişkilidir.Yani Windows Explorer (veya Dosya Gezgini) içinde .vsmdi dosyasını çift tıklarsanız dosya Visual Studio ve onun içeriğini açar.Çözümün test projelerindeki tüm testler, Test Listesi Düzenleyicisi penceresinde görüntülenir.

Yalnızca Test Listesi Düzenleyicisi penceresinde etkilenen değişiklikleri yaparak testler oluşturma veya silme ya da testin özelliklerini değiştirme gibi test meta veri dosyasını değiştirebilirsiniz.

[!NOT]

Test kapsayıcı çalıştırabileceğiniz testleri içerdiği için, /testcontainer ve /testmetadata seçeneklerini aynı komut satırında belirlememeniz gerekir. Bunu yapmanız belirsizlik yaratır ve hataya neden olabilir.

/testmetadata seçeneğini kullanırken, /test seçeneğini veya /testlist seçeneğini ya da her ikisini de kullanarak çalıştırılması için belirli testler seçmeniz önerilir.

/testlist

/testlist:[test list path]

/testlist seçeneği, test meta veri dosyasında belirtildiği gibi çalıştırılacak testlerin bir listesidir.Birden çok test listesinde bulunan testleri çalıştırmak için /testlist seçeneğini birden çok kez kullanın.Test listesindeki tüm düzenli testler çalıştırılacak.

[!NOT]

/testlist seçeneğini yalnızca /testmetadata seçeneği ile birlikte kullanabilirsiniz.

/testlist seçeneğini ve /test seçeneğini birlikte kullanabilirsiniz.Bu, Test Listesi Düzenleyicisi penceresinde bir test listesini ve bir veya daha fazla testi ayrı ayrı seçmeye, ardından Testleri Çalıştır öğesini tıklamaya eşdeğerdir.

/category

/category:[test category filter]

Hangi test kategorisinin çalıştırılacağını belirlemek için /category seçeneğini seçin.

[!NOT]

/category seçeneğini kullanmak için /testcontainer seçeneğini kullanmalısınız.

/category seçeneğini her komut satırı için bir kez kullanabilirsiniz, ancak test kategorisi filtresinde birden çok test kategorisi belirleyebilirsiniz.Test kategorisi filtresi, '&', '|', '!', '&!' mantıksal işleçlerle ayrılmış bir veya daha fazla test kategorisinden oluşur.Mantıksal işleçler '&' ve '|' test kategorisi filtresi oluşturmak için birlikte kullanılamaz.

Örnek:

• /category:group1 "grup1" test kategorisinde olan testleri çalıştırır.

• /category:"group1&group2" "grup1" ve "grup2" test kategorilerindeki testleri çalıştırır. Belirtilen test kategorilerinden yalnızca birinde bulunan testler çalıştırılmaz.

• /category:"group1|group2" "grup1" veya "grup2" test kategorisinde olan testleri çalıştırır.Her iki test kategorisindeki testler de çalıştırılır.

• /category:"group1&!group2" "grup1" içinde olup "grup2" içinde olmayan test kategorilerindeki testleri çalıştırır. "grup1" ve "grup2" test kategorisindeki bir test çalıştırılamaz.

  [!NOT]

  Filtreniz, /category:group1 gibi tek bir kategoriden oluşuyorsa, filtreyi tırnak işaretleriyle ayırmanız gerekmez.Ancak filtre başvurunuz /category:"group1&group2" gibi birden çok kategoriden oluşuyorsa, filtre tırnak işaretleri arasına alınmalıdır.

/test

/test:[test name]

Bireysel testleri çalıştırmak için /test seçeneğini kullanın.Birden çok test çalıştırmak için /test seçeneğini birden çok kez kullanın.

[!NOT]

/test seçeneğini /testcontainer seçeneğiyle veya /testmetadata seçeneğiyle kullanabilirsiniz, her ikisiyle birden kullanamazsınız.

/testlist seçeneğini ve /test seçeneğini birlikte kullanabilirsiniz.Bu, Test Listesi Düzenleyicisi penceresinde bir test listesini ve bir veya daha fazla testi ayrı ayrı seçmeye, ardından Testleri Çalıştır öğesini tıklamaya eşdeğerdir.

/test seçeneğiyle belirlediğiniz dize, test kapsayıcıdaki veya test meta veri dosyasındaki testlerin adlarını eşleştirmek için kullanılır.Bu, /test için tek bir değer kullanarak birden çok testi belirtebileceğiniz anlamına gelir.Örneğin, her iki test adı da 'ittest' alt dizesini içerdiğinden /test:ittest öğesini belirlemek, testlerin DebitTest ve CreditTest adlı testlerle eşleşmelerini üretir.

[!NOT]

/test seçeneğiyle belirlediğiniz değer, Çözüm Gezgini'nde görüldüğü gibi veya birim testlerinde tam adı için, yalnızca testin adına karşılık değil, testin yoluna da karşılık gelir.

İki kullanım örneği şöyledir:

Birim testi örneği: TestProject2 projesinde UnitTest1.cs dosyası TestMethod1 adında bir birim testi içerir./test seçeneği için 'ittest' değeri belirlemek de bu testle eşleşir çünkü dize "TestProject2.UnitTest1.TestMethod1" tam adına karşılık test edilir ve 'ittest' dizesi 'UnitTest1' içinde de görünür.

Genel test örneği: Aşağıdaki komut satırı belirtilen genel testi çalıştırır ve test sonuçlarında, testin tam yolunu görüntüler.

mstest /testcontainer:"C:\Documents and Settings\<user name>\My Documents\Visual Studio\Projects\TestProject2\TestProject2\generictest1.generic" /test:testproject32\generic

/noisolation

/noisolation

Testleri MSTest.exe işlemiyle çalıştırmak için bu seçeneği kullanın.Bu seçeneği kullanmak, test çalıştırma yapılandırmasında başka hiçbir değişikliğe neden olmaz.Bu seçeneğin amacı test çalıştırma hızını artırmaktır.Ancak, test çalışmasının riskini bütün olarak artırır çünkü test kodu tarafından işlenmemiş özel durum oluşturulursa, test kodu MSTest.exe işleminin çökmesine neden olur.

/testsettings

/testsettings:[file name]

Test ayarları dosyası belirlemek için bu seçeneği kullanın.Örneğin: /testsettings:local.Testsettings

Test ayarları dosyasını /testmetadata seçeneği gibi başka yollarla da belirleyebilirsiniz.Test ayarları dosyasının belirtimini yöneten kurallar burada tanımlanır.

• /testsettings seçeneğini kullanırsanız, /testmetadata seçeneğini de kullanıp kullanmamanızdan bağımsız olarak, belirlenen dosya kullanılır.

• Ekin test ayarlarını belirleyen meta veri dosyasına gelmek için /testmetadata seçeneğini kullanırsanız, o test ayarları dosyası /testsettings seçeneğini kullanmasanız da kullanılır.

• /testsettings seçeneğini kullanmaz ve test meta veri dosyasında test ayarlarını da belirlemezseniz, test çalışması varsayılan test ayarları dosyasını kullanır.

  [!NOT]

  Test ayarı dosyaları hakkında daha fazla bilgi için, bkz. Microsoft Test Yöneticisi'ni Kullanarak Otomatikleştirilmiş Sistem Testleri için Test Ayarları Oluşturma.

/runconfig

/runconfig:[file name]

Not   Bu komut satırı seçeneği, Visual Studio'nun önceki sürümüyle uyumlu olması açısından korunur.Visual Studio Premium'da test ayarları test çalıştırma yapılandırmalarının yerini almıştır.

Çalıştırma yapılandırma dosyasını belirtmek için bu seçeneği kullanın.Örneğin: /runconfig:localtestrun.Testrunconfig

Çalıştırma yapılandırma dosyasını /testmetadata gibi başka yollar kullanarak da belirleyebilirsiniz.Çalıştırma yapılandırma dosyalarının belirtimini yöneten kurallar burada açıklanır.

• /runconfig seçeneğini kullanırsanız, /testmetadata seçeneğini de kullanıp kullanmadığınızdan bağımsız olarak, belirlenen dosya kullanılır.

• Etkin çalışma yapılandırması belirleyen meta veri dosyasına gelmek için /testmetadata seçeneğini kullanırsanız, o çalışma yapılandırması dosyası /runconfig seçeneğini kullanmasanız da kullanılır.

• /runconfig seçeneğini kullanmaz ve test meta veri dosyasında çalışma yapılandırmasını da belirlemezseniz, test çalışması varsayılan çalışma yapılandırması dosyasını kullanır.

/resultsfile

/resultsfile:[file name]

Adlandırılmış dosyanın test çalıştırması sonuçlarını kaydetmek için bu seçeneği kullanın.Örneğin: /resultsfile:testResults.trx.

/usestderr

/usestderr

Bu seçeneği kullanmak, şu bilgilerin standart hataya yazılmasına neden olacaktır:

• Başarısız, İptal edildi, Hata, Zaman aşımına uğradı, Çalıştırılamaz veya Yürütülemedi gibi sonuçları içeren testler.

• Çalıştırma düzeyi hataları.

• Komut satırı değişkenlerini ayrıştırma hataları.

• Test sonucu başarısız sonuçlandığında özeti çalıştırın.

Bu seçenek olmadan, tüm çıktılar standart çıktıya gönderilir.

/detail

/detail:[property id]

Bu seçenek, varsa, ek test çalışması özelliklerini görüntülemek için kullanılır.Birden çok /detail örneğini, her biri bir özellik kimliğine sahip olacak şekilde ve tek bir komut satırında geçirebilirsiniz./detail seçeneği için geçerli özellik kimliği şu şekildedir:

[!NOT]

/detail seçeneğiyle kullandığınız özellik kimliklerinin gerçek seçimi test türüne göre değişir.Bu nedenle, bu yalnızca yaklaşık listedir.Özellikle özel test türleri kullanıyorsanız özellik seçimi farklı olabilir.Hangi propertyID'leri kullanabileceğinizi bilmek için test çalıştırması sonucunda oluşturulan test sonuçları dosyasını inceleyin.Test sonuçları dosyaları hakkında daha fazla bilgi için bkz. Nasıl yapılır: Visual Studio'da Web Performansını Yük Testi Sonuçlarını Kaydetme ve Açma.

Özellik belirtilen test çalışması için varsa, onun bilgisi çıkış sonuç özeti bilgilerine dahildir.

Örneğin, komut satırı:

mstest /testcontainer:Errors.dll /detail:testtype

test türü bilgilerini içeren aşağıdaki çıktıları verir:

... 
Results                    Top Level Tests 
--------                   ----------------- 
Inconclusive               TestProject2.BankAccountTest.CreditTest 
[testtype] = Unit Test 
...

Ayrıca bkz.

Kavramlar

Komut satırından otomatikleştirilmiş testler çalıştırma

Diğer Kaynaklar

Microsoft Test Yöneticisi'nde Test Sonuçlarını Gözden Geçirme