執行所選的單元測試

MSTest 範例

using Microsoft.VisualStudio.TestTools.UnitTesting;

namespace MSTestNamespace
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod, Priority(1), TestCategory("CategoryA")]
        public void TestMethod1()
        {
        }

        [TestMethod, Priority(2)]
        public void TestMethod2()
        {
        }
    }
}

Id 過濾需要 MSTest.TestAdapter 3.6 或更新版本。 從 VSTest 發現回傳的 TestCase.Id測試案例中取得 GUID。 此過濾器可選擇一個展開的資料驅動迭代，且不會匹配或逃逸其顯示名稱。 每一列都必須被發現為獨立的測試案例;摺疊式資料驅動測試只會揭露一個父身份。

使用條件運算子 | 和 & 的範例：

• 若要執行其 UnitTest1FullyQualifiedName 中具有 TestCategoryAttribute 的測試， 為 "CategoryA"。

  dotnet test --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"
  

• 若要執行其 中UnitTest1具有 FullyQualifiedName 且 具有 TestCategoryAttribute 的"CategoryA"測試。

  dotnet test --filter "FullyQualifiedName~UnitTest1&TestCategory=CategoryA"
  

• 若要執行包含 FullyQualifiedNameUnitTest1和的TestCategoryAttribute"CategoryA"測試，或具有 PriorityAttribute 的優先順序1為 。

  dotnet test --filter "(FullyQualifiedName~UnitTest1&TestCategory=CategoryA)|Priority=1"
  

xUnit 範例

using Xunit;

namespace XUnitNamespace
{
    public class TestClass1
    {
        [Fact, Trait("Priority", "1"), Trait("Category", "CategoryA")]
        public void Test1()
        {
        }

        [Fact, Trait("Priority", "2")]
        public void Test2()
        {
        }
    }
}

在程式碼範例中，所定義具有索引鍵 "Category" 及 "Priority" 的特徵可用於篩選。

使用條件運算子 | 和 & 的範例：

• 若要執行中TestClass1具有 或具有 索引鍵FullyQualifiedName且 值為的測試。Trait"Category"

  dotnet test --filter "FullyQualifiedName~TestClass1|Category=CategoryA"
  

• 若要執行 中TestClass1具有 且 具有 索引鍵FullyQualifiedName且 值為 的測試。Trait"Category"

  dotnet test --filter "FullyQualifiedName~TestClass1&Category=CategoryA"
  

• 若要執行包含 FullyQualifiedNameTestClass1值為 Trait"Category"具有 "CategoryA" 的索引鍵 Trait 和值。"Priority"

  dotnet test --filter "(FullyQualifiedName~TestClass1&Category=CategoryA)|Priority=1"
  

NUnit 範例

對於 NUnit， 和 TestCategoryCategory 是可互換的濾波器屬性名稱。 兩者都會過濾你用屬性指派 Category 的類別，所以現有的 NUnit --filter Category=MyCategory 指令不需要更改。

using NUnit.Framework;

namespace NUnitNamespace
{
    public class UnitTest1
    {
        [Test, Property("Priority", 1), Category("CategoryA")]
        public void TestMethod1()
        {
        }

        [Test, Property("Priority", 2)]
        public void TestMethod2()
        {
        }
    }
}

使用條件運算子 | 和 & 的範例：

若要執行中UnitTest1具有 FullyQualifiedName 或的 Category"CategoryA"測試。

dotnet test --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"

若要執行其 中UnitTest1具有 FullyQualifiedName 且 具有 Category 的"CategoryA"測試。

dotnet test --filter "FullyQualifiedName~UnitTest1&TestCategory=CategoryA"

若要執行包含 FullyQualifiedNameUnitTest1具有的Category"CategoryA"

dotnet test --filter "(FullyQualifiedName~UnitTest1&TestCategory=CategoryA)|Priority=1"

如需詳細資訊，請參閱 TestCase 篩選。

TUnit 範例

TUnit 不支援 --filter 本文前面提到的選項。 取而代之的是使用MTP --treenode-filter 選項。 樹節點濾波器是形式 /<Assembly>/<Namespace>/<Class>/<Method>為 的路徑，其中：

• * 匹配單一路徑段內的任何值，且可與其他文字結合，例如 *Method*。
• ** 匹配任意數量的路徑段。
• [<Property>=<Value>] 路徑段之後，匹配具有該性質的測試。 [Category("CategoryA")]以性質 ， [Property("Priority", "2")] 以及 作為Category性質 Priority暴露出來。
• | （或）與 & （且）在單一路徑段或屬性過濾器中結合替代方案。 將每個選項以括號包住，例如/*/*/(UnitTest1)|(UnitTest2)/*[(Category=CategoryA)|(Priority=2)]或 。

該 --treenode-filter 選項屬於 MTP 選項，必須 dotnet test 以 MTP 模式執行。 使用 .NET 10 SDK 或更新版本，請在解決方案根目錄的 global.json 檔案中新增以下設定：

{
    "test": {
        "runner": "Microsoft.Testing.Platform"
    }
}

沒有它時， dotnet test 會以 VSTest 模式執行，且在任何測試執行前就失敗 MSB1001: Unknown switch 了。 欲了解更多資訊，包括如何用早期 SDK 執行 MTP 專案，請參閱 dotnet 測試的 MTP 模式。

範例中使用以下測試類別：

namespace TUnitNamespace;

public class UnitTest1
{
    [Test, Property("Priority", "1"), Category("CategoryA")]
    public void TestMethod1()
    {
    }

    [Test, Property("Priority", "2")]
    public void TestMethod2()
    {
    }
}

使用條件運算子 | 和 & 的範例：

要執行類別中 UnitTest1且 為 Category 的 "CategoryA"測試：

dotnet test --treenode-filter "/*/*/UnitTest1/*[Category=CategoryA]"

要執行具有 a Category of "CategoryA"或 a Priority 的 "2"測試：

dotnet test --treenode-filter "/**[(Category=CategoryA)|(Priority=2)]"

要執行類別中UnitTest1且 a Category的Priority"CategoryA""2"測試：

dotnet test --treenode-filter "/*/*/UnitTest1/*[(Category=CategoryA)|(Priority=2)]"

要執行具有 a Category 的 和"CategoryA" a Priority 的"1"測試：

dotnet test --treenode-filter "/**[(Category=CategoryA)&(Priority=1)]"