导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

FileOpenPicker Class

表示允许用户选择和打开文件的 UI 元素。

语法


Public NotInheritable Class FileOpenPicker

特性

[Muse()]
[Version(0x06020000)]

成员

FileOpenPicker类 具有这些类型的成员:

构造函数

FileOpenPicker类 具有这些构造函数。

构造函数说明
FileOpenPicker Creates a new instance of a FileOpenPicker.

 

方法

The FileOpenPicker 类 具有这些方法。 对于 C#、Visual Basic 和 C++,它还继承方法于Object 类.

方法说明
PickMultipleFilesAsync Shows the file picker so that the user can pick multiple files.
PickSingleFileAsync Shows the file picker so that the user can pick one file.

 

属性

FileOpenPicker类 具有这些属性。

属性访问类型说明

CommitButtonText

读/写Gets or sets the label text of the file open picker's commit button.

FileTypeFilter

只读Gets the collection of file types that the file open picker displays.

SettingsIdentifier

读/写Gets or sets the settings identifier associated with the state of the file open picker.

SuggestedStartLocation

读/写Gets or sets the initial location where the file open picker looks for files to present to the user.

ViewMode

读/写Gets or sets the view mode that the file open picker uses to display items.

 

备注

要开始访问文件和文件夹文件选择器,请参见快速入门:使用文件选择器访问文件

重要事项  在 Windows 8 中,当应用程序已对齐时如果尝试显示文件选择器,文件选择器不会显示,并会引发异常。可以通过确保应用程序未对齐或在调用文件选择器之前展开来避免。 下面的代码示例和文件选择器会为您显示方法。请注意,Windows 8.1 不定义特定的已对齐窗口大小。相反,用户可以将应用程序调整到任何宽度,直到最小值。因此,如果你的应用程序只会部署到 Windows 8.1 上,则你可以忽略本主题示例代码中的 EnsureUnsnapped 函数和对它的调用。

Windows Phone 8

只有本机应用程序支持此 API。

示例

文件选择器示例演示如何检查应用程序是否已对齐,如何设置文件选择器属性以及如何显示文件选择器,以便用户可以选择某个文件。

目前没有可用的代码示例或不支持该语言。

对于 C#,文件选择器示例演示如何检查您的应用程序是否在 EnsureUnsnapped 方法对齐。


internal bool EnsureUnsnapped()
{
    // FilePicker APIs will not work if the application is in a snapped state.
    // If an app wants to show a FilePicker while snapped, it must attempt to unsnap first
    bool unsnapped = ((ApplicationView.Value != ApplicationViewState.Snapped) || ApplicationView.TryUnsnap());
    if (!unsnapped)
    {
        NotifyUser("Cannot unsnap the sample.", NotifyType.StatusMessage);
    }

    return unsnapped;
}


文件选择器示例还演示了如何显示一个文件选择器,使用户可以选择多个文件。

注意  应始终确保应用程序未对齐(或可将它展开)并且无论用户选择是单个文件或多个文件设置文件选择器属性。

目前没有可用的代码示例或不支持该语言。

你还可以在 Windows Phone 上使用文件选择器。下面显示一个 C++ 示例。在 Windows Phone 中,FileOpenPicker 仅在本机应用程序中受支持。


FileOpenPicker^ openPicker = ref new FileOpenPicker(); 
openPicker->ViewMode = PickerViewMode::Thumbnail; 
openPicker->SuggestedStartLocation = PickerLocationId::PicturesLibrary; 
openPicker->FileTypeFilter->Append("*"); 
   
create_task(openPicker->PickSingleFileAsync()).then([this](StorageFile^ file) 
{
    if (file) 
    { 
        m_PickedFileName = file->Name; 
    } 
    else 
    { 
        // Operation cancelled.
    } 
});


要求

最低支持客户端

Windows 8 [仅 Windows 应用商店应用程序]

最低支持服务器

Windows Server 2012 [仅 Windows 应用商店应用程序]

最低支持电话

Windows Phone 8

命名空间

Windows.Storage.Pickers
Windows::Storage::Pickers [C++]

元数据

Windows.winmd

另请参见

文件选择器示例
快速入门:通过文件选择器访问文件

 

 

显示:
© 2014 Microsoft