Caliburn.Micro 傑的入門教程1（翻譯）

Caliburn.Micro 傑的入門教程1（原創翻譯）
Caliburn.Micro 傑的入門教程2 ，了解Data Binding 和 Events（翻譯）
Caliburn.Micro 傑的入門教程3，事件和參數
Caliburn.Micro 傑的入門教程4，事件聚合器
Caliburn.Micro 傑的入門教程5，窗口管理器
Caliburn.Micro 傑的入門教程6， Screens 和 Conductors 簡介

---

 Caliburn.Micro項目地址：

http://caliburnmicro.codeplex.com （舊）

https://github.com/Caliburn-Micro/Caliburn.Micro

【原文地址】Mindscape's Getting Started Tutorial
http://www.mindscapehq.com/blog/index.php/2012/01/12/caliburn-micro-part-1-getting-started/

---

 備注：

Bootstrapper相關類和實現方式，在新版本有調整，繼承BootstrapperBase基類，並在構造方法調用InitializeComponent()，新版本教程文檔，請移步此處查看我后來翻譯的文章。

Caliburn Micro Part 1: Getting Started

---

Step 1: Getting Started

Caliburn Micro 建立於 .NET framework 4.0 之上，所以需要在Visual Studio 2010中（或更高）創建應用程序，先要創建一個新的WPF應用程序並添加引用：【 Caliburn.Micro.dll 和 System.Windows.Interactivity.dll】，您可以從Caliburn Micro項目找到下載。

如果使用的是Visual Studio，推薦做法是使用Nuget安裝Caliburn.Micro相關的包，如【Caliburn.Micro.Start】

在新建的WPF項目中，刪除MainWindow.xaml項目文件。（也就是新建項目自帶的主窗口）
在App.xaml項目文件中，刪除 StartupUri 節點特性，如下：

<Application x:Class="CaliburnMicroApp.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <Application.Resources>
 
  </Application.Resources>
</Application>

此步驟是為了將初始化窗口重建，准備指向Caliburn Micro，而不是WPF自定義的，后面會有轉移指向的步驟。

Step 2: The View Model

 Caliburn Micro優化了View-Model-First方式，下一步就是添加一個類來表示視圖模型了。大型應用程序可以有多個視圖模型,每一種都可以有不同的邏輯視圖。 下面是一個空視圖模型的代碼示例。 本教程是專注於簡單的開始將Caliburn Micro納入WPF應用程序中,我們現在暫時不讓視圖模型做什么（保持最簡潔）。

using Caliburn.Micro;
 
namespace CaliburnMicroApp
{
  public class AppViewModel : PropertyChangedBase
  {
 
  }
}

首先要注意的是類的名稱，Caliburn Micro默認有一個特定的命名約定，這樣就可以關聯匹配的視圖和視圖模型。所以，一個視圖模型的類名應該以“ViewModel”結束，當然前面的名字就取決於你了。另一件要注意的是,這個類繼承於PropertyChangedBase。 這是Caliburn Micro提供的,用於自動屬性更改通知,所以我們不需要實現INotifyPropertyChanged。 盡管這個示例視圖模型不做任何事情，我已經繼承PropertyChangedBase並做好實現。 以后當給視圖模型添加屬性，將會派上用場。

Step 3: The View

為了顯示窗口,我們需要創建一個視圖，對應前面步驟中創建的視圖模型。 只需要向項目添加一個新用戶控件,如下所示。 再次指出,Caliburn Micro默認有特定的命名約定,這樣就可以把視圖對應到適當的視圖模型。 視圖名稱應該與“View”結束並且開始部分要和對應的視圖模型使用相同的名稱。 對於我的例子,“AppView”視圖對應“AppViewModel”。 下面的代碼我也設置寬度,高度和網格背景,這樣當您運行這個應用程序您可以看到它是否正常工作。

<UserControl x:Class="CaliburnMicroApp.AppView"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006">
  <Grid Width="300" Height="300" Background="LightBlue">
 
  </Grid>
</UserControl>

Step 4: The Bootstrapper

引導程序的機制用於CaliburnMicro合並到您的應用程序。 它也是讓你可以為應用程序的需要，配置框架的地方。 對於本教程中,我使用了一個非常簡單的引導程序實現所示:

using Caliburn.Micro;
 
namespace CaliburnMicroApp
{
  public class AppBootstrapper : Bootstrapper<AppViewModel>
  {
  }
}

CaliburnMicro有2個不同的bootstrappers可用。 上面使用允許設置你想要在啟動時使用的視圖模型的泛型類型。 最后一步就是告訴應用程序使用引導程序了。 是通過在xaml資源字典中添加你的引導程序做到的。 這樣做之后,xaml會現在看起來是這樣的:

<Application x:Class="CaliburnMicroApp.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:local="clr-namespace:CaliburnMicroApp"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <Application.Resources>
    <ResourceDictionary>
      <ResourceDictionary.MergedDictionaries>
        <ResourceDictionary>
          <local:AppBootstrapper x:Key="bootstrapper" />
        </ResourceDictionary>
      </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
  </Application.Resources>
</Application>

現在,當您運行應用程序時,您將看到一個小窗口,一個淡藍色背景。 您的應用程序現在已經做好了CaliburnMicro最基礎的支持。