Sprache

BluetoothDevice Klasse

Definition

Stellt ein Bluetooth-Gerät dar.

Beispielanwendungen, die diese Klasse verwenden, umfassen Geräteenumeration und Kopplungsbeispiel und Bluetooth RFCOMM-Chatbeispiel.

public ref class BluetoothDevice sealed : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BluetoothDevice final : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BluetoothDevice : System.IDisposable
Public NotInheritable Class BluetoothDevice
Implements IDisposable
Vererbung
Object Platform::Object IInspectable BluetoothDevice
Attribute
Implementiert

Windows-Anforderungen

Anforderungen Beschreibung
Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen
bluetooth

Hinweise

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1511 10586 Geräteinformationen
1511 10586 GetDeviceSelectorFromBluetoothAddress
1511 10586 GetDeviceSelectorFromClassOfDevice
1511 10586 GetDeviceSelectorFromConnectionStatus
1511 10586 GetDeviceSelectorFromDeviceName
1511 10586 GetDeviceSelectorFromPairingState
1607 14393 DeviceAccessInformation
1607 14393 GetRfcommServicesAsync
1607 14393 GetRfcommServicesAsync(BluetoothCacheMode)
1607 14393 GetRfcommServicesForIdAsync(RfcommServiceId)
1607 14393 GetRfcommServicesForIdAsync(RfcommServiceId,BluetoothCacheMode)
1607 14393 RequestAccessAsync
1709 16299 BluetoothDeviceId
1803 17134 WasSecureConnectionUsedForPairing

Eigenschaften

Name Beschreibung
BluetoothAddress

Ruft die Geräteadresse ab.

BluetoothDeviceId

Ruft die Bluetooth-Geräte-ID ab.

ClassOfDevice

Ruft die Bluetooth-Geräteklasse-Informationen des Geräts ab.

ConnectionStatus

Ruft den Verbindungsstatus des Geräts ab.

DeviceAccessInformation

Das aktuelle DeviceAccessInformation-Objekt für das Gerät. Wird verwendet, um Zugriffsänderungen auf dem Gerät zu überprüfen und zu überwachen.

DeviceId

Ruft die Geräte-ID ab, die vom Windows.Devices.Enumeration.DeviceInformation.Id

DeviceInformation

Ruft das DeviceInformation - Objekt für das Bluetooth-Gerät ab.

HostName

Ruft den HostName des Geräts ab.

Name

Ruft den Namen des Geräts ab.

RfcommServices

Ruft die schreibgeschützte Liste der RFCOMM-Dienste ab, die vom Gerät unterstützt werden.

Important

Die RfcommServices-API ist veraltet und ist möglicherweise in zukünftigen Versionen von Windows nicht verfügbar. Verwenden Sie stattdessen GetRfcommServicesAsync.

SdpRecords

Ruft die schreibgeschützte Liste der SDP-Einträge (Service Discovery Protocol) für das Gerät ab.

WasSecureConnectionUsedForPairing

Ruft einen booleschen Wert ab, der angibt, ob bluetoothDevice mit einer sicheren Verbindung gekoppelt wurde.

Methoden

Name Beschreibung
Close()

Schließt das Bluetooth-Gerät.

Dispose()

Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind.

FromBluetoothAddressAsync(UInt64)

Gibt ein BluetoothDevice -Objekt für die angegebene BluetoothAddress zurück.

FromHostNameAsync(HostName)

Gibt ein BluetoothDevice - Objekt zurück, das durch den angegebenen HostName identifiziert wird.

FromIdAsync(String)

Gibt ein BluetoothDevice - Objekt zurück, das von der angegebenen DeviceId identifiziert wird.

GetDeviceSelector()

Ruft eine Zeichenfolge für die erweiterte Abfragesyntax (Advanced Query Syntax, AQS) ab, um Instanzen dieses Geräts zu identifizieren. Diese Zeichenfolge wird an die FindAllAsync- oder CreateWatcher-Methode übergeben.

GetDeviceSelectorFromBluetoothAddress(UInt64)

Erstellt eine AQS-Filterzeichenfolge (Advanced Query Syntax) aus einer 64-Bit-Adresse, die ein Bluetooth-Gerät darstellt. Die AQS-Zeichenfolge wird an die CreateWatcher-Methode übergeben, um eine Auflistung von DeviceInformation-Objekten zurückzugeben.

GetDeviceSelectorFromClassOfDevice(BluetoothClassOfDevice)

Erstellt eine AQS-Filterzeichenfolge (Advanced Query Syntax) aus einem BluetoothClassOfDevice -Objekt. Die AQS-Zeichenfolge wird an die CreateWatcher-Methode übergeben, um eine Auflistung von DeviceInformation-Objekten zurückzugeben.

GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)

Erstellt eine AQS-Filterzeichenfolge (Advanced Query Syntax), die eine Abfrage für Bluetooth-Geräte mit dem angegebenen BluetoothConnectionStatus enthält. Die AQS-Zeichenfolge wird an die CreateWatcher-Methode übergeben, um eine Auflistung von DeviceInformation-Objekten mit dem angegebenen Bluetooth-Verbindungsstatus zurückzugeben.

GetDeviceSelectorFromDeviceName(String)

Erstellt eine AQS-Filterzeichenfolge (Advanced Query Syntax), die eine Abfrage für den Bluetooth-Gerätenamen enthält. Die AQS-Zeichenfolge wird an die CreateWatcher-Methode übergeben, um eine Auflistung von DeviceInformation-Objekten zurückzugeben, die den angegebenen Bluetooth-Gerätenamen enthalten.

GetDeviceSelectorFromPairingState(Boolean)

Erstellt eine AQS-Filterzeichenfolge (Advanced Query Syntax), die eine Abfrage für Bluetooth-Geräte enthält, die entweder gekoppelt oder entkoppelt sind. Die AQS-Zeichenfolge wird an die CreateWatcher-Methode übergeben, um eine Auflistung von DeviceInformation-Objekten zurückzugeben.

GetRfcommServicesAsync()

Ruft alle Rfcomm-Dienste auf dem Remote-Bluetooth-Gerät ab.

GetRfcommServicesAsync(BluetoothCacheMode)

Ruft alle zwischengespeicherten Rfcomm-Dienste auf dem Remote-Bluetooth-Gerät ab.

GetRfcommServicesForIdAsync(RfcommServiceId, BluetoothCacheMode)

Ruft alle zwischengespeicherten Rfcomm-Dienste auf dem Remote-Bluetooth-Gerät ab, das der angegebenen RfcommServiceId entspricht.

GetRfcommServicesForIdAsync(RfcommServiceId)

Ruft alle Rfcomm-Dienste auf dem Remote-Bluetooth-Gerät ab, das der angegebenen RfcommServiceId entspricht.

RequestAccessAsync()

Wird verwendet, um expliziten Zugriff auf das Bluetooth-Gerät anzufordern. Dadurch wird die Geräteeinstimmung aufgerufen und muss im UI-Thread aufgerufen werden.

Events

Name Beschreibung
ConnectionStatusChanged

Tritt auf, wenn sich der Verbindungsstatus des Geräts geändert hat.

NameChanged

Tritt auf, wenn sich der Name des Geräts geändert hat.

SdpRecordsChanged

Tritt auf, wenn sich die SDP-Listeneinträge für das Gerät geändert haben.

Gilt für:

Siehe auch