Radio 类

定义

命名空间:

Windows.Devices.Radios

表示系统上的无线电设备。

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

继承

Object Platform::Object IInspectable Radio

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

代码使用此类的静态成员（如 GetRadiosAsync、 GetDeviceSelector 和 FromIdAsync ）来查询无线电并检索表示设备上特定无线电的实例化 Radio 对象。

请注意，在尝试调用 SetStateAsync 之前，代码应至少从 UI 线程调用 RequestAccessAsync 一次。 这是因为在某些区域中，对于某些用户设置选项，尝试更改单选状态需要用户权限。 在这种情况下，调用 RequestAccessAsync 会显示一个提示，询问用户是否希望允许你的应用拥有控制无线电的权限。 如果你的应用在需要用户权限的设备上运行，并且你的代码尚未请求和接收权限，则 SetStateAsync 将因缺少用户权限而失败。

属性

Kind	获取一个枚举值，该值描述此 对象表示的无线电类型。
Name	获取由此 对象表示的无线电的名称。
State	获取由此 对象表示的无线电的当前状态。

方法

FromIdAsync(String)	检索 Radio 对象的静态方法。 方法接受通过 Windows.Devices.Enumeration.DeviceInformation.FindAllAsync 找到的“Device.Id”。 在Windows 10工作站上的 USB 无线电发生故障或删除的情况下，此过程比使用 GetRadiosAsync 获取无线电更可靠。 在此失败或已删除的无线电实例中， GetRadiosAsync 不返回任何蓝牙无线电。 相比之下，FindAllAsync 返回一个有效的 ID，该 ID 可以传递给 FromIdAsync 以获取单选对象，该单选对象将自身报告为现在处于“Disabled”状态。
GetDeviceSelector()	返回高级查询语法 (AQS) 字符串的静态方法，用于使用 Windows.Devices.Enumeration.DeviceInformation.FindAllAsync 和相关方法枚举或监视无线电设备。
GetRadiosAsync()	一种静态异步方法，用于检索 Windows.Devices.Radios.Radio 对象的集合，这些对象表示在程序启动时存在于系统上的无线电设备。 后续调用将忽略无线电的添加或删除。
RequestAccessAsync()	一种异步方法，用于检索一个值，该值指示当前用户对此对象表示的无线电具有哪些访问权限。 在需要用户权限才能访问无线电的情况下，此方法会提示用户输入权限。 因此，始终在 UI 线程上调用此方法。
SetStateAsync(RadioState)	一个异步操作，该操作尝试设置由此对象表示的无线电的状态。

事件

StateChanged

由此 对象表示的无线电中的状态更改引发的事件。 当删除 USB 蓝牙无线电或以其他方式脱机时，不会报告任何状态更改。