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 物件。

請注意，您的程式碼應該至少從 UI 執行緒呼叫 RequestAccessAsync 一次，然後再嘗試呼叫 SetStateAsync。 這是因為在某些區域中，有一些使用者設定選項，嘗試變更無線電狀態需要使用者許可權。 在此情況下，呼叫 RequestAccessAsync 會向使用者顯示提示，詢問他們是否允許您的應用程式擁有控制無線電的許可權。 如果您的應用程式是在需要使用者許可權的裝置上執行，且您的程式碼尚未要求並收到許可權， 則 SetStateAsync 將會失敗，因為使用者許可權不足。

屬性

Kind	取得列舉值，這個值描述這個物件所代表的無線電類型。
Name	取得這個 物件所表示之無線電的名稱。
State	取得這個 物件所表示之無線電的目前狀態。

方法

FromIdAsync(String)	擷取 Radio 物件的靜態方法。 方法接受透過 Windows.Devices.Enumeration.DeviceInformation.FindAllAsync找到的 'Device.Id'。 此程式比使用GetRadiosAsync取得無線電更可靠，在 USB 無線電在Windows 10工作站上失敗或移除的情況下取得無線電。 在此失敗或移除的無線電實例中， GetRadiosAsync 不會傳回任何藍牙無線電。 相反地，FindAllAsync會傳回可以傳遞至FromIdAsync的有效識別碼，以取得單選物件，其本身會回報為目前處於 'Disabled' 狀態。
GetDeviceSelector()	靜態方法，會傳回進階查詢語法 (AQS) 字串，以使用Windows.Devices.Enumeration.DeviceInformation.FindAllAsync和相關方法列舉或監視Radio裝置。
GetRadiosAsync()	靜態非同步方法，可擷取 Windows.Devices.Radios.Radio 物件的集合，代表程式啟動時存在於系統上的無線電裝置。 後續呼叫會忽略新增或移除無線電。
RequestAccessAsync()	非同步方法，這個方法會擷取值，指出目前使用者對此物件所代表之無線電的存取權。 在需要使用者許可權才能存取無線電的情況下，此方法會提示使用者輸入許可權。 因此，一律在 UI 執行緒上呼叫這個方法。
SetStateAsync(RadioState)	非同步作業，嘗試設定這個物件所表示之無線電的狀態。

事件

StateChanged

由這個物件所表示之單選中的狀態變更所引發的事件。 移除 USB 藍牙無線電或離線時，不會報告狀態變更。