MSTest.exe Komut Satırı Seçenekleri
MSTest.exe testleri çalıştırmak için kullanılan komut satırı komutudur. Bu komutun, test çalışmanızı özelleştirebileceğiniz birkaç seçeneği vardır. Bu seçeneklerin birçoğunu birbirileriyle birlikte 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. Bu seçenekleri MSTest.exe komut satırında herhangi bir sırada belirleyebilirsiniz.
MSTest.exe belirlediğiniz değerleri veya seçenekleri 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. Benzer bir özeti, komut satırına MSTest /h yazarak görebilirsiniz.
Genel Komut Satırı Seçenekleri
/testcontainer:[dosya adı] |
Test içeren bir dosya yükleme. Örnek: /testcontainer:tests.dll Daha fazla bilgi için, bkz. /testcontainer. |
/testmetadata:[dosya adı] |
Test meta verileri içeren bir dosya yükleme. Daha fazla bilgi için, bkz. /testmetadata. |
/testlist:[test listesi yolu] |
Test listesini belirlenen meta verilerindeki gibi çalışması için belirleyin. Daha fazla bilgi için bkz. /testlist. |
/category:[test kategori süzgeci] |
Hangi test kategorilerin çalışacağını belirleyin ve filtreleyin. Daha fazla bilgi için, bkz. /category . |
/test:[test adı] |
Çalıştırılacak bir test adını belirtin. Daha fazla bilgi için, bkz. /test. |
/noisolation |
Testleri MSTest.exe işlemiyle çalıştırın. Bu seçim, test çalışması hızını artırır, ancak MSTest.exe işlemi riski artar. |
/testsettings: [dosya adı] |
Belirtilen test ayarları dosyasını kullanın. Örnek: /testsettings:Local.Testsettings Daha fazla bilgi için bkz. /testsettings (test ayarları). |
/runconfig:[dosya adı] |
Belirtilen çalışma yapılandırması dosyasını kullanın. Örnek: /runconfig:localtestrun.Testrunconfig Daha fazla bilgi için, bkz. /runconfig. .gif "Not") Not
Bu komut satırı seçeneği, Microsoft Visual Studio 2010'un önceki sürümleriyle uyumluluğu için korunur.Test çalışması yapılandırmaları Visual Studio 2010 Ultimate içindeki test ayarları tarafından yer değiştirilir.
|
/resultsfile:[dosya adı] |
Test çalışması sonuçlarını belirtilen dosyaya kaydedin. Örnek: /resultsfile:testResults.trx Daha fazla bilgi için, bkz. /resultsfile. |
/unique |
Yalnızca, tüm belirliten /test için benzersiz bir eşleşme bulunursa testi çalıştırın. Daha fazla bilgi için bkz. /unique. |
/detail:[özellik kimliği] |
Test çıkışına ek olarak, varsa, değerlerini göstermek istediğiniz özelliğin adını belirtin. Daha fazla bilgi için, bkz. /detail. |
/help |
MSTest.exe kullanım iletisini görüntüleyin (kısa form: /? veya /h). |
/nologo |
Hiç başlangıç başlığı ve telif hakkı iletisi gösterme. |
/usestderr |
Hata bilgisinin çıktısını almak için standart hata kullanın. |
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ınlamak için Komut Satırı Seçenekleri.
/publish:[sunucu adı] |
Belirlenen sunucunun takım projesi kolleksiyonu için sonuçları veritabanına yayımlayın. |
/publishresultsfile:[dosya adı] |
Yayımlanacak sonuç dosyası adlarını belirtin. Hiç sonuç dosya adı belirtilmemişse, geçerli çalışma tarafından üretilen dosyayı kullanın. |
/publishbuild:[yapı kimliği] |
Test sonuçlarını bu yapı kimliğini kullanarak yayımlayın. |
/teamproject:[takım projesi adı] |
Yapının ait olduğu takımın proje adını belirtin. |
/platform:[platform] |
Hangi test sonuçlarının yayımlandığına karşılık yapı platformunu belirleyin. |
/flavor:[tercih] |
Hangi test sonuçlarının yayımlandığına karşılık yapı tercihini belirleyin. |
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ımlamada kullanılan seçenekler buraya dahil değil. Bu seçenekler hakkında daha fazla bilgi için, bkz. Test Sonuçlarını Yayınlamak için Komut Satırı Seçenekleri.
/testcontainer (test kapsayıcı)
/testcontainer:[dosya adı]
Test kapsayıcı, çalıştırmak istediğiniz testleri içeren dosyalardı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 (test meta verisi)
/testmetadata:[dosya adı]
Testleri çoklu test kapsayıcılarında çalıştırmak için /testmetadata seçeneğini kullanabilirsiniz.
Test meta veri dosyası, Test Listesi Düzenleyicisini kullanarak test listesi oluşturduğunuzda, çözümünüz için oluşturulur. Bu dosya, Test Listesi Düzenleyicisinde listelenen tüm testler hakkında bilgi içerir. Bunlar, çözümünüzdeki tüm test projelerinde varolan tüm testlerdir.
Test meta verilerler dosyası, çözüm klasöründe oluşturulan bir XML dosyasıdır. Bu dosya, Çözüm Gezgininde Çözüm Öğeleri düğümünün altında görünür. Bir test meta verisinin dosya uzantısı .vsmdi'dir ve Test Listesi Düzenleyicisi penceresiyle ile ilişkilidir. Yani, Windows Gezgini'nde .vsmdi dosyasını çift tıklatırsanız, dosya Visual Studio ve onun içeriğini açar. Çözümlerin test projelerindeki tüm testler Test Listesi Düzenleyicisinde görüntülenir.
Test meta veri dosyasını sadece testleri oluşturma ve silme veya testlerin özelliklerini değiştirme gibi Test Listesi Düzenleyicisi penceresine yansıtılan değişikliklerle 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 kullandığınızda, /test seçeneğini veya /testlist seçeneği veya her ikisini de kullanarak, çalışması için belirli testleri seçmeniz önerilir.
/testlist (test listesi)
/testlist:[test listesi yolu]
/testlist seçeneği, test meta veri dosyasında belirtildiği gibi çalışmak üzere testlerin listesidir. Birden çok test listelerinde bulunan testleri çalıştırmak için, birden çok kez /testlist seçeneğini kullanın. Test listesindeki düzenli herhangi bir test yürütülecektir.
Not
/testlist seçeneğini sadece /testmetadata seçeneğini de kullanırsanız kullanabilirsiniz.
/testlist seçeneğini ve /test seçeneğini birlikte kullanabilirsiniz. Bu, bir test listesi ve bir veya daha çok bireysel testleri Test Listesi Düzenleyicisi penceresinde seçmek ve sonra Testleri Çalıştır' tıklatmakla eşdeğerdir.
/category
/category:[test kategori süzgeci]
Hangi test kategorisinin çalışacağını belirlemek için /category seçeneğini seçin.
Not
/testcontainer seçeneğini kullanmak için, /category seçeneğini de kullanmalısınız.
/category seçeneğini, komut satırı başına bir kez kullanabilirsiniz fakat test kategori filtresiyle birden çok test kategorisi belirleyebilirsiniz. Test kategori filtresi, mantıksal işleçlerle '&', '|', '!', '&!' ayrılmış bir veya daha fazla test kategorisinden oluşabilir. Mantıksal işleçler & 've' | ' test kategori filtresi oluşturmak için birlikte kullanılamaz.
Örneğin:
/category:group1 testleri, test kategorisi "grup1"'de çalıştırır.
/category:"group1&group2" "grup1" ve "grup2" test kategorilerindeki testleri çalıştırır. Yalnızca belirtilen test kategorilerinden birinde olan testler çalışmaz.
/category:"group1|group2" "grup1" veya "grup2" test kategorisinde olan testleri çalıştırır. Her iki test kategorilerinde olan testler de çalıştırırlır.
/category:"group1&!group2" "grup1"de olup "grup2"de olmayan test kategorilerindeki testleri çalıştırır. Her iki test kategorisinde olan test çalıştırılmaz.
Not
Filtreniz, /category:group1 gibi tek bir kategoriden oluşuyorsa, filtreyi tırnak işaretleriyle ayırmanız gerekmez. Fakat, 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 adı]
Bireysel testleri çalıştırmak için /test seçeneğini kullanın. Birden çok testleri ç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, fakat ikisiyle birlikte kullanamazsınız.
/testlist seçeneğini ve /test seçeneğini birlikte kullanabilirsiniz. Bu, bir test listesi ve bir veya daha çok bireysel testleri Test Listesi Düzenleyicisi penceresinde seçmek ve sonra Testleri Çalıştır' tıklatmakla eşdeğerdir.
/test seçeneğiyle belirlediğiniz dize, test kapsayıcısındaki 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 testleri belirtebilirsiniz anlamına gelir. Örneğin, /test:ittest'i belirlemek, testlerin DebitTest ve CreditTest adlı testlerle eşleşmelerini üretir, çünkü her iki test adı da 'ittest' alt dizesini içerir.
Not
/test seçeneğiyle belirlediğiniz değer, Çözüm Gezgininde görldüğü gibi, veya birim testlerinde onların tümüyle yetkili isimleri için, sadece 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 projesindeki UnitTest1.cs dosyası TestMethod1 adında bir birim testi içerir. /test seçeneği için 'ittest' değerini belirlemek de bu testle eşleşir çünkü dize, tümüyle yetkili "TestProject2.UnitTest1.TestMethod1" adıyla eşleşebilir 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 (yalıtım yok)
/noisolation
Bu seçeneği, testleri MSTest.exe işlemiyle çalıştırmak için kullanın. Bu seçeneği kullanmak, test çalışması yapılandırmasında başka hiç değişikliğe neden olmaz. Bu seçeneğin amacı test çalışması 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 (test ayarları)
/testsettings:[dosya adı]
Bu seçeneği, test ayarları dosyası belirlemek için kullanın. Örneğin: /testsettings:local.Testsettings
Test ayarları dosyasını /testmetadata seçeneği gibi başka yollarla da belirleyebilirsiniz. Test ayarları belirtimi belirleyen kurallar burada açıklanır.
/testsettings seçeneğini kullanırsanız, /testmetadata seçeneğini de kullansanız da 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. Test Planının Bir Parçası Olarak Otomatikleştirilmiş Testler için Test Ayarları Oluşturma.
/runconfig
/runconfig:[dosya adı]
Not Bu komut satırı seçeneği, Microsoft Visual Studio 2010'un önceki sürümleriyle uyumluluğu için korunur. Test çalışması yapılandırmaları Visual Studio 2010 Ultimate içindeki test ayarları tarafından yer değiştirilir.
Bu seçeneği çalışma yapılandırma dosyasını belirtmek için kullanın. Örneğin: /runconfig:localtestrun.Testrunconfig
Çalışma yapılandırma dosyasını /testmetaveri seçeneği gibi başka yollar kullanarak da belirleyebilirsiniz. Çalışma yapılandırması belirtimi belirleyen kurallar burada açıklanır.
/runconfig seçeneğini kullanırsanız, /testmetadata seçeneğini de kullansanız da 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:[dosya adı]
Bu seçeneği adlandırılmış dosya için test çalışması sonuçlarını kaydetmek için kullanın. Örneğin: /resultsfile:testResults.trx.
/unique (/benzersiz)
/unique
/unique seçeneğini /test seçeneğiyle birlikte kullanın. /unique seçeneği MSTest.exe'ye yalnızca, /test seçeneği ile sağladığınız değere bir benzersiz eşleşme varsa bir test çalıştırması talimatını verir.
Örneğin, test kapsayıcısı MyTestProject MethodTest1 ve MethodTest10 adlı testleri içerir.
Komut satırı:
mstest /testcontainer:testproject2.dll /test:MethodTest1
MethodTest1 ve MethodTest10 de çalışır, çünkü MethodTest1 'MethodTest10'un alt dizesidir.
Ancak komut satırı:
mstest /testcontainer:testproject2.dll /test:MethodTest1 /unique
Bu test adı için benzersiz bir eşleşme olmadığı hatasını verir. Testi adını, test için Özellikler görünümünde listelenen test kimliğini kullanarak benzersiz olarak tanımlayabilirsiniz.
/usestderr
/usestderr
Bu seçeneği kullanmak aşağıdaki bilginin 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 sonuçlarını içeren testler.
Çalıştırma düzeyi hataları.
Komut satırı değişkenlerini ayrıştırma hataları.
Test çalıştırması 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 (ayrıntı)
/detail:[özellik kimliği]
Bu seçenek, varsa, ek test çalışması özelliklerini görüntülemek için kullanılır. /detail seçeneğinin bir veya daha fazla, her biri tek özellik kimlikli, tek komut satırında olan örneğini geçebilirsiniz. /detail seçeneği için geçerli özellik kimliği için izleyin:
bağdaştırıcı |
kimlik |
projectrelativepath (proje ilişkili yol) |
computername |
isautomated |
readonly |
debugtrace |
link |
spoolmessage |
description |
longtext |
stderr |
displaytext (görüntü metni) |
name |
stdout |
süre |
outcometext |
depolama |
errorMessage |
owner |
testcategoryid |
errorstacktrace |
parentexecid |
testname |
executionid |
priority |
testtype |
groups |
projectname |
traceinfo |
Not
/detail (ayrıntı) seçeneğiyle kullanacağınız özellik kimliğinin gerçek seçeneği 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 özellikler farklı olacaktır. Hangi özellik kimliğini kullanabileceğinizi bilmek için, test çalışması tarafından üretilen 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 Test 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ıyı üretir:
...
Results Top Level Tests
-------- -----------------
Inconclusive TestProject2.BankAccountTest.CreditTest
[testtype] = Unit Test
...