前幾天在刷即刻的時候發現了一個GitHub上的專案，該專案名為“learn x in y minutes”，這個名稱就很簡明扼要——“y分鐘學習xxx”，一看就很牛。對於這種大神級別的人物我是非常憧憬的，懷著欣喜和敬畏的心態，點下了star，然後我就把網頁關了。。。不要問我為什麼不趁熱學習一下，畢竟眾所周知，收藏就等於學會了嘛。
n天后的今天，我終於想起來有這麼一個偉大的專案還躺在我的列表裡，我又把它翻了出來，學習了一下該專案裡的c#文件。果然不負眾望，收穫頗豐。正如作者做說的：
Code documentation written as code! How novel and totally my idea!
確實是很新奇的講解方法，幾百行程式碼就把C#的很多常用基礎語法講了個遍，而且是以程式碼的形式，沒有長篇大論，用程式碼講語法才是最直觀的。但是覺得不太適合初學者，還是適合有一定基礎的人，不然一句都看不懂，也沒有釋義，可不得在心裡把作者罵個十幾遍。
廢話不多說，專案地址：https://github.com/adambard/learnxinyminutes-docs
這個專案裡的c#程式碼在執行時存在一些簡單的問題，我自作主張的進行了修改。修改後的程式碼貼在文章末尾了。
把這個文件和專案分享出來，希望能對向我一樣的新手有幫助。
// 單行註釋以 // 開始
/*
多行註釋是這樣的
*/
/// <summary>
/// XML文件註釋
/// </summary>
// 宣告應用用到的名稱空間
using System;
using System.Collections.Generic;
using System.Data.Entity;
using System.Dynamic;
using System.IO;
using System.Linq;
using System.Net;
using System.Threading.Tasks;
// 定義作用域，將程式碼組織成包
namespace Learning
{
// 每個 .cs 檔案至少需要包含一個和檔名相同的類
// 你可以不這麼幹，但是這樣不好。
public class LearnCSharp
{
// 基本語法 - 如果你以前用過 Java 或 C++ 的話，可以直接跳到後文「有趣的特性」
public static void Syntax()
{
// 使用 Console.WriteLine 列印資訊
Console.WriteLine("Hello World");
Console.WriteLine(
"Integer: " + 10 +
" Double: " + 3.14 +
" Boolean: " + true);
// 使用 Console.Write 列印，不帶換行符號
Console.Write("Hello ");
Console.Write("World");
// 字串 -- 和前面的基本型別不同，字串不是值，而是引用。
// 這意味著你可以將字串設為null。
string fooString = "\"escape\" quotes and add \n (new lines) and \t (tabs)";
Console.WriteLine(fooString);
// 你可以通過索引訪問字串的每個字元：
char charFromString = fooString[1]; // => 'e'
// 字串不可修改: fooString[1] = 'X' 是行不通的;
// 根據當前的locale設定比較字串，大小寫不敏感
string.Compare(fooString, "x", StringComparison.CurrentCultureIgnoreCase);
// 基於sprintf的字串格式化
string fooFs = string.Format("Check Check, {0} {1}, {0} {1:0.0}", 1, 2);
// 日期和格式
DateTime fooDate = DateTime.Now;
Console.WriteLine(fooDate.ToString("hh:mm, dd MMM yyyy"));
///////////////////////////////////////////////////
// 資料結構
///////////////////////////////////////////////////
// 陣列 - 從0開始計數
// 宣告陣列時需要確定陣列長度
// 宣告陣列的格式如下：
// <datatype>[] <var name> = new <datatype>[<array size>];
int[] intArray = new int[10];
// 宣告並初始化陣列的其他方式：
int[] y = { 9000, 1000, 1337 };
// 訪問陣列的元素
Console.WriteLine("intArray @ 0: " + intArray[0]);
// 陣列可以修改
intArray[1] = 1;
// 列表
// 列表比陣列更常用，因為列表更靈活。
// 宣告列表的格式如下：
// List<datatype> <var name> = new List<datatype>();
List<int> intList = new List<int>();
List<string> stringList = new List<string>();
List<int> z = new List<int> { 9000, 1000, 1337 }; // i
// <>用於泛型 - 參考下文
// 列表無預設值
// 訪問列表元素時必須首先新增元素
intList.Add(1);
Console.WriteLine("intList @ 0: " + intList[0]);
// 其他資料結構：
// 堆疊/佇列
// 字典 (雜湊表的實現)
// 雜湊集合
// 只讀集合
// 元組 (.Net 4+)
///////////////////////////////////////
// 操作符
///////////////////////////////////////
Console.WriteLine("\n->Operators");
int i1 = 1, i2 = 2; // 多重宣告的簡寫形式
// 算術直截了當
Console.WriteLine(i1 + i2 - i1 * 3 / 7); // => 3
// 取餘
Console.WriteLine("11%3 = " + (11 % 3)); // => 2
// 比較操作符
Console.WriteLine("3 == 2? " + (3 == 2)); // => false
Console.WriteLine("3 != 2? " + (3 != 2)); // => true
Console.WriteLine("3 > 2? " + (3 > 2)); // => true
Console.WriteLine("3 < 2? " + (3 < 2)); // => false
Console.WriteLine("2 <= 2? " + (2 <= 2)); // => true
Console.WriteLine("2 >= 2? " + (2 >= 2)); // => true
// 位操作符
/*
~ 取反
<< 左移（有符號）
>> 右移（有符號）
& 與
^ 異或
| 或
*/
// 自增、自減
int i = 0;
Console.WriteLine("\n->Inc/Dec-rementation");
Console.WriteLine(i++); //i = 1. 事後自增
Console.WriteLine(++i); //i = 2. 事先自增
Console.WriteLine(i--); //i = 1. 事後自減
Console.WriteLine(--i); //i = 0. 事先自減
///////////////////////////////////////
// 控制結構
///////////////////////////////////////
Console.WriteLine("\n->Control Structures");
// 類似C的if語句
int j = 10;
if (j == 10)
{
Console.WriteLine("I get printed");
}
else if (j > 10)
{
Console.WriteLine("I don't");
}
else
{
Console.WriteLine("I also don't");
}
// 三元表示式
// 簡單的 if/else 語句可以寫成：
// <條件> ? <真> : <假>
int toCompare = 17;
string isTrue = toCompare == 17 ? "True" : "False";
// While 迴圈
int fooWhile = 0;
while (fooWhile < 100)
{
//迭代 100 次, fooWhile 0->99
fooWhile++;
}
// Do While 迴圈
int fooDoWhile = 0;
do
{
//迭代 100 次, fooDoWhile 0->99
fooDoWhile++;
} while (fooDoWhile < 100);
//for 迴圈結構 => for(<初始條件>; <條件>; <步>)
for (int fooFor = 0; fooFor < 10; fooFor++)
{
//迭代10次, fooFor 0->9
}
// foreach迴圈
// foreach 迴圈結構 => foreach(<迭代器型別> <迭代器> in <可列舉結構>)
// foreach 迴圈適用於任何實現了 IEnumerable 或 IEnumerable<T> 的物件。
// .Net 框架下的集合型別(陣列, 列表, 字典...)
// 都實現了這些介面
// (下面的程式碼中，ToCharArray()可以刪除，因為字串同樣實現了IEnumerable)
foreach (char character in "Hello World".ToCharArray())
{
//迭代字串中的所有字元
}
// Switch 語句
// switch 適用於 byte、short、char和int 資料型別。
// 同樣適用於可列舉的型別
// 包括字串類, 以及一些封裝了原始值的類：
// Character、Byte、Short和Integer。
int month = 3;
switch (month)
{
case 1:
break;
case 2:
break;
case 3:
break;
// 你可以一次匹配多個case語句
// 但是你在新增case語句後需要使用break
// （否則你需要顯式地使用goto case x語句）
case 6:
case 7:
case 8:
break;
default:
break;
}
///////////////////////////////////////
// 轉換、指定資料型別
///////////////////////////////////////
// 轉換型別
// 轉換字串為整數
// 轉換失敗會丟擲異常
int.Parse("123");//返回整數型別的"123"
// TryParse會嘗試轉換型別，失敗時會返回預設型別
// 例如 0
int tryInt;
if (int.TryParse("123", out tryInt)) // Funciton is boolean
Console.WriteLine(tryInt); // 123
// 轉換整數為字串
// Convert類提供了一系列便利轉換的方法
Convert.ToString(123);
// or
tryInt.ToString();
}
///////////////////////////////////////
// 類
///////////////////////////////////////
public static void Classes()
{
// 參看檔案尾部的物件宣告
// 使用new初始化物件
Bicycle trek = new Bicycle();
// 呼叫物件的方法
trek.SpeedUp(3); // 你應該一直使用setter和getter方法
trek.Cadence = 100;
// 檢視物件的資訊.
Console.WriteLine("trek info: " + trek.Info());
// 例項化一個新的Penny Farthing
PennyFarthing funbike = new PennyFarthing(1, 10);
Console.WriteLine("funbike info: " + funbike.Info());
Console.Read();
} // 結束main方法
// 終端程式 終端程式必須有一個main方法作為入口
public static void Main(string[] args)
{
OtherInterestingFeatures();
}
//
// 有趣的特性
//
// 預設方法簽名
public // 可見性
static // 允許直接呼叫類，無需先建立例項
int //返回值
MethodSignatures(
int maxCount, // 第一個變數，型別為整型
int count = 0, // 如果沒有傳入值，則預設值為0
int another = 3,
params string[] otherParams // 捕獲其他引數
)
{
return -1;
}
// 方法可以重名，只要簽名不一樣
public static void MethodSignature(string maxCount)
{
}
//泛型
// TKey和TValue類由用使用者呼叫函式時指定。
// 以下函式模擬了Python的SetDefault
public static TValue SetDefault<TKey, TValue>(
IDictionary<TKey, TValue> dictionary,
TKey key,
TValue defaultItem)
{
TValue result;
if (!dictionary.TryGetValue(key, out result))
return dictionary[key] = defaultItem;
return result;
}
// 你可以限定傳入值的範圍
public static void IterateAndPrint<T>(T toPrint) where T : IEnumerable<int>
{
// 我們可以進行迭代，因為T是可列舉的
foreach (var item in toPrint)
// ittm為整數
Console.WriteLine(item.ToString());
}
public static void OtherInterestingFeatures()
{
// 可選引數
MethodSignatures(3, 1, 3, "Some", "Extra", "Strings");
MethodSignatures(3, another: 3); // 顯式指定引數，忽略可選引數
// 擴充套件方法
int i = 3;
i.Print(); // 參見下面的定義
// 可為null的型別 對資料庫互動、返回值很有用
// 任何值型別 (i.e. 不為類) 新增字尾 ? 後會變為可為null的值
// <型別>? <變數名> = <值>
int? nullable = null; // Nullable<int> 的簡寫形式
Console.WriteLine("Nullable variable: " + nullable);
bool hasValue = nullable.HasValue; // 不為null時返回真
// ?? 是用於指定預設值的語法糖
// 以防變數為null的情況
int notNullable = nullable ?? 0; // 0
// magic = 9; // 不工作，因為magic是字串，而不是整數。
// 泛型
//
var phonebook = new Dictionary<string, string>() {
{"Sarah", "212 555 5555"} // 在電話簿中加入新條目
};
// 呼叫上面定義為泛型的SETDEFAULT
Console.WriteLine(SetDefault<string, string>(phonebook, "Shaun", "No Phone")); // 沒有電話
// 你不用指定TKey、TValue，因為它們會被隱式地推匯出來
Console.WriteLine(SetDefault(phonebook, "Sarah", "No Phone")); // 212 555 5555
// lambda表示式 - 允許你用一行程式碼搞定函式
Func<int, int> square = (x) => x * x; // 最後一項為返回值
Console.WriteLine(square(3)); // 9
// 可拋棄的資源管理 - 讓你很容易地處理未管理的資源
// 大多數訪問未管理資源 (檔案操作符、裝置上下文, etc.)的物件
// 都實現了IDisposable介面。
// using語句會為你清理IDisposable物件。
using (StreamWriter writer = new StreamWriter("log.txt"))
{
writer.WriteLine("這裡沒有什麼可疑的東西");
// 在作用域的結尾，資源會被回收
// （即使有異常丟擲，也一樣會回收）
}
// 並行框架
// http://blogs.msdn.com/b/csharpfaq/archive/2010/06/01/parallel-programming-in-net-framework-4-getting-started.aspx
var websites = new string[] {
"http://www.google.com", "http://www.reddit.com",
"http://www.shaunmccarthy.com"
};
var responses = new Dictionary<string, string>();
// 為每個請求新開一個執行緒
// 在執行下一步前合併結果
Parallel.ForEach(websites,
new ParallelOptions() { MaxDegreeOfParallelism = 3 }, // max of 3 threads
website =>
{
// Do something that takes a long time on the file
using (var r = WebRequest.Create(new Uri(website)).GetResponse())
{
responses[website] = r.ContentType;
}
});
// 直到所有的請求完成後才會執行下面的程式碼
foreach (var key in responses.Keys)
Console.WriteLine("{0}:{1}", key, responses[key]);
// 動態物件（配合其他語言使用很方便）
dynamic student = new ExpandoObject();
student.FirstName = "First Name"; // 不需要先定義類！
// 你甚至可以新增方法（接受一個字串，輸出一個字串）
student.Introduce = new Func<string, string>(
(introduceTo) => string.Format("Hey {0}, this is {1}", student.FirstName, introduceTo));
Console.WriteLine(student.Introduce("Beth"));
// IQUERYABLE<T> - 幾乎所有的集合都實現了它，
// 帶給你 Map / Filter / Reduce 風格的方法
var bikes = new List<Bicycle>();
bikes.Sort(); // Sorts the array
bikes.Sort((b1, b2) => b1.Wheels.CompareTo(b2.Wheels)); // 根據車輪數排序
var result = bikes
.Where(b => b.Wheels > 3) // 篩選 - 可以連鎖使用 （返回IQueryable)
.Where(b => b.IsBroken && b.HasTassles)
.Select(b => b.ToString()); // Map - 這裡我們使用了select，所以結果是IQueryable<string>
var sum = bikes.Sum(b => b.Wheels); // Reduce - 計算集合中的輪子總數
// 建立一個包含基於自行車的一些引數生成的隱式物件的列表
var bikeSummaries = bikes.Select(b => new { Name = b.Name, IsAwesome = !b.IsBroken && b.HasTassles });
// 很難演示，但是編譯器在程式碼編譯完成前就能推匯出以上物件的型別
foreach (var bikeSummary in bikeSummaries.Where(b => b.IsAwesome))
Console.WriteLine(bikeSummary.Name);
// ASPARALLEL
// 邪惡的特性 —— 組合了linq和並行操作
var threeWheelers = bikes.AsParallel().Where(b => b.Wheels == 3).Select(b => b.Name);
// 以上程式碼會併發地執行。會自動新開執行緒，分別計算結果。
// 適用於多核、大資料量的場景。
// LINQ - 將IQueryable<T>對映到儲存，延緩執行
// 例如 LinqToSql 對映資料庫, LinqToXml 對映XML文件
var db = new BikeRespository();
// 執行被延遲了，這對於查詢資料庫來說很好
var filter = db.Bikes.Where(b => b.HasTassles); // 不執行查詢
if (42 > 6) // 你可以不斷地增加篩選，包括有條件的篩選，例如用於“高階搜尋”功能
filter = filter.Where(b => b.IsBroken); // 不執行查詢
var query = filter
.OrderBy(b => b.Wheels)
.ThenBy(b => b.Name)
.Select(b => b.Name); // 仍然不執行查詢
// 現在執行查詢，執行查詢的時候會開啟一個讀取器，所以你迭代的是一個副本
foreach (string bike in query)
Console.WriteLine(result);
}
} // 結束LearnCSharp類
// 你可以在同一個 .cs 檔案中包含其他類
public static class Extensions
{
// 擴充套件函式
public static void Print(this object obj)
{
Console.WriteLine(obj.ToString());
}
}
// 宣告類的語法：
// <public/private/protected/internal> class <類名>{
// //資料欄位, 構造器, 內部函式.
// // 在Java中函式被稱為方法。
// }
public class Bicycle
{
// 自行車的欄位、變數
public int Cadence // Public: 任何地方都可以訪問
{
get // get - 定義獲取屬性的方法
{
return this._cadence;
}
set // set - 定義設定屬性的方法
{
this._cadence = value; // value是被傳遞給setter的值
}
}
private int _cadence;
protected virtual int Gear // 類和子類可以訪問
{
get; // 建立一個自動屬性，無需成員欄位
set;
}
internal int Wheels // Internal:在同一程式集內可以訪問
{
get;
private set; // 可以給get/set方法新增修飾符
}
private int _speed; // 預設為private: 只可以在這個類內訪問，你也可以使用`private`關鍵詞
public string Name { get; set; }
// enum型別包含一組常量
// 它將名稱對映到值（除非特別說明，是一個整型）
// enmu元素的型別可以是byte、sbyte、short、ushort、int、uint、long、ulong。
// enum不能包含相同的值。
public enum BikeBrand
{
AIST,
BMC,
Electra = 42, //你可以顯式地賦值
Gitane // 43
}
// 我們在Bicycle類中定義的這個型別，所以它是一個內嵌型別。
// 這個類以外的程式碼應當使用`Bicycle.Brand`來引用。
public BikeBrand Brand; // 宣告一個enum型別之後，我們可以宣告這個型別的欄位
// 靜態方法的型別為自身，不屬於特定的物件。
// 你無需引用物件就可以訪問他們。
// Console.WriteLine("Bicycles created: " + Bicycle.bicyclesCreated);
public static int BicyclesCreated = 0;
// 只讀值在執行時確定
// 它們只能在宣告或構造器內被賦值
private readonly bool _hasCardsInSpokes = false; // read-only private
// 構造器是建立類的一種方式
// 下面是一個預設的構造器
public Bicycle()
{
Gear = 1; // 你可以使用關鍵詞this訪問物件的成員
Cadence = 50; // 不過你並不總是需要它
this._speed = 5;
Name = "Bontrager";
this.Brand = BikeBrand.AIST;
BicyclesCreated++;
}
// 另一個構造器的例子（包含引數）
public Bicycle(int startCadence, int startSpeed, int startGear,
string name, bool hasCardsInSpokes, BikeBrand brand)
: base() // 首先呼叫base
{
Gear = startGear;
Cadence = startCadence;
this._speed = startSpeed;
Name = name;
this._hasCardsInSpokes = hasCardsInSpokes;
this.Brand = brand;
}
// 構造器可以連鎖使用
public Bicycle(int startCadence, int startSpeed, BikeBrand brand) :
this(startCadence, startSpeed, 0, "big wheels", true, brand)
{
}
// 函式語法
// <public/private/protected> <返回值> <函式名稱>(<引數>)
// 類可以為欄位實現 getters 和 setters 方法 for their fields
// 或者可以實現屬性（C#推薦使用這個）
// 方法的引數可以有預設值
// 在有預設值的情況下，呼叫方法的時候可以省略相應的引數
public void SpeedUp(int increment = 1)
{
this._speed += increment;
}
public void SlowDown(int decrement = 1)
{
this._speed -= decrement;
}
// 屬性可以訪問和設定值
// 當只需要訪問資料的時候，考慮使用屬性。
// 屬性可以定義get和set，或者是同時定義兩者
private bool _hasTassles; // private variable
public bool HasTassles // public accessor
{
get { return this._hasTassles; }
set { this._hasTassles = value; }
}
// 你可以在一行之內定義自動屬性
// 這個語法會自動建立後備欄位
// 你可以給getter或setter設定訪問修飾符
// 以便限制它們的訪問
public bool IsBroken { get; private set; }
// 屬性的實現可以是自動的
public int FrameSize
{
get;
// 你可以給get或set指定訪問修飾符
// 以下程式碼意味著只有Bicycle類可以呼叫Framesize的set
private set;
}
//顯示物件屬性的方法
public virtual string Info()
{
return "Gear: " + Gear +
" Cadence: " + Cadence +
" Speed: " + this._speed +
" Name: " + Name +
" Cards in Spokes: " + (this._hasCardsInSpokes ? "yes" : "no") +
"\n------------------------------\n"
;
}
// 方法可以是靜態的。通常用於輔助方法。
public static bool DidWeCreateEnoughBycles()
{
// 在靜態方法中，你只能引用類的靜態成員
return BicyclesCreated > 9000;
} // 如果你的類只需要靜態成員，考慮將整個類作為靜態類。
} // Bicycle類結束
// PennyFarthing是Bicycle的一個子類
internal class PennyFarthing : Bicycle
{
// (Penny Farthings是一種前輪很大的自行車。沒有齒輪。）
// 呼叫父構造器
public PennyFarthing(int startCadence, int startSpeed) :
base(startCadence, startSpeed, 0, "PennyFarthing", true, BikeBrand.Electra)
{
}
protected override int Gear
{
get
{
return 0;
}
set
{
throw new ArgumentException("你不可能在PennyFarthing上切換齒輪");
}
}
public override string Info()
{
string result = "PennyFarthing bicycle ";
result += base.ToString(); // 呼叫父方法
return result;
}
// 介面只包含成員的簽名，而沒有實現。
private interface IJumpable
{
void Jump(int meters); // 所有介面成員是隱式地公開的
}
private interface IBreakable
{
bool Broken { get; } // 介面可以包含屬性、方法和事件
}
// 類只能繼承一個類，但是可以實現任意數量的介面
private int damage = 0;
public void Jump(int meters)
{
this.damage += meters;
}
public bool Broken
{
get
{
return this.damage > 100;
}
}
}
/// <summary>
/// 連線資料庫，一個 LinqToSql的示例。
/// EntityFramework Code First 很棒 (類似 Ruby的 ActiveRecord, 不過是雙向的)
/// http://msdn.microsoft.com/en-us/data/jj193542.aspx
/// </summary>
public class BikeRespository : DbSet
{
public BikeRespository()
: base()
{
}
public DbSet<Bicycle> Bikes { get; set; }
}
} // 結束 Namespace