BluetoothDevice Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Devices.Bluetooth

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.

Modifica

Rappresenta un dispositivo Bluetooth.

Le applicazioni di esempio che usano questa classe includono l'esempio di enumerazione del dispositivo e l'esempio di associazione e 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: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni: IClosable IDisposable

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