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最基础的支持。