用 C# 堆砌程式：API 範例集

Enumerable

ArrayList 和 Hashtable

在 C# 還不支援泛型時，.NET Framework 最主要的資料結構類別是 System.Collections 的 ArrayList 和 Hashtable。

最常用的就這兩個，其它還會用到的大概就 Queue 和 Stack 吧？

後來引進 LINQ 時，這些類別並未實作其功能，只在新的 System.Collections.Generic 類別實作，因此漸漸用 List 和 Dictionary 取而代之，ArrayList 和 Hashtable 有種走入歷史的感覺～

寫 C# 程式很難抗拒 LINQ 蜜糖般的誘惑，空有 ArrayList 和 Hashtable 資料結構，沒有 LINQ 接手各式演算法，就不像在寫 C# 程式了。

List

串列資料結構，適合讀取資料。

Capacity
Count
Add()
AddRange()
AsReadOnly()
BinarySearch()
Clear()
Contains()
ConvertAll()
CopyTo()
Exists()
Find()
FindAll()
FindIndex()
FindLast()
FindLastIndex()
ForEach()
GetEnumerator()
GetRange()
IndexOf()
Insert()
InsertRange()
IsFixedSize()
IsReadOnly()
IsSynchronized()
LastIndexOf()
Remove()
RemoveAll()
RemoveAt()
RemoveRange()
Reverse()
Sort()
SyncRoot()
ToArray()
TrimExcess()
TrueForAll()

LinkedList

雙向鏈結串列資料結構，適合寫入資料。

Count
First
Last
AddAfter()
AddBefore()
AddFirst()
AddLast()
Clear()
Contains()
CopyTo()
Find()
FindLast()
GetEnumerator()
GetObjectData()
OnDeserialization()
Remove()
RemoveFirst()
RemoveLast()

SortedSet

資料不重複的有序集合。

Comparer
Count
Max
Min
Add()
Clear()
Contains()
CopyTo()
CreateSetComparer()
ExceptWith()
GetEnumerator()
GetObjectData()
GetViewBetween()
IntersectWith()
IsProperSubsetOf()
IsProperSupersetOf()
IsSubsetOf()
IsSupersetOf()
OnDeserialization()
Overlaps()
Remove()
RemoveWhere()
Reverse()
SetEquals()
SymmetricExceptWith()
TryGetValue()
UnionWith()

HashSet

資料不重複的無序集合。

Comparer
Count
Add()
Clear()
Contains()
CopyTo()
CreateSetComparer()
EnsureCapacity()
ExceptWith()
GetEnumerator()
GetObjectData()
IntersectWith()
IsProperSubsetOf()
IsProperSupersetOf()
IsSubsetOf()
IsSupersetOf()
OnDeserialization()
Overlaps()
Remove()
RemoveWhere()
SetEquals()
SymmetricExceptWith()
TrimExcess()
TryGetValue()
UnionWith()

Queue

佇列，先進先出資料結構。

Count
Clear()
Contains()
CopyTo()
Dequeue()
Enqueue()
GetEnumerator()
Peek()
IsSynchronized()
SyncRoot()
ToArray()
TrimExcess()
TryDequeue()
TryPeek()

Stack

堆疊，後進先出資料結構。

Count
Clear()
Contains()
CopyTo()
GetEnumerator()
IsSynchronized()
Peek()
Pop()
Push()
SyncRoot()
ToArray()
TrimExcess()
TryPeek()
TryPop()

Dictionary

無序鍵值對資料結構。

Comparer
Count
Keys
Values
Add()
Clear()
ContainsKey()
Contains()
ContainsValue()
CopyTo()
EnsureCapacity()
GetEnumerator()
GetObjectData()
IsFixedSize()
IsReadOnly()
IsSynchronized()
OnDeserialization()
Remove()
SyncRoot()
TrimExcess()
TryAdd()
TryGetValue()

SortedDictionary

無索引值的有序鍵值對資料結構。

Comparer
Count
Item[]
Keys
Values
Add()
Clear()
ContainsKey()
ContainsValue()
CopyTo()
GetEnumerator()
Remove()
TryGetValue()

SortedList

有索引值的有序鍵值對資料結構。

Capacity
Comparer
Count
Item[]
Keys
Values
Add()
Clear()
ContainsKey()
ContainsValue()
GetEnumerator()
IndexOfKey()
IndexOfValue()
Remove()
RemoveAt()
TrimExcess()
TryGetValue()

IEnumerable

IEnumerable.GetEnumerator()

IEnumerator

IEnumerator.Current
IEnumerator.Dispose()
IEnumerator.MoveNext()
IEnumerator.Reset()

語法糖

new List<型態>() {資料, 資料, ...};
new Dictionary<型態, 型態>() {{鍵, 值}, {鍵, 值}, ...};

做法一：用 LINQ 的 OrderBy()

using System; using System.Collections.Generic; using System.Linq; class Program { static void Main() { Random random = new Random(); // 陣列 int[] array = {111, 222, 333, 444, 555, 666, 777, 888, 999}; Console.WriteLine(array.OrderBy(random.Next).ToArray()[0]); // 集合 List<int> list = new List<int>(array); Console.Write(list.OrderBy(random.Next).ToList()[0]); } }

999
333
（每次執行結果不一樣）

做法二：為 IList 介面擴充 Shuffle()

using System; using System.Collections.Generic; static class Extensions { static Random random = new Random(); public static void Shuffle<T>(this IList<T> x) { for (int n=0; n<x.Count; n++) { int a = random.Next(n); T b = x[a]; x[a] = x[n]; x[n] = b; } } } class Program { static void Main() { // 陣列 string[] array = {"A", "B", "C", "D", "E"}; array.Shuffle(); foreach (string n in array) { Console.Write(n); } // 集合 List<string> list = new List<string>(array); list.Shuffle(); list.ForEach(Console.Write); } }

DCAEBEDBAC（每次執行結果不一樣）

做法三：打亂集合的 Sort()

using System; using System.Collections.Generic; class Program { static void Main() { List<string> list = new List<string>(); list.AddRange(new[]{"A", "B", "C", "D", "E"}); Random random = new Random(); list.Sort((x, y) => random.Next(-1, 2)); list.ForEach(Console.Write); } }

ECADB（每次執行結果不一樣）

問題

如果建立 Random 類別時，沒有在建構式設定 seed 值，那麼 .NET 會傳入電腦時間做為 seed 值來產生亂數表。

換句話說，在相同時間建立的 Random 物件，其亂數表是一樣的！如果你在同一時間內多次建立 Random 物件來呼叫 Next()，會發現得到的數值是重複的、固定的，而不是打亂的、變動的：

Random r1 = new Random();　　假設獲得亂數表：3 → 5 → 1 → 4 → 2 ⋯
Random r2 = new Random();　　假設獲得亂數表：3 → 5 → 1 → 4 → 2 ⋯
Random r3 = new Random();　　假設獲得亂數表：3 → 5 → 1 → 4 → 2 ⋯

r1.Next();　　　　　　　　　 傳回 r1 亂數表第一個數字：3
r2.Next();　　　　　　　　　 傳回 r2 亂數表第一個數字：3
r3.Next();　　　　　　　　　 傳回 r3 亂數表第一個數字：3

看似呼叫三次 Next()，其實是對一模一樣的三張亂數表，各取出第一個數字，結果通通都是 3。

由於電腦每秒可以執行百萬指令，所以區區數行 new Random()，幾乎用的都是同一時間值做 seed😐

建議

由於 Random 並沒有打亂 seed 的方法，只能在建構式 Random(Int32) 設定 seed，所以建議的用法，是早早就建立一個 Random 物件來重複使用，讓 Next() 照同一張亂數表的順序走：

Random r = new Random();　　 假設獲得亂數表：3 → 5 → 1 → 4 → 2 ⋯

r.Next();　　　　　　　　　　傳回亂數表第一個數字：3
r.Next();　　　　　　　　　　傳回亂數表第二個數字：5
r.Next();　　　　　　　　　　傳回亂數表第三個數字：1

還要注意的是，new Random() 不要放在迴圈內，也不要放在函式內。迴圈等於短時間內大量產生同樣亂數表的 Random 物件，函式經常會在短時間被重複呼叫，這樣一來裡面的 Random 其實也是用同樣時間值產生亂數表。這些都不叫建立一個 Random 物件來重複使用，等於 new 一堆 Random 物件來使用。宣告為類別的屬性來重複使用也有這樣陷阱，短時間內 new 一堆這個類別的話，就跟宣告在函式裡面的意思一樣～

如果真的要建立多個 Random 物件，可以在每個物件之間呼叫 System.Threading 的 Thread.Sleep(1)，這樣時間就會錯開，變相用不一樣的時間值產生亂數表。

其他

雖然照建議的用法操作 Random 物件能正常獲得亂數，但它依然不是真正的亂數，順序依然是固定的、有規則可循的。

使用 File 簡易讀寫

using System; using System.IO; class Program { static void Main() { // 寫入資料 File.WriteAllText("sample.txt", "A"); File.AppendAllText("sample.txt", "BC"); // 讀出資料 string[] lines = File.ReadAllLines("sample.txt"); foreach (string n in lines) { Console.WriteLine(n); } } }

ABC

ABC

如果資料是 String 陣列或 List 串列，可以用 WriteAllLines 一次寫入新的檔案，用 AppendAllLines 一次附加資料到檔案，且每筆資料附加換行字元。

使用 StreamWriter 和 StreamReader 分批讀寫

using System; using System.IO; class Program { static void Main() { // 寫入資料 StreamWriter writer = new StreamWriter("sample.txt"); writer.WriteLine("AAA"); writer.WriteLine("BBB"); writer.WriteLine("CCC"); writer.Close(); // 讀出資料 StreamReader reader = new StreamReader("sample.txt"); while (!reader.EndOfStream) { Console.WriteLine(reader.ReadLine()); } reader.Close(); } }

AAA
BBB
CCC

AAA
BBB
CCC

使用 FileStream 隨機存取

using System; using System.IO; using System.Text; class Program { static void Main() { // 寫入資料 FileStream file_stream1 = File.Create("sample.txt"); file_stream1.Seek(0, SeekOrigin.Begin); file_stream1.Write(Encoding.UTF8.GetBytes("猜猜\n"), 0, 7); // 中文字佔 3 bytes 大小，其他字元 1 byte，所以填 7，也就是 3+3+1。 file_stream1.Seek(7, SeekOrigin.Begin); file_stream1.Write(Encoding.UTF8.GetBytes("我是誰"), 0, 9); file_stream1.Close(); // 從位置 10 讀出 6 bytes 資料 FileStream file_stream2 = new FileStream("sample.txt", FileMode.Open); file_stream2.Seek(10, SeekOrigin.Begin); byte[] bytes = new byte[6]; file_stream2.Read(bytes, 0, 6); Console.Write(Encoding.UTF8.GetChars(bytes)); file_stream2.Close(); } }

猜猜
我是誰

是誰

使用 BinaryWriter 和 BinaryReader 讀寫數值資料

using System; using System.IO; class Program { static void Main() { // 寫入資料 BinaryWriter writer = new BinaryWriter(File.Open("Sample.dat", FileMode.Create)); writer.Write(1); writer.Write(22); writer.Write(333); writer.Close(); // 讀出資料 BinaryReader reader = new BinaryReader(File.Open("Sample.dat", FileMode.Open)); int a = reader.ReadInt32(); int b = reader.ReadInt32(); int c = reader.ReadInt32(); reader.Close(); Console.Write(a + b + c); } }

356

新建 XML 文件

using System.Xml; class Program { static void Main() { // 建立新 XML 結構 XmlDocument document = new XmlDocument(); document.LoadXml("<?xml version='1.0' encoding='UTF-8'?><html></html>"); // 新增元素 XmlElement element = document.CreateElement("body"); element.SetAttribute("style", "color:blue"); document.DocumentElement.AppendChild(element); // 新增節點 XmlNode node = document.CreateNode(XmlNodeType.Element, "p", ""); // Attribute CDATA Comment Document DocumentFragment DocumentType Element EndElement EndEntity Entity EntityReference None Notation ProcessingInstruction SignificantWhitespace Text Whitespace XmlDeclaration node.InnerText = "Hello"; XmlAttribute attribute = document.CreateAttribute("style"); attribute.Value = "color:red"; node.Attributes.SetNamedItem(attribute); element.AppendChild(node); // 儲存 document.Save("save.xml"); } }

<?xml version="1.0" encoding="UTF-8"?>
<html>
  <body style="color:blue">
    <p style="color:red">Hello</p>
  </body>
</html>

讀取 XML 文件

XML 檔 (data1.xml)

<?xml version='1.0'?> <?xml-stylesheet type="text/xsl" href="union.xsl"?> <root> <x>green</x> <y> <x>blue</x> <x>blue</x> </y> <z> <x>red</x> <x>red</x> </z> <x>green</x> </root>

XSLT 檔 (union.xsl)

<?xml version='1.0'?> <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> <xsl:template match="root"> <xsl:for-each select="x | y/x"> <xsl:value-of select="."/>, <xsl:if test="not(position()=last())">, </xsl:if> </xsl:for-each> </xsl:template> </xsl:stylesheet>

Formatted Output

green, blue, blue, green

Processor Output

<?xml version="1.0" encoding="UTF-16"?>green, blue, blue, green

Microsoft.Data.Sqlite

.NET Framework 並未內建 SQLite 功能😤

請至 NuGet Gallery 下載 Microsoft.Data.Sqlite，再到 SQLite 官網下載 Precompiled Binaries for Windows 的 64-bit DLL (x64) for SQLite（不要下載到 32-bit），解開後將 sqlite3.dll 與 Microsoft.Data.Sqlite.dll 放在一起。

範例程式如下：

using System; using System.IO; using Microsoft.Data.Sqlite; class Program { static void Main() { // 砍掉重練一個新的 sqlite.db 空白資料庫，好讓範例每次都能正常執行。 File.WriteAllBytes("sqlite.db", new byte[0]); // 指定資料庫檔案並開啟 SqliteConnection sqlite = new SqliteConnection("DataSource=sqlite.db"); sqlite.Open(); // 寫入資料 SqliteCommand sql = sqlite.CreateCommand(); sql.CommandText = "CREATE TABLE MyTable(MyColumn TEXT)"; sql.ExecuteNonQuery(); sql.CommandText = "INSERT INTO MyTable(MyColumn) VALUES('Hello, SQLite!')"; sql.ExecuteNonQuery(); // 讀取資料 sql.CommandText = "SELECT MyColumn FROM MyTable"; SqliteDataReader reader = sql.ExecuteReader(); reader.Read(); Console.Write(reader["MyColumn"].ToString()); // 關閉資料庫 sqlite.Dispose(); } }

csc /r:Microsoft.Data.Sqlite.dll *.cs

Hello, SQLite!

System.Data.SQLite

另外還有 System.Data.SQLite，它不需要另外下載 sqlite3.dll，而是內建在 System.Data.SQLite.dll 裡面！請下載 Precompiled Binaries for 64-bit Windows (.NET Framework 4.6) 的 sqlite-netFx46-binary-bundle-x64-2015-1.0.115.5.zip，解開後的 System.Data.SQLite.dll 就等於一款資料庫系統。

由於 .NET Framework 版的 Microsoft.Data.Sqlite 和 System.Data.SQLite 都已停止更新，因此不內建 SQLite 3 的 Microsoft.Data.Sqlite 會是更好的選擇，可以替換新版本的 sqlite3.dll，System.Data.SQLite 內建的 SQLite 版本停留在 2015 年。

System.Data.SQLite 和 Microsoft.Data.Sqlite 是同樣原始碼的產品，所以兩者程式寫法一樣，只差在大小寫，一個是 Sqlite，一個是 SQLite：

using System; using System.IO; using System.Data.SQLite; class Program { static void Main() { // 砍掉重練一個新的 sqlite.db 空白資料庫，好讓範例每次都能正常執行。 SQLiteConnection.CreateFile("sqlite.db"); // 指定資料庫檔案並開啟 SQLiteConnection sqlite = new SQLiteConnection("DataSource=sqlite.db"); sqlite.Open(); // 寫入資料 SQLiteCommand sql = sqlite.CreateCommand(); sql.CommandText = "CREATE TABLE MyTable(MyColumn TEXT)"; sql.ExecuteNonQuery(); sql.CommandText = "INSERT INTO MyTable(MyColumn) VALUES('Hello, SQLite!')"; sql.ExecuteNonQuery(); // 讀取資料 sql.CommandText = "SELECT MyColumn FROM MyTable"; SQLiteDataReader reader = sql.ExecuteReader(); reader.Read(); Console.Write(reader["MyColumn"].ToString()); // 關閉資料庫 sqlite.Dispose(); } }

csc /r:System.Data.SQLite.dll *.cs

Hello, SQLite!

序列化為二進制檔案

using System; using System.IO; using System.Runtime.Serialization.Formatters.Binary; [Serializable] class Player { string name; int number; public Player(string x, int y) { name = x; number = y; } public void play() { Console.Write("{0} {1}", name, number); } } class Program { static void Main() { Player player1 = new Player("Twideem Civs", 58); // 序列化 FileStream stream = new FileStream("player.dat", FileMode.Create, FileAccess.Write, FileShare.None); BinaryFormatter formatter = new BinaryFormatter(); formatter.Serialize(stream, player1); stream.Close(); // 反序列化 stream = File.OpenRead("player.dat"); Player player2 = (Player)formatter.Deserialize(stream); stream.Close(); player2.play(); } }

00 01 00 00 00 FF FF FF FF 01 00 00 00 00 00 00 00 0C 02 00 00 00 3A 72 75 6E 2C 20 56 65 72 73 69 6F 6E 3D 30 2E 30 2E 30 2E 30 2C 20 43 75 6C 74 75 72 65 3D 6E 65 75 74 72 61 6C 2C 20 50 75 62 6C 69 63 4B 65 79 54 6F 6B 65 6E 3D 6E 75 6C 6C 05 01 00 00 00 06 50 6C 61 79 65 72 02 00 00 00 04 6E 61 6D 65 06 6E 75 6D 62 65 72 01 00 08 02 00 00 00 06 03 00 00 00 0C 54 77 69 64 65 65 6D 20 43 69 76 73 3A 00 00 00 0B

Twideem Civs
58

序列化為 SOAP 格式

using System; using System.IO; using System.Runtime.Serialization.Formatters.Soap; [Serializable] class Player { string name; int number; public Player(string x, int y) { name = x; number = y; } public void play() { Console.Write("{0} {1}", name, number); } } class Program { static void Main() { Player player1 = new Player("Twideem Civs", 58); // 序列化 FileStream stream = new FileStream("player.xml", FileMode.Create, FileAccess.Write, FileShare.None); SoapFormatter formatter = new SoapFormatter(); formatter.Serialize(stream, player1); stream.Close(); // 反序列化 stream = File.OpenRead("player.xml"); Player player2 = (Player)formatter.Deserialize(stream); stream.Close(); player2.play(); } }

<SOAP-ENV:Envelope
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
 xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
 xmlns:clr="http://schemas.microsoft.com/soap/encoding/clr/1.0"
 SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<a1:Player id="ref-1" xmlns:a1="http://schemas.microsoft.com/clr/asse
m/run%2C%20Version%3D0.0.0.0%2C%20Culture%3Dneutral%2C%20PublicKeyTok
en%3Dnull">
<name id="ref-3">Twideem Civs</name>
<number>58</number>
</a1:Player>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Twideem Civs
58

序列化為 XML 格式

using System; using System.Xml; using System.Xml.Serialization; using System.IO; public class Player { public string name; public int number; } class Program { static void Main() { Player player1 = new Player(); player1.name = "Twideem Civs"; player1.number = 58; // 序列化 FileStream stream = new FileStream("player.xml", FileMode.Create, FileAccess.Write, FileShare.None); XmlSerializer serializer = new XmlSerializer(typeof(Player)); serializer.Serialize(stream, player1); stream.Close(); // 反序列化 stream = File.OpenRead("player.xml"); Player player2 = (Player)serializer.Deserialize(stream); stream.Close(); Console.WriteLine(player2.name); Console.Write(player2.number); } }

<?xml version="1.0"?>
<Player xmlns:xsd="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <name>Twideem Civs</name>
  <number>58</number>
</Player>

Twideem Civs
58

序列化為 JSON 字串

using System; using System.Web.Script.Serialization; class Player { public string name; public int number; } class Program { static void Main() { Player player1 = new Player(); player1.name = "Twideem Civs"; player1.number = 58; JavaScriptSerializer serializer = new JavaScriptSerializer(); // 物件轉 JSON string json = serializer.Serialize(player1); Console.WriteLine(json); // JSON 轉物件 Player player2 = serializer.Deserialize<Player>(json); Console.WriteLine(player2.name); Console.Write(player2.number); } }

{"name":"Twideem Civs", "number":58}
Twideem Civs
58

SoundPlayer

.NET Framework 只能播放 WAVE 格式😨

using System.Media; class Program { static void Main() { SoundPlayer player = new SoundPlayer(); player.SoundLocation = "sound.wav"; player.Load(); player.PlaySync(); } }

NAudio

想播放 MP3 格式，請至 NuGet Gallery 下載 NAudio 1.10.0 組件，它能將 MP3 轉為 WAVE 格式給 SoundPlayer 播放⋯不過 NAudio 本身就能播放 WAVE 了。

下載後，直接用壓縮軟體解開，然後將 net35 資料夾裡面的 NAudio.dll 跟你的 C# 程式碼放在一起。

using NAudio.Wave; using System.Threading; class Program { static void Main() { // 將 MP3 轉為 WAVE Mp3FileReader mp3 = new Mp3FileReader("music.mp3"); WaveStream wave = WaveFormatConversionStream.CreatePcmStream(mp3); // 播放 WAVE WaveOut waveout = new WaveOut(); waveout.Init(wave); waveout.Play(); while (waveout.PlaybackState==PlaybackState.Playing) { Thread.Sleep(100); } // 釋放占用資源 wave.Dispose(); mp3.Dispose(); } }

csc /r:NAudio.dll *.cs

範例一：Process.Start()

using System.Diagnostics; class Program { static void Main() { // 調用 7-Zip 壓縮檔案 Process.Start("C:/Program Files/7-Zip/7z.exe", "a 我的壓縮檔.7z 我的資料夾"); // 調用 7-Zip 解壓檔案 Process.Start("C:/Program Files/7-Zip/7z.exe", "x 我的壓縮檔.7z"); } }
如果有預設網頁瀏覽器，還可以下網址，用來開啟網站。

範例二：Process.WaitForExit()

using System.Diagnostics; class Program { static void Main() { // 等檔案壓縮完後 Process process = Process.Start("C:/Program Files/7-Zip/7z.exe", "a 我的壓縮檔.7z 我的資料夾"); process.WaitForExit(); // 再解壓檔案。 Process.Start("C:/Program Files/7-Zip/7z.exe", "x 我的壓縮檔.7z"); } }

範例三：StartInfo.WindowStyle

在程式碼設定 StartInfo.WindowStyle 屬性為 ProcessWindowStyle.Hidden，然後編譯時下 /t:winexe 參數，這樣執行程式時，既不會跳出視窗、也不會顯示命令提示字元。

using System.Diagnostics; class Program { static void Main() { // 不會顯示意外關閉的 Microsoft Edge 關閉方式 Process process1 = new Process(); process1.StartInfo.FileName = "TASKKILL"; process1.StartInfo.Arguments = "/IM msedge.exe"; process1.StartInfo.WindowStyle = ProcessWindowStyle.Hidden; process1.Start(); process1.WaitForExit(); // 快速關機 Process process2 = new Process(); process2.StartInfo.FileName = "SHUTDOWN"; process2.StartInfo.Arguments = "/S /HYBRID /T 0 /F"; process2.StartInfo.WindowStyle = ProcessWindowStyle.Hidden; process2.Start(); } }

csc /t:winexe /out:快速關機.exe *.cs

取得年月日時分秒

using System; class Program { static void Main() { DateTime now = DateTime.Now; Console.WriteLine(now.Year + "年"); Console.WriteLine(now.Month + "月"); Console.WriteLine(now.Day + "日"); Console.WriteLine(now.Hour + "點"); Console.WriteLine(now.Minute + "分"); Console.Write(now.Second + "秒"); } }

2019 年
4 月
18 日
12 點
34 分
56 秒

計算間隔時間

using System; class Program { static void Main() { DateTime start = DateTime.Now; for (int n=1; n<=50000; n++) { Console.Write(n); } Console.WriteLine(); DateTime end = DateTime.Now; Console.Write(end - start); } }

123456789101112131415161718192021222324252627282930313233343444 (省略)
00:00:01.4561230

取得程式後面的參數

class Program { static void Main(string[] args) { System.Console.Write(arg[0]); System.Console.Write(arg[1]); } }

Program ABC 123
ABC
123

主控台功能

window.xaml

<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" Title="Main" Width="320" Height="240"> <Canvas> <Button Name="Button1" Width="300" Height="30" Margin="2, 70">哈囉</Button> <Button Name="Button2" Width="300" Height="30" Margin="2, 103">再見</Button> </Canvas> </Window>

program.cs

using System; using System.IO; using System.Windows; using System.Windows.Controls; using System.Windows.Markup; partial class Program { Window window; Button button1, button2; Program() { window = (Window)XamlReader.Load(new FileStream("window.xaml", FileMode.Open)); button1 = (Button)window.FindName("Button1"); button1.Click += new RoutedEventHandler(button1_click); button2 = (Button)window.FindName("Button2"); button2.Click += new RoutedEventHandler(button2_click); new Application().Run(window); } void button1_click(object sender, RoutedEventArgs e) { window.Title = "Hello!"; } void button2_click(object sender, RoutedEventArgs e) { window.Title = "Bye~"; } [STAThread] static void Main() { new Program(); } }

編譯

WPF 的編譯要手動載入多個組件，以 Windows 10 內建 .NET Framework 4.8 為例，這些組件是：

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\System.Xaml.dll
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\WPF\PresentationCore.dll
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\WPF\PresentationFramework.dll
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\WPF\WindowsBase.dll

因此可以這樣下指令：

PATH=C:\Windows\Microsoft.NET\Framework64\v4.0.30319\
csc /r:System.Xaml.dll,WPF\PresentationCore.dll,
WPF\PresentationFramework.dll,WPF\WindowsBase.dll /t:winexe *.cs

執行

說明

通常 XAML 檔只用來配置外觀，不負責功能。

如果想改變視窗介面的外觀與配置，只要修改 window.xaml 即可，不用重新編譯 program.cs。

需要更改功能時，才修改原始程式碼，重新編譯。

真要在 XAML 寫功能的話，可使用 <CODE> 標籤寫功能程式，然後指定給控制項標籤的事件屬性。（不適用先前的範例，要重新修改程式才支援。）

建議

如果沒有使用者介面與程式分離的需求，其實繼續用 Windows Forms 就好，不用轉換到 WPF。兩者需求不同，WPF 雖然是新的技術，但沒有新舊交替、取代 Windows Forms 的意思。

如果一開始學的就是 WPF，某天想跟 Windows Forms 一樣，把使用者介面寫死在主程式裡面，其實也不用轉換技術，System.Windows.Controls 的元件可以直接寫進 Window 裡面，並不是非得 XAML 不可，像這樣：

列出所有可用資料

using System; using System.Collections; class MainProgram { static void Main() { Console.WriteLine(); foreach (DictionaryEntry n in Environment.GetEnvironmentVariables()) { Console.WriteLine("{0} = {1}", n.Key, n.Value); } } } // 列出所有可用資料，再從中找靈感看怎麼寫 CGI 程式🧐

以 UTF-8 字元編碼輸出文字

如果作業系統預設使用的字元編碼是 Big5，那 Console.Write() 也會使用 Big5 字元編碼輸出文字，使得網頁指定 UTF-8 字元編碼或者內容有日文的話會亂碼。

解決辦法是用 Console.OutputEncoding = System.Text.Encoding.UTF8; 設定為 UTF-8。

Cookie 的存取

using System; class HTTPCookie { string[] strings; public void SetCookie(string name, string value) { Console.WriteLine("Set-Cookie:{0}={1}; Expires=Thu, 31 Dec 2099 00:00:00 GMT", name, value); } public string GetValue(string name) { if (strings == null) { strings = Environment.GetEnvironmentVariable("HTTP_COOKIE").Split(';'); } foreach (string n in strings) { string[] a = n.Split('='); if (a[0].Trim() == name) { return a[1]; } } return ""; } public void DeleteCookie(string name) { Console.WriteLine("Set-Cookie:{0}={0}; Expires=Thu, 01 Jan 1970 00:00:00 GMT", name); } } class MainProgram { static void Main() { HTTPCookie httpcookie = new HTTPCookie(); httpcookie.SetCookie("name", "Twideem"); httpcookie.SetCookie("number", "58"); Console.WriteLine(); Console.WriteLine(httpcookie.GetValue("name")); Console.Write(httpcookie.GetValue("number")); } } // 寫入 Cookie 是請求動作，要在 header 進行。讀出 Cookie 才在 body 進行。

GET 資料的接收

POST 資料的接收

判斷 GET 或 POST

using System; class MainProgram { static void Main() { Console.WriteLine(); if (Environment.GetEnvironmentVariable("REQUEST_METHOD") == "GET") { // GET } if (Environment.GetEnvironmentVariable("REQUEST_METHOD") == "POST") { // POST } } }

轉址

第一種做法是寫在 HTTP 的 header，請求 URL redirect：

using System; class MainProgram { static void Main() { Console.WriteLine("Location: http://127.0.0.1/redirect.html"); Console.Write(); } }
第二種做法是用 HTML 來完成：

using System; class MainProgram { static void Main() { Console.WriteLine(); Console.WriteLine("<meta http-equiv='refresh' content='3;url=http://127.0.0.1/index.html'>"); Console.Write("<p>三秒後回到首頁⋯</p>"); } }
還有更多種做法，像是用 JavaScript 的 location.href="網址"，道理跟第二種一樣，就不贅述了～

上一頁的妙用

就像超鏈結文字 <A/> 或按鈕 <BUTTON/> 能夠原地執行伺服器的功能一樣，還能避免大量的下一頁，非常好用👍

雖然用 location.replace() 是更好的選擇，但每次都能以這方式間接載入 CGI 網頁也挺煩的～

以 GET 傳輸含中文資料並寫入檔案

以 POST 傳輸含中文資料並寫入檔案

server.cs

using System.IO; using System.Net; using System.Text; class Server { static void Main() { HttpListener httplistener = new HttpListener(); httplistener.Prefixes.Add("http://127.0.0.1/"); httplistener.Start(); while (true) { HttpListenerContext context = httplistener.GetContext(); context.Response.ContentType = "text/html; charset=utf-8"; if (context.Request.Url.LocalPath != "/favicon.ico") { byte[] bytes = File.ReadAllBytes(Directory.GetCurrentDirectory() + "/" + context.Request.Url.LocalPath); context.Response.ContentLength64 = bytes.Length; context.Response.OutputStream.Write(bytes, 0, bytes.Length); } context.Response.Close(); } } }

index.html

<a href='page.html'>page.html</a>

page.html

<a href='index.html'>index.html</a>

server.cs

using System.IO; using System.Net; using System.Text; using System.Threading; class Server { static void Main() { // 後端監聽程式 new Thread(() => { HttpListener listener = new HttpListener(); listener.Prefixes.Add("http://127.0.0.1:33405/"); listener.Start(); while (true) { HttpListenerContext context = listener.GetContext(); if (context.Request.HttpMethod == "POST") { File.WriteAllText("res.dat", WebUtility.UrlDecode(new StreamReader(context.Request.InputStream).ReadToEnd())); } context.Response.ContentType = "text/html; charset=utf-8"; byte[] bytes = Encoding.UTF8.GetBytes("<h1>資料已儲存</h1>"); context.Response.OutputStream.Write(bytes, 0, bytes.Length); context.Response.Close(); } }).Start(); // 網頁伺服器 new Thread(() => { HttpListener listener = new HttpListener(); listener.Prefixes.Add("http://127.0.0.1/"); listener.Start(); while (true) { HttpListenerContext context = listener.GetContext(); if (context.Request.Url.LocalPath != "/favicon.ico") { context.Response.ContentType = "text/html; charset=utf-8"; byte[] bytes = File.ReadAllBytes(Directory.GetCurrentDirectory() + context.Request.Url.LocalPath); context.Response.ContentLength64 = bytes.Length; context.Response.OutputStream.Write(bytes, 0, bytes.Length); } context.Response.Close(); } }).Start(); } }

client.html

<form action='http://127.0.0.1:33405' method='post'> <input name='args' value='中文'> <input type='submit'> </form>

server.cs

using Fleck; using System; using System.Collections.Generic; using System.Linq; class Server { static void Main() { WebSocketServer server = new WebSocketServer("ws://127.0.0.1"); List<IWebSocketConnection> sockets = new List<IWebSocketConnection>(); server.Start(x => { x.OnOpen = () => { Console.WriteLine("A client connected."); sockets.Add(x); }; x.OnClose = () => { Console.WriteLine("The client disconnected."); sockets.Remove(x); }; x.OnMessage = y => { // 輸出取得的客戶端訊息 Console.WriteLine(y); // 送給客戶端訊息 sockets.ToList().ForEach(n => n.Send(y + " world")); }; }); // 伺服端常駐迴圈 string input = Console.ReadLine(); while (input != "exit") { foreach (IWebSocketConnection n in sockets.ToList()) { n.Send(input); } input = Console.ReadLine(); } } }

csc /r:Fleck.dll *.cs

執行 Server.exe 時需要動態連結 Fleck.dll，因此不要更改它的檔名，否則會出現「無法列印例外狀況字串，因為 Exception.ToString() 失敗。」錯誤訊息。

client.html

<button onclick='f()'>Click</button> <script> let socket = new WebSocket('ws://127.0.0.1'); function f(){ socket.send('Hello'); } socket.onmessage = function(x){ document.querySelector('button').innerHTML = x.data; }; </script>
按下網頁按鈕，主控台會顯示 Hello（客戶端發出的訊息），按鈕文字會變成 Hello world（伺服端發出的訊息）。