我們在做拼音查詢的時候可能會用到微軟的拼音元件，我用到這個時候想到正好可以使用拓展方法，拓展給string。來和大家一起學習交流。

微軟的拼音元件包裡面有七個工具，我們用的是這個CHSPinYinConv.msi，雙擊安裝，安裝目錄會產生一個dll,我們在工程裡面新增引用就好，拓展方法的定義和使用在註釋裡面。下面看程式碼：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.International.Converters.PinYinConverter;//引入拼音元件空間

namespace pin_yinConvert
{
    public static class ExpansionMethod
    {
        //拓展方法必須在一個非巢狀、非泛型的靜態類中，且一定是靜態方法
        //拓展方法至少要有一個引數
        //拓展方法第一個引數必須加上this關鍵字作為字首
        //拓展方法第一個引數型別也稱為擴充套件型別（extended type），表示該方法對這個型別進行擴充套件
        //拓展方法第一個引數不能用this以外的修飾符（比如out或ref）
        //拓展方法第一個引數不能是指標型別

        /// <summary>
        /// string 的拓展方法，用於獲取字串中漢字的拼音
        /// </summary>
        /// <param name="chinese"></param>
        public static string getAllPinYin(this string chinese)
        {
            var py = "";
            foreach (char c in chinese)
            {
                if (c >= 0x4e00 && c <= 0x9fbb)//UNICODE 中 漢子的範圍是：0x4e00 - 0x9fbb，以此來判斷是否是中文
                {
                    ChineseChar chc = new ChineseChar(c);
                    //Pinyins 返回的是一個只讀陣列，如果是多音字，那麼數組裡面會有多個元素。每一個元素的格式是拼音加1到5的某一個數字，代表聲調，5代表輕音，如：中-- ZHONG1/ZHONG4。
                    py += chc.Pinyins[0].Substring(0, chc.Pinyins[0].Length - 1) + " ";
                }
                else
                {
                    py += c + " ";
                }
            }

            return " '" + chinese + "' 的拼音是： " + py;
            //Console.WriteLine();
        }

        /// <summary>
        /// string 的拓展方法，用於獲取漢字的首字母
        /// </summary>
        /// <param name="chinese"></param>
        /// <returns></returns>
        public static string getFirstPinYin(this string chinese)
        {
            var py = "";
            foreach (char c in chinese)
            {
                if (c >= 0x4e00 && c <= 0x9fbb)
                {
                    ChineseChar chc = new ChineseChar(c);
                    py += chc.Pinyins[0][0];
                }
                else
                {
                    return ""; //存在非漢字字元，直接結束
                }
            }
            return py;
        }
    }

    class Program
    {
        static void Main(string[] args)
        {
            //拓展方法的使用：

            //1、用拓展型別string，直接呼叫拓展方法。
            string chinese = "我是懷夢逆行";       
            Console.WriteLine(chinese.getAllPinYin());
            Console.WriteLine(chinese.getFirstPinYin());

            //2、用拓展方法所在的類（ExpansionMethod），呼叫
            Console.WriteLine(ExpansionMethod.getAllPinYin("我是懷夢逆行"));
            Console.WriteLine(ExpansionMethod.getFirstPinYin("我是懷夢逆行")); 
        }

        //PS：判斷一個方法是拓展方法還是原生方法，vs中，滑鼠懸停在上面會看到拓展方法有（extension） 修飾
    }
}