Prism框架入门与应用
1. 环境搭建
首先通过NuGet安装包`Prism.DryIoc`。
在App.xaml中引用Prism命名空间,将项目应用对象替换为`PrismApplication`,并移除`StartupUri`。
<prism:PrismApplication x:Class="MyApp.App"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="clr-namespace:MyApp"
xmlns:prism="http://prismlibrary.com/">
</prism:PrismApplication>
修改App.xaml.cs文件,继承自`PrismApplication`并实现相关方法。
public partial class App : PrismApplication
{
protected override Window CreateShell()
{
return Container.Resolve<MainWindow>();
}
protected override void RegisterTypes(IContainerRegistry registry)
{
}
}
为了实现动态绑定,需满足以下条件:
- 视图应放置在Views文件夹下。
- 视图模型应放置在ViewModels文件夹下。
- 视图模型的命名规则应以视图名称开头,并以ViewModel结尾。
- 设置自动绑定属性:`prism:ViewModelLocator.AutoWireViewModel="True"`。
2. 区域化功能
通过区域化功能,可以实现在同一窗口内切换不同的用户控件。
在主窗口添加一个`ContentControl`作为区域容器。
<Window x:Class="MyApp.Views.MainWindow">
<Grid>
<Grid.RowDefinitions>
<RowDefinition Height="50"/>
<RowDefinition/>
</Grid.RowDefinitions>
<StackPanel Orientation="Horizontal">
<Button Command="{Binding LoadCommand}" CommandParameter="UserControlA" Content="加载模块A" Margin="5"/>
</StackPanel>
<ContentControl Grid.Row="1" prism:RegionManager.RegionName="MainRegion"/>
</Grid>
</Window>
创建一个新的用户控件`UserControlA`。
<UserControl x:Class="MyApp.Views.UserControlA">
<Grid>
<TextBlock Text="这是模块A" FontSize="30"/>
</Grid>
</UserControl>
在App.xaml.cs中注册该用户控件。
protected override void RegisterTypes(IContainerRegistry registry)
{
registry.RegisterForNavigation<UserControlA>();
}
在视图模型中使用`RegionManager`进行导航。
public class MainWindowViewModel : BindableBase
{
private readonly IRegionManager regionManager;
public DelegateCommand<string> LoadCommand { get; private set; }
public MainWindowViewModel(IRegionManager regionManager)
{
this.regionManager = regionManager;
LoadCommand = new DelegateCommand<string>(LoadModule);
}
private void LoadModule(string moduleName)
{
regionManager.Regions["MainRegion"].RequestNavigate(moduleName);
}
}
3. 模块化开发
模块化允许将不同功能划分为独立的模块。以下是实现步骤:
- 新建一个类库项目作为模块。
- 在模块项目中创建一个用户控件`ModuleView`。
- 实现`IModule`接口,完成模块注册。
public class ModuleProfile : IModule
{
public void OnInitialized(IContainerProvider provider)
{
}
public void RegisterTypes(IContainerRegistry registry)
{
registry.RegisterForNavigation<ModuleView, ModuleViewModel>();
}
}
在主程序中管理模块:
protected override IModuleCatalog CreateModuleCatalog()
{
return new DirectoryModuleCatalog() { ModulePath = @".\Modules" };
}
4. 导航功能
Prism支持页面间的导航,包括参数传递、日志记录等功能。
通过`NavigationParameters`传递参数。
private void NavigateTo(string target)
{
NavigationParameters parameters = new NavigationParameters();
parameters.Add("Message", "Hello from Main");
regionManager.Regions["MainRegion"].RequestNavigate(target, parameters);
}
在目标视图模型中处理参数。
public class ModuleViewModel : BindableBase, INavigationAware
{
public string Message { get; set; }
public void OnNavigatedTo(NavigationContext context)
{
if (context.Parameters.ContainsKey("Message"))
Message = context.Parameters.GetValue<string>("Message");
}
public bool IsNavigationTarget(NavigationContext context) => true;
public void OnNavigatedFrom(NavigationContext context)
{
}
}
5. 对话框服务
通过`IDialogService`实现对话框功能。
public class MainWindowViewModel : BindableBase
{
private readonly IDialogService dialogService;
public MainWindowViewModel(IDialogService dialogService)
{
this.dialogService = dialogService;
}
public void ShowDialog()
{
DialogParameters parameters = new DialogParameters();
parameters.Add("Title", "提示");
dialogService.ShowDialog(nameof(DialogView), parameters, result =>
{
if (result.Result == ButtonResult.OK)
string value = result.Parameters.GetValue<string>("ReturnValue");
});
}
}
定义对话框组件并实现`IDialogAware`接口。
public class DialogViewModel : BindableBase, IDialogAware
{
public string Title { get; set; }
public event Action<IDialogResult> RequestClose;
public void OnDialogOpened(IDialogParameters parameters)
{
Title = parameters.GetValue<string>("Title");
}
public bool CanCloseDialog() => true;
public void OnDialogClosed()
{
DialogParameters results = new DialogParameters();
results.Add("ReturnValue", "关闭成功");
RequestClose?.Invoke(new DialogResult(ButtonResult.OK, results));
}
}
注册对话框组件。
protected override void RegisterTypes(IContainerRegistry registry)
{
registry.RegisterDialog<DialogView, DialogViewModel>();
}
6. 发布订阅模式
通过事件聚合器实现跨模块通信。
public class EventMessage : PubSubEvent<string>
{
}
public class PublisherViewModel : BindableBase
{
private readonly IEventAggregator aggregator;
public PublisherViewModel(IEventAggregator aggregator)
{
this.aggregator = aggregator;
}
public void PublishMessage()
{
aggregator.GetEvent<EventMessage>().Publish("Test Message");
}
}
public class SubscriberViewModel : BindableBase
{
private readonly IEventAggregator aggregator;
public SubscriberViewModel(IEventAggregator aggregator)
{
this.aggregator = aggregator;
aggregator.GetEvent<EventMessage>().Subscribe(HandleMessage);
}
private void HandleMessage(string message)
{
MessageBox.Show($"Received: {message}");
}
}