C#11新特性使用案例詳解

Posted on by

前言

在日常開發中我們經常會將JSON、XML、HTML、SQL、Regex等字符串拷貝粘貼到我們的代碼中，而這些字符串往往包含很多的引號"，我們就必須將所有引號逐個添加轉義符\進行轉義。這個轉義十分麻煩，且容易出錯，而當我們們需要替換這些字符串時，重新粘貼進來的文本仍需要再次進行轉義，簡直讓人崩潰。

在我的工作中經常會遇到這麼一個場景，對於某核心業務的方法，業務執行前一般會進行日志輸出參數對象(Json格式)，這樣可在業務出現故障時追溯到當時的參數值，有利於事後補償或復現bug等。假設故障發生瞭，我從日志中獲取瞭這個參數值的內容如下

{
    "kpzdbs": "YJ2",
    "jqbh": "499098528334",
    "fplxdm": "026",
    "fpqqlsh": "ZJBX965525",
    "kplx": 0,
    "tspz": "00"
}

為復現該問題，在控制臺或單元測試中，將該參數定義，並調用MyLogic方法，

可以看到報錯的字符串是我直接從日志中拷貝的json粘貼進去的，需要對所有的"進行轉義，這是很蛋疼的一個問題，有時候可能需要將很多日志中的對象粘貼進來測試，每次粘貼完還要進行插入轉義符號

現在我們不需要這樣做瞭。

新特性之原始字符串

原始字符串文本是字符串文本的新格式。原始字符串文本可以包含任意文本，包括空格、新行、嵌入引號和其他特殊字符，而無需轉義序列。原始字符串文本以至少三個雙引號開頭， (""") 個字符。它以相同數量的雙引號字符結尾。通常，原始字符串文本在單個行上使用三個雙引號來啟動字符串，另一行的三個雙引號結束字符串。尾引號和尾引號前面的換行符不包括在最終內容中。

詳細內容參考這裡

使用案例

我使用這一新特性修改上面場景中的代碼如下，可以看到，json字符串不做任何轉義直接粘貼進來即可。

又比如我需要粘貼一段html,如果沒有這新特性，轉義那麼多引號，你可能會瘋吧！！

原始字符串使用需要註意的地方

以至少三個雙引號 ("""…""") 開頭和結尾，任何數量小於打開原始字符串文字的數量的雙引號都被視為內容。

尾引號和尾引號前面的換行符不包括在最終內容中。

原始字符串文本通常在單個行上使用三個雙引號來啟動字符串，另一行的三個雙引號結束字符串。

可以和$(可有多個)內插字符串一起使用，前綴$的數量是指示嵌套代碼表達式所需的花括號的數量。如果原始字符串文字以$$為前綴，則將單個大括號視為內容，並且需要兩個大括號來指示嵌套代碼。就像使用引號一樣，您可以添加更多$以允許將更多大括號視為內容。

什麼情況下需要超過三個雙引號開頭

當字符串的內容中包含至少三個"一起出現，你的連續出現"的個數加1(最少三個)，就是原始字符串要開頭和結尾使用"的個數，所以說不是固定三個"註意：圖中字符串前面的|並不是輸入的字符，是編譯器的對齊提示。

輸出

尾引號和尾引號前面的換行符不包括在最終內容中

如下如，編譯器自動以結尾""""前為界限顯示出一條豎線，豎線左側的空格不算作內容。

結尾的三個引號不另起一行行不行

將結尾字符放到內容後面，編譯器會提示你將其放到自己的行上

這個可以理解為，在這種情況下可能會引起歧義，編譯器不確定你的原始字符串是以下三種的哪一種。

如果下面這樣，則不會歧義，以箭頭指向的豎線為界，左側空格都不算做內容，右側空格均算作內容

如果是全在一行也行，因為不會產生歧義。

和內插字符一起使用

這個比較難理解點，$符號的數量也是不固定的，根據你需要連續將多少個花括號作為原始字符你想要輸出的內容沒有括號時，屬於常規用法，沒什麼好說的。

如果你想輸出下文

{張三}

會遇到這個問題的提示

簡單理解就是，你需要將一個大括號視作內容，就需要兩個$作為前綴，你需要將n個括號是做內容，就需要n + 1個$做為前綴，同樣內插字符串也需要消耗跟$同樣數量的大括號。因為你要將一個大括號視為內容，所以需要1 + 1 = 2個$，同樣，內插變量也需要跟$數量一致的括號包裹，所以修改後的代碼如下。

如果你想輸出的內容是

{{{{張三

需要將四個括號視為內容，n = 4,$數量為4 + 1 = 5,內插變量也需要5和括號包裹。

總結

當我們將帶有引號的文本粘貼至編譯器中需要進行大量的轉義操作，原始字符串特性能很好的解決這個問題，讓我們可以愉快進行粘貼這些字符串，但當與內插字符串使用時，尤其是多個大括號場景還是比較難以理解的，好在編譯器會提示怎麼做，且那種場景都屬於極其不常見。

以上就是C#11新特性使用案例詳解內容，更多關於C#11新特性的資料請關註WalkonNet其它相關文章！

推薦閱讀：