Commenti e suggerimenti

FileOpenPicker Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Storage.Pickers
Modifica

Rappresenta un elemento dell'interfaccia utente che consente all'utente di scegliere e aprire file.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare oggetti dell'interfaccia utente WinRT che dipendono da 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
Ereditarietà
Object IInspectable FileOpenPicker
Attributi
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

L'esempio di selezione file illustra come verificare se l'app è ancorata, come impostare le proprietà di selezione file e come visualizzare una selezione file in modo che l'utente possa selezionare un file.

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

Nota

È sempre necessario assicurarsi che l'app non sia ancorata (o che possa essere annullata) e impostare le proprietà di selezione file indipendentemente dal fatto che l'utente selezioni un singolo file o più file.

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

Commenti

Per iniziare ad accedere alla selezione file e cartelle, vedere Guida introduttiva: Accesso ai file con selezione file.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1903 18362 CreateForUser
1903 18362 Utente

Costruttori

FileOpenPicker()

Crea una nuova istanza di un oggetto FileOpenPicker.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

Proprietà

CommitButtonText

Ottiene o imposta il testo dell'etichetta del pulsante commit della selezione aperta del file.
ContinuationData

Ottiene un set di valori da popolare dall'app prima PickSingleFileAndContinue o PickMultipleFilesAndContinue dall'operazione che disattiva l'app per fornire il contesto quando l'app viene attivata. (Windows Phone 8.x app)
FileTypeFilter

Ottiene la raccolta di tipi di file visualizzati dalla selezione aperta dal file.
SettingsIdentifier

Ottiene o imposta l'identificatore delle impostazioni associato allo stato della selezione di apertura del file.
SuggestedStartLocation

Ottiene o imposta il percorso iniziale in cui la selezione apri file cerca i file da presentare all'utente.
User

Ottiene informazioni sull'utente per cui è stato creato l'oggetto FileOpenPicker . Usare questa proprietà per le applicazioni multiutente.
ViewMode

Ottiene o imposta la modalità di visualizzazione utilizzata dalla selezione aperta dal file per visualizzare gli elementi.

Metodi

CreateForUser(User)

Crea un FileOpenPicker oggetto con ambito nella directory personale dell'utente specificato. Usare questo metodo per le applicazioni multiutente.
PickMultipleFilesAndContinue()

Obsoleto a partire da Windows 10. Usare invece PickSingleFolderAsync. Mostra la selezione file in modo che l'utente possa selezionare più file, disattivare l'app e riattivarla al termine dell'operazione. (Windows Phone 8.x app)
PickMultipleFilesAsync()

Mostra la selezione file in modo che l'utente possa selezionare più file. (app UWP)
PickSingleFileAndContinue()

Mostra la selezione file in modo che l'utente possa selezionare un file, disattivando potenzialmente l'app e riattivandola al termine dell'operazione. (Windows Phone 8.x app)
PickSingleFileAsync()

Mostra la selezione file in modo che l'utente possa selezionare un file.
PickSingleFileAsync(String)

Mostra la selezione file in modo che l'utente possa selezionare un file.
ResumePickSingleFileAsync()

Riprende l'operazione di selezione per recuperare il file selezionato dall'utente se l'utente si allontana dall'app dopo il completamento dell'operazione di selezione e l'app viene sospesa.

Si applica a

Vedi anche