Radio Klasse

Definition

Namespace:

Windows.Devices.Radios

Stellt ein Funkgerät im System dar.

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

Vererbung

Object Platform::Object IInspectable Radio

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Ihr Code verwendet statische Member dieser Klasse wie GetRadiosAsync, GetDeviceSelector und FromIdAsync , um Funkgeräte abzufragen und instanziierte Radioobjekte abzurufen, die bestimmte Funkgeräte auf dem Gerät darstellen.

Beachten Sie, dass Ihr Code RequestAccessAsync mindestens einmal aus dem UI-Thread aufrufen sollte, bevor Sie versuchen, SetStateAsync aufzurufen. Dies liegt daran, dass in einigen Regionen mit einigen Auswahlmöglichkeiten für Benutzereinstellungen der Versuch, den Funkzustand zu ändern, eine Benutzerberechtigung erfordert. In diesem Fall wird der Benutzer beim Aufrufen von RequestAccessAsync aufgefordert, zu fragen, ob er Ihrer App die Berechtigung zum Steuern des Funkgeräts gestatten möchte. Wenn Ihre App auf einem Gerät ausgeführt wird, das eine Benutzerberechtigung erfordert, und Ihr Code die Berechtigung nicht angefordert und empfangen hat, schlägt SetStateAsync aufgrund fehlender Benutzerberechtigung fehl.

Eigenschaften

Kind	Ruft einen Enumerationswert ab, der beschreibt, welche Art von Radio dieses Objekt darstellt.
Name	Ruft den Namen des durch dieses -Objekt dargestellten Radios ab.
State	Ruft den aktuellen Zustand des durch dieses -Objekt dargestellten Funks ab.

Methoden

FromIdAsync(String)	Eine statische Methode, die ein Radio-Objekt abruft. Die -Methode akzeptiert die über Windows.Devices.Enumeration.DeviceInformation.FindAllAsync gefundene "Device.Id". Dieses Verfahren ist zuverlässiger als die Verwendung von GetRadiosAsync zum Abrufen eines Funkgeräts in Situationen, in denen ein USB-Funkgerät ausgefallen ist oder auf einer Windows 10 Arbeitsstation entfernt wurde. In dieser instance eines ausgefallenen oder entfernten Radios gibt GetRadiosAsync kein Bluetooth-Radio zurück. FindAllAsync im Gegensatz dazu gibt eine gültige ID zurück, die an FromIdAsync übergeben werden kann, um das Funkobjekt abzurufen, das sich selbst als jetzt im Status "Disabled" meldet.
GetDeviceSelector()	Eine statische Methode, die eine AQS-Zeichenfolge (Advanced Query Syntax) zurückgibt, die zum Aufzählen oder Überwachen von Funkgeräten mit Windows.Devices.Enumeration.DeviceInformation.FindAllAsync und verwandten Methoden verwendet werden soll.
GetRadiosAsync()	Eine statische, asynchrone Methode, die eine Auflistung von Windows.Devices.Radios.Radio-Objekten abruft, die Funkgeräte darstellen, die zum Zeitpunkt des Programmstarts auf dem System vorhanden waren. Das Hinzufügen oder Entfernen von Funken wird von nachfolgenden Aufrufen ignoriert.
RequestAccessAsync()	Eine asynchrone Methode, die einen Wert abruft, der angibt, welchen Zugriff der aktuelle Benutzer auf das durch dieses Objekt dargestellte Funk hat. In Fällen, in denen eine Benutzerberechtigung für den Zugriff auf das Funkgerät erforderlich ist, fordert diese Methode den Benutzer zur Berechtigung auf. Rufen Sie daher diese Methode immer im UI-Thread auf.
SetStateAsync(RadioState)	Ein asynchroner Vorgang, der versucht, den Status des durch dieses Objekt dargestellten Funks festzulegen.

Ereignisse

StateChanged

Ereignis, das durch eine Zustandsänderung im durch dieses Objekt dargestellten Radio ausgelöst wird. Wenn ein USB-Bluetooth-Funkgerät entfernt wird oder anderweitig offline geschaltet wird, wird keine Zustandsänderung gemeldet.