Comentários

FileOpenPicker Classe

  • Referência

Definição

Namespace:
Windows.Storage.Pickers
Editar

Representa um elemento de interface do usuário que permite que o usuário escolha e abra arquivos.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma forma que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

public ref class FileOpenPicker sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileOpenPicker final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class FileOpenPicker final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FileOpenPicker final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileOpenPicker
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class FileOpenPicker
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class FileOpenPicker
function FileOpenPicker()
Public NotInheritable Class FileOpenPicker
Herança
Object IInspectable FileOpenPicker
Atributos
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo do seletor de arquivos demonstra como verificar se o aplicativo foi encaixado, como definir as propriedades do seletor de arquivos e como mostrar um seletor de arquivos para que o usuário possa escolher um arquivo.

FileOpenPicker openPicker = new FileOpenPicker();
openPicker.ViewMode = PickerViewMode.Thumbnail;
openPicker.SuggestedStartLocation = PickerLocationId.PicturesLibrary;
openPicker.FileTypeFilter.Add(".jpg");
openPicker.FileTypeFilter.Add(".jpeg");
openPicker.FileTypeFilter.Add(".png");

StorageFile file = await openPicker.PickSingleFileAsync();
if (file != null)
{
    // Application now has read/write access to the picked file
    OutputTextBlock.Text = "Picked photo: " + file.Name;
}
else
{
    OutputTextBlock.Text = "Operation cancelled.";
}

// Create the picker object and set options
var openPicker = new Windows.Storage.Pickers.FileOpenPicker();
openPicker.viewMode = Windows.Storage.Pickers.PickerViewMode.thumbnail;
openPicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.picturesLibrary;
// Users expect to have a filtered view of their folders depending on the scenario.
// For example, when choosing a documents folder, restrict the filetypes to documents for your application.
openPicker.fileTypeFilter.replaceAll([".png", ".jpg", ".jpeg"]);

// Open the picker for the user to pick a file
openPicker.pickSingleFileAsync().then(function (file) {
    if (file) {
        // Application now has read/write access to the picked file
        WinJS.log && WinJS.log("Picked photo: " + file.name, "sample", "status");
    } else {
        // The picker was dismissed with no selected file
        WinJS.log && WinJS.log("Operation cancelled.", "sample", "status");
    }
});

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;
}

Observação

Você sempre deve verificar se o aplicativo não está encaixado (ou se ele pode ser desmarcado) e definir as propriedades do seletor de arquivos, independentemente de o usuário estar escolhendo um único arquivo ou vários arquivos.

IReadOnlyList<StorageFile> files = await openPicker.PickMultipleFilesAsync();
if (files.Count > 0)
{
    StringBuilder output = new StringBuilder("Picked files:\n");
    // Application now has read/write access to the picked file(s)
    foreach (StorageFile file in files)
    {
        output.Append(file.Name + "\n");
    }
    OutputTextBlock.Text = output.ToString();
}
else
{
    OutputTextBlock.Text = "Operation cancelled.";
}

openPicker.pickMultipleFilesAsync().then(function (files) {
    if (files.size > 0) {
        // Application now has read/write access to the picked file(s)
        var outputString = "Picked files:\n";
        for (var i = 0; i < files.size; i++) {
            outputString = outputString + files[i].name + "\n";
        }
        WinJS.log && WinJS.log(outputString, "sample", "status");
    } else {
        // The picker was dismissed with no selected file
        WinJS.log && WinJS.log("Operation cancelled.", "sample", "status");
    }
});

Comentários

Para começar a acessar o seletor de arquivos de arquivos e pastas, consulte Início Rápido: Acessando arquivos com seletores de arquivos.

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1903 18362 CreateForUser
1903 18362 Usuário

Construtores

FileOpenPicker()

Cria uma nova instância de um FileOpenPicker.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma forma que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

Propriedades

CommitButtonText

Obtém ou define o texto do rótulo do botão de confirmação do seletor de abertura de arquivo.
ContinuationData

Obtém um conjunto de valores a serem preenchidos pelo aplicativo antes PickSingleFileAndContinue ou PickMultipleFilesAndContinue operação que desativa o aplicativo para fornecer contexto quando o aplicativo é ativado. (Windows Phone aplicativo 8.x)
FileTypeFilter

Obtém a coleção de tipos de arquivo que o seletor aberto do arquivo exibe.
SettingsIdentifier

Obtém ou define o identificador de configurações associado ao estado do seletor aberto do arquivo.
SuggestedStartLocation

Obtém ou define o local inicial em que o seletor aberto de arquivos procura arquivos para apresentar ao usuário.
User

Obtém informações sobre o usuário para o qual o FileOpenPicker foi criado. Use essa propriedade para aplicativos multiusuários.
ViewMode

Obtém ou define o modo de exibição que o seletor de abertura de arquivo usa para exibir itens.

Métodos

CreateForUser(User)

Cria um FileOpenPicker escopo para o diretório pessoal do usuário especificado. Use esse método para aplicativos multiusuários.
PickMultipleFilesAndContinue()

Obsoleto a partir de Windows 10; use PickSingleFolderAsync. Mostra o seletor de arquivos para que o usuário possa escolher vários arquivos, desativando e o aplicativo e reativando-o quando a operação for concluída. (Windows Phone aplicativo 8.x)
PickMultipleFilesAsync()

Mostra o seletor de arquivos para que o usuário possa escolher vários arquivos. (Aplicativo UWP)
PickSingleFileAndContinue()

Mostra o seletor de arquivos para que o usuário possa escolher um arquivo, potencialmente desativando o aplicativo e reativando-o quando a operação for concluída. (Windows Phone aplicativo 8.x)
PickSingleFileAsync()

Mostra o seletor de arquivos para que o usuário possa escolher um arquivo.
PickSingleFileAsync(String)

Mostra o seletor de arquivos para que o usuário possa escolher um arquivo.
ResumePickSingleFileAsync()

Retoma a operação de seleção para recuperar o arquivo selecionado pelo usuário se o usuário navegar para longe do aplicativo depois que a operação do seletor for concluída e o aplicativo estiver suspenso.

Aplica-se a

Confira também