DeviceInformationCollection Klasse

Referenz

Definition

Namespace:: Windows.Devices.Enumeration

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt eine Auflistung von DeviceInformation-Objekten dar.

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)

Vererbung: Object Platform::Object IInspectable DeviceInformationCollection

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute

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

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

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

Hinweise

Ein erfolgreicher Abschluss von FindAllAsync führt zu einer DeviceInformationCollection mit DeviceInformation-Objekten .

Auflistungselementlisten

Für JavaScript verfügt DeviceInformationCollection über die elemente, die in den Memberlisten angezeigt werden. Darüber hinaus unterstützt DeviceInformationCollection eine length-Eigenschaft , Member von Array.prototype und die Verwendung eines Indexes für den Zugriff auf Elemente.

Auflisten der Sammlung in C# oder Microsoft Visual Basic

DeviceInformationCollection ist aufzählbar, sodass Sie sprachspezifische Syntax wie foreach in C# verwenden können, um die Elemente in der Auflistung aufzulisten. Der Compiler führt die Typumwandlung für Sie durch, und Sie müssen nicht explizit in IEnumerable<DeviceInformation> umwandeln. Wenn Sie eine explizite Umwandlung durchführen müssen, z. B. wenn Sie GetEnumerator aufrufen möchten, wandeln Sie mit einer DeviceInformation-Einschränkung in IEnumerable<T> um.

Eigenschaften

Size	Die Anzahl der DeviceInformation-Objekte in der Auflistung.

Methoden

First()	Ruft ein -Objekt ab, das die aufgezählten DeviceInformation-Objekte durchlaufen kann, beginnend mit dem ersten.
GetAt(UInt32)	Ruft das DeviceInformation-Objekt am angegebenen Index ab.
GetMany(UInt32, DeviceInformation[])	Ruft einen Bereich von DeviceInformation-Objekten ab.
IndexOf(DeviceInformation, UInt32)	Gibt den Index des angegebenen DeviceInformation-Objekts in der Auflistung zurück.

Gilt für:

Freigeben über