共用方式為


程式碼後置和 XAML

更新:2007 年 11 月

程式碼後置 (Code-Behind) 一詞是用來描述將 XAML 頁面編譯成應用程式時,與 XAML 處理器建立之程式碼聯結 (Join) 的程式碼。本主題說明程式碼後置的需求,以及 XAML 中程式碼的替代內嵌程式碼機制。

這個主題包含下列章節。

  • 必要條件
  • 程式碼後置、事件處理常式和部分類別需求
  • x:Code
  • 內嵌程式碼限制
  • 相關主題

必要條件

本主題假設您已讀過 XAML 概觀,而且有一些 CLR 和物件導向程式設計的基本知識。

程式碼後置、事件處理常式和部分類別需求

  • 部分類別 (Class) 必須衍生自當做根項目 (Root Element) 之類別的型別。您可以在程式碼後置中,將部分類別定義中的衍生設定留白,但是即使未指定,編譯的結果還是會採用頁面根項目做為部分類別的基底類別 (因為部分類別的標記部分已將頁面根項目指定為基底)。

  • 您所撰寫的事件處理常式必須是部分類別在 x:Class 識別之 CLR 命名空間內定義的執行個體方法。您不能限制事件處理常式的名稱,以指示 XAML 處理器在不同的類別範圍中尋找該處理常式。您也不能使用靜態方法做為事件處理常式。

  • 處理常式必須符合適當事件的委派。

  • 您可特別針對 Microsoft Visual Basic .NET 語言,使用語言特定 Handles 關鍵字建立處理常式與處理常式宣告中執行個體和事件的關聯,而不必附加處理常式與 XAML 中的屬性 (Attribute)。不過,這種方法有一些限制,因為 Handles 不能支援 WPF 事件系統的所有特定功能,例如特定路由事件案例或附加事件。如需詳細資訊,請參閱 Visual Basic 和 WPF 事件處理

x:Code

x:Code 是定義在 XAML 中的指示詞項目。x:Code 指示詞項目可以包含內嵌程式碼。這種以內嵌方式定義的程式碼可以與相同頁面上的 XAML 互動。下列範例顯示內嵌的 C# 程式碼。請注意此程式碼位於 x:Code 項目內,而且程式碼必須放在 <CDATA[...]]> 中,以逸出 XML 的內容,XAML 處理器 (解譯 XAML 結構描述或 WPF 結構描述) 才不會嘗試依字面將內容解譯為 XML。

<Page
  xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="MyNamespace.MyCanvasCodeInline"
>
  <Button Name="button1" Click="Clicked">Click Me!</Button>
  <x:Code><![CDATA[
    void Clicked(object sender, RoutedEventArgs e)
    {
        button1.Content = "Hello World";
    }
  ]]></x:Code>
</Page>

內嵌程式碼限制

您應該考慮避免或限制在 XAML 架構應用程式中使用內嵌程式碼。就架構和程式碼撰寫原理而言,將標記和程式碼後置分開,可以讓設計人員和開發人員的角色更為涇渭分明。就較為技術性的層面來看,撰寫內嵌程式碼的難度可能較高,因為您總是寫入 XAML 頁面產生的部分類別,而且只能使用預設 XML 命名空間對應。因為您不能加入 using 陳述式,所以必須完整限定您所進行的許多 API 呼叫。預設 WPF 對應包括存在 WPF 組件中的多數 (但非全部) CLR 命名空間;您必須完全限定對包含在其他 CLR 命名空間內之 API 的呼叫。您也不能在內嵌程式碼中定義多個類別,而且所有的程式碼實體 (Entity) 全都必須以成員或變數的形式存在產生的部分類別內。其他語言特定的程式設計功能,例如巨集或相對於全域變數或建置變數的 #ifdef,也無法使用。如需詳細資訊,請參閱 x:Code XAML 指示詞項目

請參閱

概念

XAML 概觀

建置 WPF 應用程式 (WPF)

XAML 語法術語

參考

x:Code XAML 指示詞項目