Out of Browser存取本地文件系统

在前文,我们讲述了Silverlight Out of Browser的基础以及自定义模式应用。本篇,我们将讲述Silverlight Out of Browser应用的重点 - 创建可信任应用,也称为Trusted Application. 早在Silverlight 3,Silverlight Out of Browser的功能由于权限的限制无法很好的满足用户的正常存取需求,仅能实现将Web应用脱离浏览器。而在Silverlight 4中,通过提升应用信任权限,大大增强了Silverlight Out of Browser的功能,在权限允许的情况下,用户可以自由有访问本地目录,也可以执行本地应用程序,另外通过调用COM组件,实现更多更强大的本地应用操作。下面我们将实例讲述Silverlight Out of Browser可信任应用 - 存取本地文件系统。

本篇中,我们将基于上篇教程提供的项目SilverlightOOBDemo进行演示操作。

首先需要确认SilverlightOOBDemo项目允许用户提升应用信任权限。这样,OOB应用将被允许访问用户本地资源。

Silverlight 4对于本地文件夹的存取,并非代表存取所有本地磁盘目录,目前为止,Silverlight 4 API仅支持存取“我的文档”,“我的音乐”,“我的图片”和“我的视频”目录以及“Program Files”和“Cookies”目录,而如果想对所有磁盘目录进行访问,则需要使用COM功能进行操作,我们将在下篇讲述,本篇将着重讲述Silverlight 4 API对“我的”系列目录的操作方法。

在实现具体功能前,首先需要为项目添加两个新文件,

一个是资源文件Resources.xaml,该资源文件引用自开源控件BlackLight资源样式,主要目的是为了创建新按钮演示效果,如下图:

另一个是小图片控件ThumbImage.xaml,该文件是用于载入“我的图片”目录后的图片略缩图,其代码较为简单,

  <UserControl x:Class="SilverlightOOBDemo.ThumbImage"  
      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
      xmlns:d="http://schemas.microsoft.com/expression/blend/2008"  
      xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"  
      mc:Ignorable="d"  
      d:DesignHeight="300" d:DesignWidth="400">  
     <Grid x:Name="LayoutRoot" Margin="10">  
         <Image x:Name="ThumbnailImage" Height="145" Width="225" />  
     </Grid>  
 </UserControl>
  namespace SilverlightOOBDemo  
  {  
      public partial class ThumbImage : UserControl  
      {  
          private Image _OriginalImage;  
          public Image OriginalImage   
          {   
              get   
              {  
                 return _OriginalImage;   
             }   
             set   
             {  
                 this._OriginalImage = value;  
                 ThumbnailImage.Source = new WriteableBitmap(_OriginalImage, null);   
             }   
         }  
         public ThumbImage()  
         {  
             InitializeComponent();  
         }  
     }  
 }

为了能够激活存取事件,我们需要在OutofBrowserMainpage主窗口页面添加按钮控件,其样式调用自资源文件Resources.xaml,对于资源样式调用,这里不再赘述,如果不明白的,请看“Expression Blend实例中文教程系列文章

  <StackPanel x:Name="toolbar" Background="#FF3A3A3A" Grid.ColumnSpan="2" Orientation="Horizontal" Margin="0,0,0,1" Grid.Row="0" >  
                          <Border BorderBrush="{StaticResource GlossyBlack_StrokeGradient}" BorderThickness="1" CornerRadius="2" Margin="1" Padding="0,1,1,1">  
                              <StackPanel>  
                                  <StackPanel Orientation="Horizontal">  
                                      <Button Width="56" Height="80" Style="{StaticResource BlackGlossyButton}" Margin="1,0,0,0" Foreground="White" x:Name="openFileBtn" Click="openFileBtn_Click">                                          <Button.Content>  
                                              <StackPanel>  
                                                  <Image VerticalAlignment="Top" HorizontalAlignment="Center" Source="/SilverlightOOBDemo;component/Images/Open.png" Margin="0,-5,0,0" Stretch="None" />  
                                                  <TextBlock VerticalAlignment="Bottom" HorizontalAlignment="Center" Margin="0,3,0,0" Text="浏览" TextWrapping="Wrap"/>  
                                             </StackPanel>  
                                         </Button.Content>  
                                     </Button>  
                                 </StackPanel>  
                             </StackPanel>  
                         </Border>  
                         <Border BorderBrush="{StaticResource GlossyBlack_StrokeGradient}" BorderThickness="1" CornerRadius="2" Margin="1" Padding="0,1,1,1">  
                             <StackPanel>  
                                 <StackPanel Orientation="Horizontal">  
                                     <Button IsTabStop="False" Width="56" Height="80" Style="{StaticResource BlackGlossyButton}" Margin="1,0,0,0" Foreground="White"  x:Name="aboutBtn" Click="">  
                                         <Button.Content>  
                                             <StackPanel>  
                                                 <TextBlock VerticalAlignment="Top" HorizontalAlignment="Center" Text="?" FontSize="20" FontWeight="Bold" Foreground="DarkCyan"  Margin="0,-5,0,0" />  
                                                 <TextBlock VerticalAlignment="Bottom" HorizontalAlignment="Center" Margin="0,3,0,0" Text="帮助" TextWrapping="Wrap"/>  
                                            </StackPanel>  
                                         </Button.Content>  
                                     </Button>  
                                 </StackPanel>  
                             </StackPanel>  
                        </Border>  
                     </StackPanel>

同时,为了能够载入本地“我的图片”目录中的图片文件,我们需要在OutofBrowserMainpage中使用一个ListBox控件,载入上面我们创建的ThumbImage控件来显示,所有图片略缩图列表,

 <ListBox Grid.Column="0"  x:Name="lsMyPictures" SelectionMode="Single" Style="{StaticResource GlossyBlackListBox}" ItemContainerStyle="{StaticResource ListBoxItemStyle}" BorderBrush="Transparent" Background="Transparent" ScrollViewer.HorizontalScrollBarVisibility="Auto" ScrollViewer.VerticalScrollBarVisibility="Auto" Margin="3,10,0,30" ></ListBox>  

现在,我们可以为openfilebtn按钮控件创建事件,使其响应用户操作,打开对应目录进行文件浏览

          private void openFileBtn_Click(object sender, RoutedEventArgs e)  
          {  
              if (Application.Current.HasElevatedPermissions)  
              {  
                  var imageFiles = Directory.EnumerateFiles(Environment.GetFolderPath(Environment.SpecialFolder.MyPictures), "*.jpg", SearchOption.AllDirectories);  
                  foreach (var imagePath in imageFiles)  
                  {  
                      AddImageToList(new FileInfo(imagePath));  
                  }  
             }  
         }

在上面代码中,如果用户已经提升了OOB应用权限(Application.Current.HasElevatedPermissions),将通过Environment中的GetFolderPath方法获取到本地“My..”目录下的文件,其中Environment.SpecialFolder可以设定特殊目录。更多详细,请看MSDN解释

在上面代码中,有一个方法AddImageToList,将文件路径信息读取,然后将图片文件信息进行绑定到ListBox。

          private void AddImageToList(FileInfo fileinfo)  
          {  
              FileStream fileStream = fileinfo.OpenRead();  
              Image img = new Image();  
              BitmapImage bi = new BitmapImage();  
              bi.SetSource(fileStream);  
              img.Margin = new Thickness(5d);  
              img.Stretch = Stretch.UniformToFill;  
              img.Source = bi;  
             try { img.Tag = fileinfo.FullName; }  
             catch { }  
             ThumbImage thumbnail = new ThumbImage();  
             thumbnail.OriginalImage = img;  
             lsMyPictures.Items.Add(thumbnail);  
         }

在读取“我的图片”目录信息后,将各个图片载入到ThumbImage控件中,然后使用ListBox承载各个图片,这样也就完成了OOB应用对本地目录的浏览。其效果如下:

通过以上的代码,我们可以快速修改,浏览“我的文档”,“我的音乐”和“我的视频”等目录;在OutofBrowserMainPage页面添加代码:

<ListBox Grid.Column="1"  x:Name="lsMyDocuments" SelectionMode="Single" Style="{StaticResource GlossyBlackListBox}" ItemContainerStyle="{StaticResource ListBoxItemStyle}" BorderBrush="Transparent" Background="Transparent" ScrollViewer.HorizontalScrollBarVisibility="Auto" ScrollViewer.VerticalScrollBarVisibility="Auto" Margin="3,10,0,30" ></ListBox>
 private void AddDocToList()  
         {  
             var path = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);               lsMyDocuments.ItemsSource = System.IO.Directory.EnumerateFiles(path);  
         }

然后在openFileBtn_Click事件中调用AddDocToList();即可获取到“我的文档”文件列表, 其他目录与其类似,就不再做代码演示,大家可以自己尝试,如果遇到问题,我们可以一起讨论 。

看到这里,有的朋友可能会问,既然已经可以实现浏览本地目录功能,是不是也应该可以对本地目录文件进行操作呢?答案是肯定的。当OOB应用获取到权限提升后,则可以使用File类对文件进行操作,例如,移动文件,删除文件等。对目前的项目我们进行简单的修改,演示如何将“我的文档”目录的文件,移动到“我的音乐”目录中,并且删除源目录的相同文件,

首先在OutofBrowserMainPage.xaml页面添加一个新的ListBox,承载“我的音乐”目录文件;

 <StackPanel Orientation="Vertical" Width="200">  
                                     <TextBlock Text="我的音乐" Foreground="White" VerticalAlignment="Center" HorizontalAlignment="Center"/>  
                                     <ListBox x:Name="lsMyMusics" SelectionMode="Single" Style="{StaticResource GlossyBlackListBox}" ItemContainerStyle="{StaticResource ListBoxItemStyle}" BorderBrush="Transparent" Background="Transparent" ScrollViewer.HorizontalScrollBarVisibility="Auto" ScrollViewer.VerticalScrollBarVisibility="Auto" Margin="3,10,0,30"></ListBox>  
                                 </StackPanel>

在后台代码添加,浏览载入“我的音乐”目录;

  private void AddMusicToList()  
          {  
              var path = Environment.GetFolderPath(Environment.SpecialFolder.MyMusic);  
              lsMyMusics.Items.Clear();  
              DirectoryInfo myDirectory = new DirectoryInfo(path);  
              foreach (FileInfo file in myDirectory.EnumerateFiles())  
              {  
                  lsMyMusics.Items.Add(file);  
              }  
         }

简单修改“我的文档”ListBox代码,和后台代码:

 <StackPanel Orientation="Vertical" Width="200">  
                                     <TextBlock Text="我的文档" Foreground="White" VerticalAlignment="Center" HorizontalAlignment="Center"/>  
                                     <ListBox x:Name="lsMyDocuments" SelectionMode="Single" Style="{StaticResource GlossyBlackListBox}" ItemContainerStyle="{StaticResource ListBoxItemStyle}" BorderBrush="Transparent" Background="Transparent" ScrollViewer.HorizontalScrollBarVisibility="Auto" ScrollViewer.VerticalScrollBarVisibility="Auto" Margin="3,10,0,30"></ListBox>                                   </StackPanel>
  private void AddDocToList()  
          {  
              var path = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);  
              lsMyDocuments.Items.Clear();  
              DirectoryInfo myDirectory = new DirectoryInfo(path);  
              foreach (FileInfo file in myDirectory.EnumerateFiles())  
              {  
                  lsMyDocuments.Items.Add(file);  
              }  
             //lsMyDocuments.ItemsSource = System.IO.Directory.EnumerateFiles(path);  
         }

运行后即可得到如下效果:

下面我们想实现,点击按钮事件后,将“我的文档”目录中的选中文件,移动到“我的音乐”目录中,

首先,在应用的ToolBar中添加一个移动按钮moveFileBtn

实现moveFileBtn被点击后,移动文件到“我的音乐”目录,

  private void moveFileBtn_Click(object sender, RoutedEventArgs e)  
          {  
              FileInfo selectedFile = (FileInfo)lsMyDocuments.SelectedValue;  
              string path = Environment.GetFolderPath(Environment.SpecialFolder.MyMusic);  
              string formatPath = string.Format("{0}//{1}", path, selectedFile.Name);  
              if (!File.Exists(formatPath))  
              {  
                  File.Move(selectedFile.FullName, formatPath);  
                  File.Delete(selectedFile.FullName);  
             }  
             LoadFiles();  
         }  
         private void LoadFiles()  
         {  
             AddDocToList();  
             AddMusicToList();  
         }

这里我们用的是最基本的File文件类操作文件的移动和删除,当然,这需要OOB应用被提升信任权限后,才可以操作,否则,将提示权限错误。

这样,我们就可以查看演示了,当运行应用后,“我的文档”和“我的音乐”两个目录将被载入文件列表,选中“我的文档”中任一文件,然后点击“移动”按钮,就会发现该文件被移动到“我的音乐”目录中,而在“我的文档”中的源文件已经被删除。

通过上文,我们可以了解到Silverlight Out of Browser的可信任应用对本地目录和文件的操作方法以及基本API的用法,下一篇,我们将通过另外一个实例演示更多Out of Browser的可信任应用的强大功能。

注:本篇部分代码是参考Silverlight开源项目。

本篇源代码下载

欢迎大家加入"专注Silverlight" 技术讨论群:

32679955(六群)

23413513(五群)

32679922(四群)

100844510(三群)

37891947(二群)

22308706(一群)

文章导航