FileOpenPicker Class

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

Sintassi


var fileOpenPicker = new Windows.Storage.Pickers.FileOpenPicker();

Attributi

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

Membri

FileOpenPickerClasse include questi tipi di membri:

Costruttori

FileOpenPickerClasse include questi costruttori.

CostruttoreDescrizione
FileOpenPicker Creates a new instance of a FileOpenPicker.

 

Metodi

The FileOpenPicker Classe dispone di tali metodi. In C#, Visual Basic e C++, eredita inoltre i metodi da Object Classe.

MetodoDescrizione
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.

 

Proprietà

Classe dispone di tali proprietà. di FileOpenPicker

ProprietàTipo di accessoDescrizione

CommitButtonText

Lettura/scritturaGets or sets the label text of the file open picker's commit button.

FileTypeFilter

Sola letturaGets the collection of file types that the file open picker displays.

SettingsIdentifier

Lettura/scritturaGets or sets the settings identifier associated with the state of the file open picker.

SuggestedStartLocation

Lettura/scritturaGets or sets the initial location where the file open picker looks for files to present to the user.

ViewMode

Lettura/scritturaGets or sets the view mode that the file open picker uses to display items.

 

Note

Per iniziare ad accedere ai selettori file di file e cartelle, vedere la guida introduttiva all'accesso dei file con i selettori file.

Importante  In Windows 8, se si tenta di visualizzare il selettore file mentre l'applicazione è ancorata, il selettore in questione non viene visualizzato e viene generata un'eccezione. È possibile evitare questa situazione assicurandosi che l'applicazione non sia ancorata o annullandone lo snapping prima di chiamare il selettore file. I seguenti esempi di codice e l'Esempio di selezione file mostrano come. Notare che in Windows 8.1 non è definita una specifica dimensione di finestra ancorata. In alternativa, gli utenti possono ridimensionare le applicazioni a qualsiasi larghezza, fino al minimo. Pertanto, se l'applicazione verrà distribuita solo in Windows 8.1, è possibile ignorare la funzione EnsureUnsnapped e le relative chiamate nel codice di esempio di questo argomento.

Windows Phone 8

Questa API è supportata solo nelle applicazioni native.

Esempi

L'Esempio di selezione file mostra come controllare se l'applicazione viene interrotta, come impostare le proprietà del selettore di file e come visualizzare un selettore di file in modo che l'utente possa selezionare un singolo file.


// Verify that we are currently not snapped, or that we can unsnap to open the picker
var currentState = Windows.UI.ViewManagement.ApplicationView.value;
if (currentState === Windows.UI.ViewManagement.ApplicationViewState.snapped &&
    !Windows.UI.ViewManagement.ApplicationView.tryUnsnap()) {
    // Fail silently if we can't unsnap
    return;
}

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


Per C#, nell'Esempio di selettore file viene illustrato come controllare se l'app viene bloccata nel metodo 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;
}


L'Esempio di selezione file mostra inoltre come visualizzare un selettore di file in modo che l'utente possa selezionare più file.

Nota  Assicurarsi sempre che l'applicazione non sia bloccata (o che possa essere sbloccata) e impostare le proprietà di selezione file indipendentemente dal fatto che l'utente stia selezionando un singolo file o più file.


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


È inoltre possibile utilizzare il selettore file in Windows Phone. In quanto riportato di seguito viene illustrato un esempio di C++. In Windows Phone, FileOpenPicker è supportato nelle app native.


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


Requisiti

Client supportato minimo

Windows 8 [Solo applicazioni Windows Store]

Server supportato minimo

Windows Server 2012 [Solo applicazioni Windows Store]

Telefono supportato minimo

Windows Phone 8

Spazio dei nomi

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

Metadati

Windows.winmd

Vedere anche

Esempio di selettore file
Guida rapida: Accesso a file con selezioni file

 

 

Mostra:
© 2014 Microsoft