StorageDevice.FromId | fromId Method

Obtient un objet StorageFolder d'un identificateur DeviceInformation pour un dispositif de stockage amovible.

Syntaxe


var storageFolder = Windows.Devices.Portable.StorageDevice.fromId(DeviceId);

Paramètres

DeviceId

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

ID DeviceInformation qui identifie le dispositif de stockage amovible. Cet identificateur peut être extrait de Windows.Devices.Enumeration ou de la propriété DeviceInformationId des arguments d'événements de périphérique de lecture automatique. Pour plus d'informations, consultez Démarrage rapide : inscrire une application pour un périphérique de lecture automatique. Pour que FromId réussisse, l'application doit déclarer la fonctionnalité removableStorage comme indiqué dans les Déclarations des fonctionnalités d'application et les associations de types de fichiers pour les fichiers auxquels elle souhaite accéder sur le périphérique, comme indiqué dans Comment gérer l'activation des fichiers. Pour plus d'informations, consultez l'exemple de stockage amovible.

Valeur de retour

Type: StorageFolder

Objet dossier de stockage qui représente le dispositif de stockage amovible et permet d'accéder au contenu sur le périphérique.

Remarques

Pour accéder aux services de périphérique, vous devez déclarer le service de périphérique dans la section de fonctionnalités du fichier de manifeste de l'application. Pour obtenir une liste des GUID représentant les services de périphériques, reportez-vous à Windows.Devices.Portable.

Passez la chaîne de sélecteur de GetDeviceSelector à l'API Windows.Devices.Enumeration pour obtenir une collection d'objets DeviceInformation représentant des dispositifs de stockage. Sélectionnez l'objet DeviceInformation pour le stockage auquel vous souhaitez accéder et utilisez sa propriété Id comme paramètre deviceInformationId de FromId.

Exemples

L'exemple suivant montre comment obtenir un ID d'interface à l'aide de l'API GetDeviceSelector et l'API de Windows.Devices.Enumeration et comment le passer à FromId pour obtenir un StorageFolder pour un dispositif de stockage amovible.


    Enum = Windows.Devices.Enumeration;

    // Enumerate removable storage devices.
    // The success callback selects the removable storage to use.
    function pickStorageToGetImageFrom() {
        Enum.DeviceInformation.findAllAsync(
        Windows.Devices.Portable.StorageDevice.getDeviceSelector(),
        null).then(
            successCallback,
            errorCallback);
    }

    // Handler that's called when removable storages are found.
    // storageDevices: A collection of type
    // Windows.Devices.Enumeration.DeviceInformationCollection.
    // This example just takes the first storage found in the list.
    function successCallback(storageDevices) {
        var removableStorage = null;
        if (storageDevices.length) {
            try {
                // Get a StorageFolder from the id for the first removable storage device
                removableStorage = Windows.Devices.Portable.StorageDevice.fromId(
                storageDevices.getAt(0).id);
                // document.getElementById("output").innerHTML = storageDevices.getAt(0).name; 
            } catch (e) {
                document.getElementById("output").innerHTML =
                "Error: " + e.message;
            }
            if (removableStorage != null) {
                getImageFiles(removableStorage);
            }
        } else {
            document.getElementById("output").innerHTML =
                "No removable storage devices were found.";
        }
    }

Les exemples suivants illustrent la syntaxe d'un appel de FromId en C# et C++.


var folder = StorageDevice.FromId(deviceInformationId); 



Conditions requises

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.Devices.Portable
Windows::Devices::Portable [C++]

Métadonnées

Windows.winmd

Capabilities

removableStorage

Voir aussi

StorageDevice
DeviceInformation
DeviceInformation.Id
Énumération des périphériques communs

 

 

Afficher:
© 2015 Microsoft