Radio 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 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 RadioPublic NotInheritable Class Radio- Ereditarietà
- Attributi
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. |