BluetoothDevice Klasse

Definition

Namespace:

Windows.Devices.Bluetooth

Stellt ein Bluetooth-Gerät dar.

Beispiele für Anwendungen, die diese Klasse verwenden, sind Beispiel für Geräteenumeration und Kopplung 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

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IClosable IDisposable

Windows-Anforderungen

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	DeviceInformation
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

BluetoothAddress	Ruft die Geräteadresse ab.
BluetoothDeviceId	Ruft die Bluetooth-Geräte-ID ab.
ClassOfDevice	Ruft die Bluetooth-Geräteklasseninformationen des Geräts ab.
ConnectionStatus	Ruft die Verbindung status 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 aus dem 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 vom Gerät unterstützten RFCOMM-Dienste ab. Wichtig Die RfcommServices-API ist veraltet und ist in zukünftigen Versionen von Windows möglicherweise 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 das BluetoothDevice über eine sichere Verbindung gekoppelt wurde.

Methoden

Close()	Schließt das Bluetooth-Gerät.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
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 durch die angegebene DeviceId identifiziert wird.
GetDeviceSelector()	Ruft eine AQS-Zeichenfolge (Advanced Query Syntax) zum Identifizieren von Instanzen dieses Geräts ab. 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 der angegebenen Bluetooth-Verbindung status 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 Bluetooth-Remotegerät ab.
GetRfcommServicesAsync(BluetoothCacheMode)	Ruft alle zwischengespeicherten Rfcomm-Dienste auf dem Bluetooth-Remotegerät ab.
GetRfcommServicesForIdAsync(RfcommServiceId)	Ruft alle Rfcomm-Dienste auf dem Remote-Bluetooth-Gerät ab, das der angegebenen RfcommServiceId entspricht.
GetRfcommServicesForIdAsync(RfcommServiceId, BluetoothCacheMode)	Ruft alle zwischengespeicherten Rfcomm-Dienste auf dem Bluetooth-Remotegerät ab, das der angegebenen RfcommServiceId entspricht.
RequestAccessAsync()	Wird verwendet, um expliziten Zugriff auf das Bluetooth-Gerät anzufordern. Dadurch wird die Geräteeinwilligung aufgerufen und muss im UI-Thread aufgerufen werden.

Ereignisse

ConnectionStatusChanged	Tritt auf, wenn sich die Verbindung status 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 Listen-SDP-Einträge für das Gerät geändert haben.

Weitere Informationen

• Beispiel für Geräteenumeration und Kopplung
• Bluetooth RFCOMM-Chatbeispiel