閱讀英文

共用方式為


使用 UTF-8 字串常值 (IDE0230)

財產 價值
規則標識碼 IDE0230
標題 使用UTF-8字串文字
類別 風格
子類別 語言規則(表達層級喜好)
適用的語言 C# 11+
選項 csharp_style_prefer_utf8_string_literals

概述

此規則會標記在使用位元組陣列 (byte[]) 時可以用 UTF-8 字串字面值 取而代之。 使用UTF-8字串常值可讓宣告更加清楚。

選項

選項會指定您希望規則強制執行的行為。 如需設定選項的相關資訊,請參閱 選項格式

csharp_style_prefer_utf8_string_literals

財產 價值 描述
選項名稱 csharp_style_prefer_utf8_string_literals
選項值 true 偏好使用 UTF-8 字串常值,而非位元組陣列。
false 停用規則。
預設選項值 true

C#
// Code with violations.
ReadOnlySpan<byte> _ = new byte[] { 65, 66, 67 };

// Fixed code.
ReadOnlySpan<byte> _ = "ABC"u8;

隱藏警告

如果您想要只隱藏單一違規,請將預處理器指示詞新增至原始程式檔以停用,然後重新啟用規則。

C#
#pragma warning disable IDE0230
// The code that's violating the rule is on this line.
#pragma warning restore IDE0230

若要停用檔案、資料夾或項目的規則,請將其嚴重性設定為 組態檔中的 none

ini
[*.{cs,vb}]
dotnet_diagnostic.IDE0230.severity = none

若要停用所有程式碼樣式規則,請將類別 Style 的嚴重性設定為 組態檔中的 none

ini
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

如需詳細資訊,請參閱 如何在隱藏程式代碼分析警告。

另請參閱