Condividi tramite


BluetoothDevice Classe

Definizione

Rappresenta un dispositivo Bluetooth.

Le applicazioni di esempio che usano questa classe includono l'esempio di enumerazione del dispositivo e l'esempio di associazionee l'esempio di chat RFCOMM Bluetooth.

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
Ereditarietà
Object Platform::Object IInspectable BluetoothDevice
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app
bluetooth

Commenti

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
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

Proprietà

BluetoothAddress

Ottiene l'indirizzo del dispositivo.

BluetoothDeviceId

Ottiene l'ID dispositivo Bluetooth.

ClassOfDevice

Ottiene la classe Bluetooth delle informazioni sul dispositivo.

ConnectionStatus

Ottiene lo stato della connessione del dispositivo.

DeviceAccessInformation

Oggetto DeviceAccessInformation corrente per il dispositivo. Usato per controllare e monitorare le modifiche di accesso al dispositivo.

DeviceId

Ottiene l'ID dispositivo proveniente dal Windows.Devices.Enumeration.DeviceInformation.Id

DeviceInformation

Ottiene l'oggetto DeviceInformation per il dispositivo Bluetooth.

HostName

Ottiene il nome host del dispositivo.

Name

Ottiene il nome del dispositivo.

RfcommServices

Ottiene l'elenco di sola lettura dei servizi RFCOMM supportati dal dispositivo.

Importante

L'API RfcommServices è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece GetRfcommServicesAsync.

SdpRecords

Ottiene l'elenco di sola lettura dei record SDP (Service Discovery Protocol) per il dispositivo.

WasSecureConnectionUsedForPairing

Ottiene un valore booleano che indica se Il dispositivo Bluetooth è stato associato utilizzando una connessione protetta.

Metodi

Close()

Chiude il dispositivo Bluetooth.

Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.

FromBluetoothAddressAsync(UInt64)

Restituisce un oggetto BluetoothDevice per il bluetoothAddress specificato.

FromHostNameAsync(HostName)

Restituisce un oggetto BluetoothDevice identificato dal nome host specificato.

FromIdAsync(String)

Restituisce un oggetto BluetoothDevice identificato dal valore DeviceId specificato.

GetDeviceSelector()

Ottiene una stringa AQS (Advanced Query Syntax) per identificare le istanze di questo dispositivo. Questa stringa viene passata al metodo FindAllAsync o CreateWatcher.

GetDeviceSelectorFromBluetoothAddress(UInt64)

Crea una stringa di filtro AQS (Advanced Query Syntax) da un indirizzo a 64 bit che rappresenta un dispositivo Bluetooth. La stringa AQS viene passata al metodo CreateWatcher per restituire una raccolta di oggetti DeviceInformation .

GetDeviceSelectorFromClassOfDevice(BluetoothClassOfDevice)

Crea una stringa di filtro AQS (Advanced Query Syntax) da un oggetto BluetoothClassOfDevice . La stringa AQS viene passata al metodo CreateWatcher per restituire una raccolta di oggetti DeviceInformation .

GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)

Crea una stringa di filtro AQS (Advanced Query Syntax) che contiene una query per i dispositivi Bluetooth con il BluetoothConnectionStatus indicato. La stringa AQS viene passata al metodo CreateWatcher per restituire una raccolta di oggetti DeviceInformation con lo stato di connessione Bluetooth indicato.

GetDeviceSelectorFromDeviceName(String)

Crea una stringa di filtro AQS (Advanced Query Syntax) contenente una query per il nome del dispositivo Bluetooth. La stringa AQS viene passata al metodo CreateWatcher per restituire una raccolta di oggetti DeviceInformation contenenti il nome del dispositivo Bluetooth specificato.

GetDeviceSelectorFromPairingState(Boolean)

Crea una stringa di filtro AQS (Advanced Query Syntax) che contiene una query per i dispositivi Bluetooth associati o non abbinati. La stringa AQS viene passata al metodo CreateWatcher per restituire una raccolta di oggetti DeviceInformation .

GetRfcommServicesAsync()

Recupera tutti i servizi Rfcomm nel dispositivo Bluetooth remoto.

GetRfcommServicesAsync(BluetoothCacheMode)

Recupera tutti i servizi Rfcomm memorizzati nella cache nel dispositivo Bluetooth remoto.

GetRfcommServicesForIdAsync(RfcommServiceId)

Recupera tutti i servizi Rfcomm nel dispositivo Bluetooth remoto che corrispondono all'oggetto RfcommServiceId specificato.

GetRfcommServicesForIdAsync(RfcommServiceId, BluetoothCacheMode)

Recupera tutti i servizi Rfcomm memorizzati nella cache nel dispositivo Bluetooth remoto corrispondenti all'oggetto RfcommServiceId specificato.

RequestAccessAsync()

Usato per richiedere l'accesso esplicito al dispositivo Bluetooth. In questo modo viene richiamato il consenso del dispositivo e deve essere chiamato nel thread dell'interfaccia utente.

Eventi

ConnectionStatusChanged

Si verifica quando lo stato della connessione del dispositivo è cambiato.

NameChanged

Si verifica quando il nome del dispositivo è stato modificato.

SdpRecordsChanged

Si verifica quando l'elenco dei record SDP per il dispositivo è stato modificato.

Si applica a

Vedi anche