快速入門：列出敏感度標籤 （C#）
本快速入門說明如何使用 MIP 檔案 SDK 列出為組織設定的敏感度標籤。
必要條件
如果您尚未完成，請務必先完成下列必要條件，再繼續進行：
- 完成 快速入門：用戶端應用程式初始化 （C#） 會先建置入門 Visual Studio 解決方案。 本「列出敏感度標籤」快速入門仰賴上一個快速入門，以正確建立入門解決方案。
- 選擇性：檢閱 分類標籤 概念。
新增邏輯以列出敏感度標籤
使用檔案引擎物件新增邏輯來列出組織的敏感度標籤。
開啟您在上一篇「快速入門：用戶端應用程式初始化（C#）》一文中建立的 Visual Studio 解決方案。
使用 方案總管 ，在您的專案中開啟包含 方法實作的
Main().cs 檔案。 它預設為與您在專案建立期間指定的專案相同名稱。在本文結尾
Main()處，于函式的應用程式Main()關機區段上方（您在上一個快速入門中離開的位置），插入下列程式碼：
// List sensitivity labels from fileEngine and display name and id
foreach(var label in fileEngine.SensitivityLabels)
{
Console.WriteLine(string.Format("{0} : {1}", label.Name, label.Id));
if (label.Children.Count != 0)
{
foreach (var child in label.Children)
{
Console.WriteLine(string.Format("{0}{1} : {2}", "\t",child.Name, child.Id));
}
}
}
建置及測試應用程式
最後，建置及測試用戶端應用程式。
使用 CTRL-SHIFT-B （ 建置解決方案 ）來建置用戶端應用程式。 如果您沒有建置錯誤，請使用 F5 （ 開始偵錯 ） 來執行應用程式。
如果您的專案建置並成功執行，則每次 SDK 呼叫方法
AcquireToken()時，應用程式 可能會 提示使用 Microsoft 驗證程式庫 （MSAL） 進行驗證。 如果快取的認證已經存在，系統將不會提示您登入，並查看標籤清單。
您可能也需要同意，以允許應用程式在登入帳戶下執行時存取 MIP API。 當 Microsoft Entra 應用程式註冊未預先同意時，就會發生這種情況（如「MIP SDK 設定和設定」中所述），或您以來自不同租使用者的帳戶登入（而不是註冊應用程式所在的帳戶）。 只要按一下 [ 接受 ] 即可記錄您的同意。
驗證之後，主控台輸出應該會顯示敏感度標籤，類似下列範例：
Personal : 73c47c6a-eb00-4a6a-8e19-efaada66dee6
Public : 73254501-3d5b-4426-979a-657881dfcb1e
General : da480625-e536-430a-9a9e-028d16a29c59
Confidential : 569af77e-61ea-4deb-b7e6-79dc73653959
Recipients Only (C) : d98c4267-727b-430e-a2d9-4181ca5265b0
All Employees (C) : 2096f6a2-d2f7-48be-b329-b73aaa526e5d
Anyone (not protected) (C) : 63a945ec-1131-420d-80da-2fedd15d3bc0
Highly Confidential : 905845d6-b548-439c-9ce5-73b2e06be157
Recipients Only : 05ee72d9-1a75-441f-94e2-dca5cacfe012
All Employees : 922b06ef-044b-44a3-a8aa-df12509d1bfe
Anyone (not protected) : c83fc820-961d-40d4-ba12-c63f72a970a3
Press a key to continue.
注意
複製並儲存一或多個敏感度標籤的識別碼， f42a3342-8706-4288-bd31-ebb85995028z 因為您會在下一個快速入門中使用它。
疑難排解
C# 應用程式執行期間的問題
| 摘要 | 錯誤訊息 | 解決方案 |
|---|---|---|
| 不正確的存取權杖 | 發生例外狀況...存取權杖不正確/過期嗎？ 失敗的 API 呼叫：profile_add_engine_async失敗，發生：[類別 mip：:P olicySyncException] 無法取得原則，要求失敗，HTTP 狀態碼為 401，x-ms-diagnostics： [2000001;reason=「與要求一起提交的 OAuth 權杖無法剖析。」;error_category=「invalid_token」]， correlationId：[35bc0023-3727-4eff-8062-00006d672]' C：\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe （process 29924） 以代碼 0 結束。 按任意鍵關閉此視窗 。 . . |
如果您的專案建置成功，但您會看到類似左側的輸出，則方法中 AcquireOAuth2Token() 可能會有無效或過期的權杖。 返回 建置並測試應用程式 ，然後重新產生存取權杖、再次更新 AcquireOAuth2Token() 和重建/重新測試。 您也可以使用 jwt.ms 單頁 Web 應用程式， 檢查並驗證權杖及其宣告。 |
| 未設定敏感度標籤 | n/a | 如果您的專案建置成功，但在主控台視窗中沒有輸出，請確定組織的敏感度標籤已正確設定。 如需詳細資訊，請參閱 「定義標籤分類和保護設定」底下的 MIP SDK 設定和 設定。 |
後續步驟
既然您已瞭解如何列出組織的敏感度標籤，請嘗試下一個快速入門：