DeviceInformationCollection Classe

Définition

Espace de noms:

Windows.Devices.Enumeration

Représente une collection d’objets DeviceInformation .

public ref class DeviceInformationCollection sealed : IIterable<DeviceInformation ^>, IVectorView<DeviceInformation ^>

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DeviceInformationCollection final : IIterable<DeviceInformation>, IVectorView<DeviceInformation>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DeviceInformationCollection : IEnumerable<DeviceInformation>, IReadOnlyList<DeviceInformation>

Public NotInheritable Class DeviceInformationCollection
Implements IEnumerable(Of DeviceInformation), IReadOnlyList(Of DeviceInformation)

Héritage

Object Platform::Object IInspectable DeviceInformationCollection

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

IIterable<T> IEnumerable<T> IIterable<DeviceInformation> IEnumerable<DeviceInformation> IVectorView<DeviceInformation> IReadOnlyList<DeviceInformation>

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

var DeviceInformation = Enumeration.DeviceInformation;
DeviceInformation.findAllAsync(deviceClass).then(
    successCallback, 
    errorCallback
);

// Handles successful completion of the findAllAsync method.
function successCallback(deviceInformationCollection) {
    var numDevices = deviceInformationCollection.length;
    document.getElementById("statusMessage").innerHTML = 
        numDevices + " device interface(s) found";
    if (numDevices) {
        for (var i = 0; i < numDevices; i++) {
            printFriendlyNameAndID(deviceInformationCollection[i], 
                document.getElementById("Output"));
        }
    } else {
        document.getElementById("statusMessage").innerHTML = "No devices found";
    }
}

// Handles an error completion of the findAllAsync method.
function errorCallback(e) {
    document.getElementById("statusMessage").innerHTML = 
        "Failed to find devices, error: " + e.message;
}

Remarques

L’exécution réussie de FindAllAsync entraîne la création d’un DeviceInformationCollection contenant des objets DeviceInformation .

Listes de membres de la collection

Pour JavaScript, DeviceInformationCollection a les membres affichés dans les listes de membres. En outre, DeviceInformationCollection prend en charge une propriété length , les membres de Array.prototype et l’utilisation d’un index pour accéder aux éléments.

Énumération de la collection en C# ou Microsoft Visual Basic

DeviceInformationCollection étant énumérable, vous pouvez utiliser la syntaxe propre au langage, telle que foreach en C# pour énumérer les éléments de la collection. Le compilateur effectue le cast de type pour vous et vous n’aurez pas besoin d’effectuer un cast IEnumerable<DeviceInformation> vers explicitement. Si vous devez effectuer un cast explicite, par exemple si vous souhaitez appeler GetEnumerator, effectuez un cast en IEnumerable<T> avec une contrainte DeviceInformation .

Propriétés

Size	Nombre d’objets DeviceInformation dans la collection.

Méthodes

First()	Obtient un objet qui peut itérer au sein des objets DeviceInformation énumérés, en commençant par le premier.
GetAt(UInt32)	Obtient l’objet DeviceInformation à l’index spécifié.
GetMany(UInt32, DeviceInformation[])	Obtient une plage d’objets DeviceInformation .
IndexOf(DeviceInformation, UInt32)	Retourne l’index de l’objet DeviceInformation spécifié dans la collection.