.NET中API破壞性更改的權(quán)威指南我想盡可能多地收集有關(guān).NET / CLR中API版本控制的信息，特別是API更改如何破壞客戶(hù)端應(yīng)用程序。首先，讓我們定義一些術(shù)語(yǔ)：API更改 - 類(lèi)型的公開(kāi)可見(jiàn)定義的更改，包括其任何公共成員。這包括更改類(lèi)型和成員名稱(chēng)，更改類(lèi)型的基本類(lèi)型，從類(lèi)型的已實(shí)現(xiàn)接口列表添加/刪除接口，添加/刪除成員（包括重載），更改成員可見(jiàn)性，重命名方法和類(lèi)型參數(shù)，添加默認(rèn)值對(duì)于方法參數(shù)，在類(lèi)型和成員上添加/刪除屬性，以及在類(lèi)型和成員上添加/刪除泛型類(lèi)型參數(shù)（我錯(cuò)過(guò)了什么嗎？）。這不包括成員團(tuán)體的任何變化，或私人成員的任何變化（即我們不考慮反射）。二進(jìn)制級(jí)別中斷 - 一種API更改，導(dǎo)致針對(duì)舊版本API編譯的客戶(hù)端程序集可能無(wú)法加載新版本。示例：更改方法簽名，即使它允許以與之前相同的方式調(diào)用（即：void返回類(lèi)型/參數(shù)默認(rèn)值重載）。源級(jí)別中斷 - 一種API更改，導(dǎo)致編寫(xiě)現(xiàn)有代碼以針對(duì)舊版本的API進(jìn)行編譯，可能無(wú)法使用新版本進(jìn)行編譯。然而，已經(jīng)編譯的客戶(hù)端程序集像以前一樣工作。示例：添加一個(gè)新的重載，這可能導(dǎo)致前一個(gè)明確的方法調(diào)用不明確。源級(jí)安靜語(yǔ)義更改 - 一種API更改導(dǎo)致編寫(xiě)的現(xiàn)有代碼針對(duì)舊版API進(jìn)行編譯，從而悄然改變其語(yǔ)義，例如通過(guò)調(diào)用不同的方法。但是，代碼應(yīng)該繼續(xù)編譯而沒(méi)有警告/錯(cuò)誤，以前編譯的程序集應(yīng)該像以前一樣工作。示例：在現(xiàn)有類(lèi)上實(shí)現(xiàn)新接口，導(dǎo)致在重載解析期間選擇不同的重載。最終目標(biāo)是盡可能地對(duì)盡可能多的破壞和靜默語(yǔ)義API更改進(jìn)行編目，并描述破壞的確切影響，以及哪些語(yǔ)言不受其影響。擴(kuò)展后者：雖然一些變化普遍影響所有語(yǔ)言（例如，向接口添加新成員將破壞任何語(yǔ)言中該接口的實(shí)現(xiàn)），但有些需要非常特定的語(yǔ)言語(yǔ)義才能進(jìn)入游戲以獲得休息。這通常涉及方法重載，并且通常涉及與隱式類(lèi)型轉(zhuǎn)換有關(guān)的任何事情。似乎沒(méi)有任何方法可以在這里定義“最小公分母”，即使對(duì)于符合CLS的語(yǔ)言（即那些至少符合CLI規(guī)范中定義的“CLS使用者”規(guī)則的語(yǔ)言） - 盡管我 如果有人在這里糾正我是錯(cuò)的，我會(huì)很感激 - 所以這必須按語(yǔ)言去語(yǔ)言。那些最感興趣的東西自然就是開(kāi)箱即用的.NET：C＃，VB和F＃; 但其他人，如IronPython，IronRuby，Delphi Prism等也是相關(guān)的。它的角落越多，它就越有趣 - 刪除成員之類(lèi)的東西是不言而喻的，但是例如方法重載，可選/默認(rèn)參數(shù)，lambda類(lèi)型推斷和轉(zhuǎn)換運(yùn)算符之間的微妙交互可能會(huì)非常令人驚訝有時(shí)。舉幾個(gè)例子來(lái)啟動(dòng)這個(gè)：添加新方法重載種類(lèi)：源級(jí)休息受影響的語(yǔ)言：C＃，VB，F(xiàn)＃更改前的API：public class Foo{     public void Bar(IEnumerable x);}更改后的API：public class Foo{     public void Bar(IEnumerable x);     public void Bar(ICloneable x);}示例客戶(hù)端代碼在更改之前工作并在其之后中斷：new Foo().Bar(new int[0]);添加新的隱式轉(zhuǎn)換運(yùn)算符重載種類(lèi)：源級(jí)休息。受影響的語(yǔ)言：C＃，VB語(yǔ)言不受影響：F＃更改前的API：public class Foo{     public static implicit operator int ();}更改后的API：public class Foo{     public static implicit operator int ();     public static implicit operator float ();}示例客戶(hù)端代碼在更改之前工作并在其之后中斷：void Bar(int x);void Bar(float x);Bar(new Foo());注意：F＃沒(méi)有被破壞，因?yàn)樗鼪](méi)有任何語(yǔ)言級(jí)別的支持重載運(yùn)算符，既不顯式也不隱式 - 都必須直接調(diào)用op_Explicit和op_Implicit方法。添加新的實(shí)例方法種類(lèi)：源級(jí)靜默語(yǔ)義變化。受影響的語(yǔ)言：C＃，VB語(yǔ)言不受影響：F＃更改前的API：public class Foo{}更改后的API：public class Foo{     public void Bar();}樣本客戶(hù)端代碼遭受安靜的語(yǔ)義更改：public static class FooExtensions{     public void Bar(this Foo foo);}new Foo().Bar();注意：F＃沒(méi)有被破壞，因?yàn)樗鼪](méi)有語(yǔ)言級(jí)支持ExtensionMethodAttribute，并且需要將CLS擴(kuò)展方法作為靜態(tài)方法調(diào)用。