FileSavePicker Class

Représente un sélecteur de fichier qui permet à l'utilisateur de choisir le nom, l'extension et l'emplacement de stockage d'un fichier.

Syntaxe


public ref class FileSavePicker sealed 

Attributs

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

Membres

FileSavePickerClasse possède ces types de membres :

Constructeurs

FileSavePickerClasse possède ces constructeurs.

ConstructeurDescription
FileSavePicker Creates a new instance of a FileSavePicker.

 

Méthodes

The FileSavePicker Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
PickSaveFileAsync Shows the file picker so that the user can save a file and set the file name, extension, and location of the file to be saved.

 

Propriétés

Le FileSavePickerClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

CommitButtonText

Lecture/écritureGets or sets the label text of the commit button in the file pickerUI.

DefaultFileExtension

Lecture/écritureGets or sets the default file name extension that the fileSavePicker gives to files to be saved.

FileTypeChoices

En lecture seuleGets the collection of valid file types that the user can choose to assign to a file.

SettingsIdentifier

Lecture/écritureGets or sets the settings identifier associated with the current FileSavePicker instance.

SuggestedFileName

Lecture/écritureGets or sets the file name that the file save picker suggests to the user.

SuggestedSaveFile

Lecture/écritureGets or sets the storageFile that the file picker suggests to the user for saving a file.

SuggestedStartLocation

Lecture/écritureGets or sets the location that the file save picker suggests to the user as the location to save a file.

 

Remarques

Pour savoir comment enregistrer des fichiers dans le sélecteur de fichiers, consultez Comment sauvegarder les fichiers à l'aide des sélecteurs de fichier.

Pour commencer à accéder aux sélecteurs de fichiers et de dossiers, consultez Démarrage rapide : accès aux fichiers à l'aide d'un sélecteur de fichiers.

Avertissement  Si vous essayez d'afficher le sélecteur de fichiers pendant que votre application est alignée, le sélecteur de fichiers ne sera pas affiché et une exception sera levée. Vous pouvez éviter ceci en vérifiant que votre application n'est pas alignée ou en annulant l'alignement avant d'appeler le sélecteur de fichiers. Les exemples de code suivants et l'exemple de sélecteur de fichier vous montrent comment procéder.

Exemples

L'Exemple de sélecteur de fichier montre comment vérifier si l'application est alignée, comment définir les propriétés de sélecteur de fichier, et comment afficher un sélecteur de fichier pour permettre à l'utilisateur d'enregistrer un fichier.

Aucun exemple de code n'est actuellement disponible ou ce langage n'est pas pris en charge.

Pour C#, l'exemple de sélecteur de fichier montre comment vérifier si votre application est alignée dans la méthode 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;
}


Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

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

Métadonnées

Windows.winmd

Voir aussi

Exemple de sélecteur de fichiers
Démarrage rapide : accès aux fichiers à l'aide des sélecteurs de fichiers
Comment sauvegarder les fichiers à l'aide des sélecteurs de fichier
Windows.Storage.StorageFile class

 

 

Afficher:
© 2015 Microsoft