程式碼片段 (C#)

更新：2007 年 11 月

Visual Studio 提供一項稱為程式碼片段的功能。這些程式碼片段是現成的程式碼片段，您可以快速地將其插入程式碼中。例如，for 程式碼片段會建立空的 for 迴圈。某些程式碼片段是範圍陳述式 (Surround-With) 程式碼片段，可讓您選取程式碼行，然後選擇要加入所選取程式碼行的程式碼片段。例如，當您選取程式碼行然後啟動 for 程式碼片段時，便會建立 for 迴圈，且迴圈區塊內會包含這些程式碼行。程式碼片段可讓您更快速、輕鬆地撰寫更可靠的程式碼。

使用程式碼片段

若要使用程式碼片段，請輸入其 Shortcut 項目 (IntelliSense 程式碼片段)，再按兩次 TAB 鍵。含有捷徑名稱的程式碼片段隨即出現在 C# 中的完成清單內。在 [完成清單] 中點選向上和向下箭頭，瀏覽所有可用的程式碼片段捷徑。

不具有捷徑值的程式碼片段必須以不同方式使用。在 [程式碼編輯器] 中按下 CTRL+K、X，啟動 [插入程式碼片段] 功能表。接著從功能表選取程式碼片段，然後按 TAB 鍵或 ENTER 鍵。如需詳細資訊，請參閱 HOW TO：使用程式碼片段 (C#) 和 HOW TO：使用範圍陳述式程式碼片段。

一旦選擇了程式碼片段，程式碼片段的文字就會自動插入游標所在位置。此時，程式碼片段中所有可編輯的欄位都會以黃色反白顯示，並且會自動選取第一個可編輯的欄位。目前選取的欄位會加上紅色外框。例如，在 for 程式碼片段中，可編輯的欄位是初始設定式變數 (預設為 i) 和長度運算式 (預設為 length)。

選取欄位時，使用者可在欄位中輸入新值。按 TAB 鍵可循環選擇程式碼片段的可編輯欄位，而按 SHIFT+TAB 鍵則會依反向順序循環選擇這些欄位。按一下欄位可將游標置於該欄位中，按兩下欄位則會選取該欄位。反白顯示欄位時，可能會顯示工具提示，提供欄位的描述。

只有指定欄位的第一個執行個體可編輯，而反白顯示該欄位時，該欄位的其他執行個體都會加上外框。當您變更可編輯欄位的值時，所有在程式碼片段中使用的該欄位都會隨著變更。

按 ENTER 或 ESC 鍵可取消欄位編輯，並讓 [程式碼編輯器] 回到正常狀態。

可編輯的程式碼片段欄位的預設色彩可以變更，方法是修改 [選項] 對話方塊中 [字型和色彩] 窗格裡的 [程式碼片段欄位] 設定。如需詳細資訊，請參閱 HOW TO：變更編輯器中使用的的字型、大小和顏色。

建立程式碼片段

除了 Visual Studio 預設包含的程式碼片段之外，您還可以自行建立和使用自訂程式碼片段。如需如何建立自訂程式碼片段的詳細資訊，請參閱建立程式碼片段。

注意事項：
針對 C# 程式碼片段，可用來指定 <Shortcut> 欄位的有效字元如下：英數字元、數字符號 (#)、波狀符號字元 (~)、底線字元 (_)，以及連字號字元 (-)。

如需 Visual C# 中預設包含的程式碼片段之詳細資訊，請參閱預設程式碼片段。

請參閱

參考

程式碼片段選擇器