Windows Phone 8.1 FilePicker API

在 Windows Phone 8.1 中，增加了 FilePicker 的方式与文件打交道，最大的亮点在于这种方式不仅可以浏览手机上的文件，还可以浏览符合协议的应用里的文件！

比如点击 OneDrive 就会打开 OneDrive 应用：

（1）FileOpenPicker

FileOpenPicker 也就是选择文件，可以设置打开单选界面或多选界面。

1）实例化 FileOpenPicker 对象，并设置 ContinuationData

private void openFileButton_Click(object sender, RoutedEventArgs e)

{

    FileOpenPicker imageOpenPicker = new FileOpenPicker();

    imageOpenPicker.FileTypeFilter.Add(".jpg");

    imageOpenPicker.FileTypeFilter.Add(".png");
    
    imageOpenPicker.SuggestedStartLocation = PickerLocationId.PicturesLibrary;

    imageOpenPicker.ContinuationData["Operate"] = "OpenImage";

    imageOpenPicker.PickSingleFileAndContinue();

}

FileOpenPicker 可以设置 FileTypeFilter，方便文件的浏览；还可以设置选择界面的开始目录（SuggestedStartLocation）。

因为在打开选择文件的界面后当前应用会挂起，所以需要 ContinuationData 来记录一些信息，以保证当应用恢复时能够保持之前的信息。

2）重写 App.xaml.cs 的 OnActivated 方法

当用户选择了文件之后会返回到之前的应用，这时需要重写 OnActivated 方法让应用跳转到指定页面，并传递用户选择的文件。

protected override void OnActivated(IActivatedEventArgs args)

{

    if( args is FileOpenPickerContinuationEventArgs )

    {

        Frame rootFrame = Window.Current.Content as Frame;

        if( rootFrame == null )

        {

            rootFrame = new Frame();

            rootFrame.CacheSize = ;

            Window.Current.Content = rootFrame;

        }

        if( rootFrame.Content == null )

        {

            if( rootFrame.ContentTransitions != null )

            {

                this.transitions = new TransitionCollection();

                foreach( var c in rootFrame.ContentTransitions )

                {

                    this.transitions.Add(c);

                }

            }

            rootFrame.ContentTransitions = null;

            rootFrame.Navigated += this.RootFrame_FirstNavigated;

            if( !rootFrame.Navigate(typeof(MainPage)) )

            {

                throw new Exception("Failed to create first page");

            }

        }

        if( !rootFrame.Navigate(typeof(MainPage)) )

        {

            throw new Exception("Failed to create target page");

        }

        MainPage targetPage = rootFrame.Content as MainPage;

        targetPage.FilePickerEventArgs = (FileOpenPickerContinuationEventArgs)args;

        Window.Current.Activate();

    }

}

首先是要判断之前的行为是不是 FileOpenPicker 引起的，然后获取 Frame 并跳转到指定页面，将包含用户选择文件的信息 args 传递到指定页面中。

3）添加 FileOpenPickerContinuationEventArgs 属性和 ContinuFileOpenPicker 方法

当应用将 args 传递到页面去后，剩下的就是处理文件了：

private FileOpenPickerContinuationEventArgs filePickerEventArgs;

public FileOpenPickerContinuationEventArgs FilePickerEventArgs

{

    get { return filePickerEventArgs; }

    set

    {

        filePickerEventArgs = value;

        ContinuFileOpenPicker(filePickerEventArgs);

    }

}

private async void ContinuFileOpenPicker(FileOpenPickerContinuationEventArgs args)

{

    if( args.ContinuationData["Operate"] as string == "OpenImage" && args.Files != null && args.Files.Count >  )

    {

        StorageFile file = args.Files[];

        BitmapImage image = new BitmapImage();

        await image.SetSourceAsync(await file.OpenAsync(FileAccessMode.Read));

        myImage.Source = image;

    }

}

（2）AccessCache

AccessCache 也就是指对用户选择文件或文件夹的缓存，包括 MostRecentlyUsedList 和 FutureAccessList。

MostRecentlyUsedList 可以保存 25 项，并会根据用户使用情况自动排序，当新的进来后超过 25 项了则会自动将最旧的删除。

FutureAccessList 则可以保存 1000 项，但不会自动排序，需要开发者自行管理。

保存方法：

private async void ContinuFileOpenPicker(FileOpenPickerContinuationEventArgs args)

{

    if( args.ContinuationData["Image"] as string == "OpenImage" && args.Files != null && args.Files.Count >  )

    {

        StorageFile file = args.Files[];

        BitmapImage image = new BitmapImage();

        await image.SetSourceAsync(await file.OpenAsync(FileAccessMode.Read));

        myImage.Source = image;

        StorageApplicationPermissions.MostRecentlyUsedList.Add(file, "");

        StorageApplicationPermissions.FutureAccessList.Add(file, "");

    }

}

读取方法：

private async void NavigationHelper_LoadState(object sender, LoadStateEventArgs e)

{

    var mruList = StorageApplicationPermissions.MostRecentlyUsedList.Entries;

foreach( var item in mruList )

    {

        StorageFile file = await StorageApplicationPermissions.MostRecentlyUsedList.GetFileAsync(item.Token);

        BitmapImage image = new BitmapImage();

        await image.SetSourceAsync(await file.OpenAsync(FileAccessMode.Read));

        Image img = new Image();

        img.Source = image;

        img.Stretch = Stretch.Uniform;

        img.Margin = new Thickness(, , , );

        imagesStackPanel.Children.Add(img);

    }

}

开发者可以灵活使用这两个列表，方便用户浏览最近使用过的文件。

（3）FileSavePicker

既然有 OpenPicker，自然就有 SavePicker。

FileSavePicker 的使用方法与 FileOpenPicker 非常相似。

1）实例化 FileSavePicker 对象，并设置 ContinuationData

private void saveButton_Click(object sender, RoutedEventArgs e)

{

    FileSavePicker imageSavePicker = new FileSavePicker();

    imageSavePicker.SuggestedStartLocation = PickerLocationId.DocumentsLibrary;

    imageSavePicker.SuggestedFileName = "Test";

    imageSavePicker.FileTypeChoices.Add("Txt", new List<string>() { ".txt" });

    imageSavePicker.ContinuationData["Txt"] = "SaveTxt";

    imageSavePicker.PickSaveFileAndContinue();

}

实例化 FileSavePicker 对象后，设置 FileName 和 FileType。

当用户选择了某个文件夹后，系统就会在该文件夹中新建一个该 FileName 和 FileType 的文件，并将该文件放到 FileSavePickerContinuationEventArgs 中。

2）重写 App.xaml.cs 的 OnActivated 方法

与 FileOpenPicker 一样，同样需要重写 OnActivated 方法，这次要检查的 args 类型为 FileSavePickerContinuationEventArgs：

protected override void OnActivated(IActivatedEventArgs args)

{

    if( args is FileSavePickerContinuationEventArgs )

    {

        Frame rootFrame = Window.Current.Content as Frame;

        // 不要在窗口已包含内容时重复应用程序初始化，

        // 只需确保窗口处于活动状态

        if( rootFrame == null )

        {

            // 创建要充当导航上下文的框架，并导航到第一页

            rootFrame = new Frame();

            // TODO: 将此值更改为适合您的应用程序的缓存大小

            rootFrame.CacheSize = ;

            if( args.PreviousExecutionState == ApplicationExecutionState.Terminated )

            {

                // TODO: 从之前挂起的应用程序加载状态

            }

            // 将框架放在当前窗口中

            Window.Current.Content = rootFrame;

        }

        if( rootFrame.Content == null )

        {

            // 删除用于启动的旋转门导航。

            if( rootFrame.ContentTransitions != null )

            {

                this.transitions = new TransitionCollection();

                foreach( var c in rootFrame.ContentTransitions )

                {

                    this.transitions.Add(c);

                }

            }

            rootFrame.ContentTransitions = null;

            rootFrame.Navigated += this.RootFrame_FirstNavigated;

            // 当导航堆栈尚未还原时，导航到第一页，

            // 并通过将所需信息作为导航参数传入来配置

            // 新页面

            if( !rootFrame.Navigate(typeof(MainPage)) )

            {

                throw new Exception("Failed to create initial page");

            }

        }

        if( !rootFrame.Navigate(typeof(MainPage)) )

        {

            throw new Exception("Failed to create target page");

        }

        MainPage targetPage = rootFrame.Content as MainPage;

        targetPage.SavePickerArgs = (FileSavePickerContinuationEventArgs)args;

        // 确保当前窗口处于活动状态

        Window.Current.Activate();

    }

}

OnActivated

3）添加 FileSavePickerContinuationEventArgs 属性和 ContinuFileSavePicker 方法

最后在 ContinuFileSavePicker 方法中对要保存的文件进行操作：

private FileSavePickerContinuationEventArgs savePickerArgs;

public FileSavePickerContinuationEventArgs SavePickerArgs

{

    get { return savePickerArgs; }

    set

    {

        savePickerArgs = value;

        ContinuFileSavePicker(savePickerArgs);

    }

}

private async void ContinuFileSavePicker(FileSavePickerContinuationEventArgs args)

{

    if( args.ContinuationData["Txt"] as string == "SaveTxt" && args.File != null )

    {

        StorageFile txt = args.File;

await FileIO.WriteTextAsync(txt, "");

    }

}

巴特西

Windows Phone 8.1 FilePicker API

最新文章

热门文章