Radio Classe

Definizione

Spazio dei nomi:

Windows.Devices.Radios

Rappresenta un dispositivo radio nel sistema.

public ref class Radio sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class Radio final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class Radio

Public NotInheritable Class Radio

Ereditarietà

Object Platform::Object IInspectable Radio

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

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)

Commenti

Il codice usa membri statici di questa classe, ad esempio GetRadiosAsync, GetDeviceSelector e FromIdAsync per eseguire query sulle radio e recuperare oggetti Radio creati in un'istanza che rappresentano le radio specifiche nel dispositivo.

Si noti che il codice deve chiamare RequestAccessAsync almeno una volta, dal thread dell'interfaccia utente, prima di provare a chiamare SetStateAsync. Questo perché in alcune aree, con alcune opzioni di impostazioni utente, il tentativo di modificare lo stato di radio richiede l'autorizzazione utente. In questa situazione, la chiamata a RequestAccessAsync mostra all'utente un prompt che chiede se vuole consentire all'app di avere l'autorizzazione per controllare la radio. Se l'app è in esecuzione in un dispositivo che richiede l'autorizzazione utente e il codice non ha richiesto e ricevuto l'autorizzazione, SetStateAsync avrà esito negativo per mancanza di autorizzazione utente.

Proprietà

Kind	Ottiene un valore di enumerazione che descrive il tipo di radio rappresentato da questo oggetto.
Name	Ottiene il nome della radio rappresentata da questo oggetto.
State	Ottiene lo stato corrente della radio rappresentata da questo oggetto.

Metodi

FromIdAsync(String)	Metodo statico che recupera un oggetto Radio . Il metodo accetta il 'Device.Id' trovato tramite Windows.Devices.Enumeration.DeviceInformation.FindAllAsync. Questa procedura è più affidabile rispetto all'uso di GetRadiosAsync per ottenere una radio in situazioni in cui una radio USB non è riuscita o è stata rimossa in una workstation Windows 10. In questa istanza di una radio non riuscita o rimossa, GetRadiosAsync non restituisce alcuna radio bluetooth. FindAllAsync, al contrario, restituisce un ID valido che può essere passato a FromIdAsync per ottenere l'oggetto radio, che verrà segnalato come ora nello stato di "Disabilitato".
GetDeviceSelector()	Metodo statico che restituisce una stringa AQS (Advanced Query Syntax) da usare per enumerare o monitorare i dispositivi radio con Windows.Devices.Enumeration.DeviceInformation.FindAllAsync e metodi correlati.
GetRadiosAsync()	Metodo statico e asincrono che recupera una raccolta di oggetti Windows.Devices.Radios.Radio che rappresentano i dispositivi radio esistenti nel sistema al momento dell'avvio del programma. Le aggiunte o le rimozione delle radio vengono ignorate dalle chiamate successive.
RequestAccessAsync()	Metodo asincrono che recupera un valore che indica l'accesso dell'utente corrente alla radio rappresentata da questo oggetto. In circostanze in cui l'autorizzazione utente è necessaria per accedere alla radio, questo metodo richiede all'utente l'autorizzazione. Di conseguenza, chiamare sempre questo metodo nel thread dell'interfaccia utente.
SetStateAsync(RadioState)	Operazione asincrona che tenta di impostare lo stato della radio rappresentata da questo oggetto.

Eventi

StateChanged

Evento generato da una modifica dello stato nella radio rappresentata da questo oggetto. Quando una radio Bluetooth USB viene rimossa o altrimenti viene disattivata, non viene segnalata alcuna modifica dello stato.