BluetoothDevice Klasse
Definition
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.
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
- 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. |