BluetoothDevice Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.IDisposablePublic NotInheritable Class BluetoothDevice
Implements IDisposable- Ereditarietà
- 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. |