DeviceInformation.CreateWatcher 方法

定义

命名空间:

Windows.Devices.Enumeration

重载

CreateWatcher()	为所有设备创建 DeviceWatcher 。
CreateWatcher(String)	为与指定的高级查询语法 (AQS) 字符串匹配的设备创建 DeviceWatcher 。
CreateWatcher(DeviceClass)	为与指定的 DeviceClass 匹配的设备创建 DeviceWatcher。
CreateWatcher(String, IIterable<String>)	为与指定的高级查询语法 (AQS) 字符串和指定的属性集合匹配的设备创建 DeviceWatcher 。
CreateWatcher(String, IIterable<String>, DeviceInformationKind)	为与指定的高级查询语法 (AQS) 字符串、指定的属性集合和设备类型匹配的设备创建 DeviceWatcher 。

CreateWatcher()

为所有设备创建 DeviceWatcher 。

public:
 static DeviceWatcher ^ CreateWatcher();

/// [Windows.Foundation.Metadata.Overload("CreateWatcher")]
 static DeviceWatcher CreateWatcher();

[Windows.Foundation.Metadata.Overload("CreateWatcher")]
public static DeviceWatcher CreateWatcher();

function createWatcher()

Public Shared Function CreateWatcher () As DeviceWatcher

返回

DeviceWatcher

创建的 DeviceWatcher。

属性

OverloadAttribute

注解

DeviceWatcher 首先执行设备的初始枚举，为其找到的每个设备引发 Added 事件，并在初始枚举完成时引发 EnumerationCompleted 事件。 初始枚举完成后，它会在添加、删除或更新设备时引发事件。

有关示例，请参阅 DeviceWatcher 类。

注意

应用必须订阅所有 添加、 删除和 更新 的事件，才能在添加、删除或更新设备时收到通知。 如果应用仅处理 添加 的事件，则如果在初始设备枚举完成后将设备添加到系统，则它将不会收到更新。

另请参阅

• CreateWatcher(DeviceClass)
• CreateWatcher(String)
• CreateWatcher(String, IIterable<String>)

CreateWatcher(String)

为与指定的高级查询语法 (AQS) 字符串匹配的设备创建 DeviceWatcher 。

public:
 static DeviceWatcher ^ CreateWatcher(Platform::String ^ aqsFilter);

/// [Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilter")]
 static DeviceWatcher CreateWatcher(winrt::hstring const& aqsFilter);

[Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilter")]
public static DeviceWatcher CreateWatcher(string aqsFilter);

function createWatcher(aqsFilter)

Public Shared Function CreateWatcher (aqsFilter As String) As DeviceWatcher

参数

aqsFilter

String

Platform::String

winrt::hstring

一个 AQS 字符串，用于筛选要枚举的 DeviceInformation 对象。 通常，此字符串是从与设备交互的类的 GetDeviceSelector 方法检索的。 例如， GetDeviceSelector 检索 StorageDevice 类的字符串。

返回

DeviceWatcher

创建的 DeviceWatcher。

属性

OverloadAttribute

注解

注意

此重载在 JavaScript 中不可用。 若要在 JavaScript 中基于 AQS 字符串创建 DeviceWatcher ，请使用 CreateWatcher (String，IIterable_1) 重载并作为第二个参数传递 null 。

DeviceWatcher 首先执行设备的初始枚举，为其找到的每个设备引发 Added 事件，并在初始枚举完成时引发 EnumerationCompleted 事件。 初始枚举完成后，它会在添加、删除或更新设备时引发事件。

注意

应用必须订阅所有 添加、 删除和 更新 的事件，才能在添加、删除或更新设备时收到通知。 如果应用仅处理 添加 的事件，则如果在初始设备枚举完成后将设备添加到系统，则它将不会收到更新。

有关示例，请参阅 DeviceWatcher 类。

另请参阅

• CreateWatcher()
• CreateWatcher(DeviceClass)
• CreateWatcher(String, IIterable<String>)

CreateWatcher(DeviceClass)

为与指定的 DeviceClass 匹配的设备创建 DeviceWatcher。

public:
 static DeviceWatcher ^ CreateWatcher(DeviceClass deviceClass);

/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("CreateWatcherDeviceClass")]
 static DeviceWatcher CreateWatcher(DeviceClass const& deviceClass);

[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("CreateWatcherDeviceClass")]
public static DeviceWatcher CreateWatcher(DeviceClass deviceClass);

function createWatcher(deviceClass)

Public Shared Function CreateWatcher (deviceClass As DeviceClass) As DeviceWatcher

参数

deviceClass

DeviceClass

要使用 DeviceWatcher 枚举的设备类。

返回

DeviceWatcher

创建的 DeviceWatcher。

属性

DefaultOverloadAttribute OverloadAttribute

注解

DeviceWatcher 首先执行设备的初始枚举，为其找到的每个设备引发 Added 事件，并在初始枚举完成时引发 EnumerationCompleted 事件。 初始枚举完成后，它会在添加、删除或更新设备时引发事件。

注意

应用必须订阅所有 添加、 删除和 更新 的事件，才能在添加、删除或更新设备时收到通知。 如果应用仅处理 添加 的事件，则如果在初始设备枚举完成后将设备添加到系统，则它将不会收到更新。

有关示例，请参阅 DeviceWatcher 类。

另请参阅

• CreateWatcher()
• CreateWatcher(String)
• CreateWatcher(String, IIterable<String>)

CreateWatcher(String, IIterable<String>)

为与指定的高级查询语法 (AQS) 字符串和指定的属性集合匹配的设备创建 DeviceWatcher 。

public:
 static DeviceWatcher ^ CreateWatcher(Platform::String ^ aqsFilter, IIterable<Platform::String ^> ^ additionalProperties);

/// [Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilterAndAdditionalProperties")]
 static DeviceWatcher CreateWatcher(winrt::hstring const& aqsFilter, IIterable<winrt::hstring> const& additionalProperties);

[Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilterAndAdditionalProperties")]
public static DeviceWatcher CreateWatcher(string aqsFilter, IEnumerable<string> additionalProperties);

function createWatcher(aqsFilter, additionalProperties)

Public Shared Function CreateWatcher (aqsFilter As String, additionalProperties As IEnumerable(Of String)) As DeviceWatcher

参数

aqsFilter

String

Platform::String

winrt::hstring

一个 AQS 字符串，用于筛选要枚举的 DeviceInformation 对象。 通常，此字符串是从与设备交互的类的 GetDeviceSelector 方法检索的。 例如， GetDeviceSelector 检索 StorageDevice 类的字符串。

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

要包含在枚举结果中 DeviceInformation 对象的 Properties 属性中的附加属性的可迭代列表。 有关属性表示的内容的详细信息，请参阅 设备信息属性。

返回

DeviceWatcher

创建的 DeviceWatcher。

属性

OverloadAttribute

注解

DeviceWatcher 首先执行设备的初始枚举，为其找到的每个设备引发 Added 事件，并在初始枚举完成时引发 EnumerationCompleted 事件。 初始枚举完成后，它会在添加、删除或更新设备时引发事件。

注意

应用必须订阅所有 添加、 删除和 更新 的事件，才能在添加、删除或更新设备时收到通知。 如果应用仅处理 添加 的事件，则如果在初始设备枚举完成后将设备添加到系统，则它将不会收到更新。

有关示例，请参阅 DeviceWatcher 类。

另请参阅

• CreateWatcher()
• CreateWatcher(DeviceClass)
• CreateWatcher(String)

CreateWatcher(String, IIterable<String>, DeviceInformationKind)

为与指定的高级查询语法 (AQS) 字符串、指定的属性集合和设备类型匹配的设备创建 DeviceWatcher 。

public:
 static DeviceWatcher ^ CreateWatcher(Platform::String ^ aqsFilter, IIterable<Platform::String ^> ^ additionalProperties, DeviceInformationKind kind);

/// [Windows.Foundation.Metadata.Overload("CreateWatcherWithKindAqsFilterAndAdditionalProperties")]
 static DeviceWatcher CreateWatcher(winrt::hstring const& aqsFilter, IIterable<winrt::hstring> const& additionalProperties, DeviceInformationKind const& kind);

[Windows.Foundation.Metadata.Overload("CreateWatcherWithKindAqsFilterAndAdditionalProperties")]
public static DeviceWatcher CreateWatcher(string aqsFilter, IEnumerable<string> additionalProperties, DeviceInformationKind kind);

function createWatcher(aqsFilter, additionalProperties, kind)

Public Shared Function CreateWatcher (aqsFilter As String, additionalProperties As IEnumerable(Of String), kind As DeviceInformationKind) As DeviceWatcher

参数

aqsFilter

String

Platform::String

winrt::hstring

一个 AQS 字符串，用于筛选要枚举的 DeviceInformation 对象。 通常，此字符串是从与设备交互的类的 GetDeviceSelector 方法检索的。 例如， GetDeviceSelector 检索 StorageDevice 类的字符串。

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

要包含在枚举结果中 DeviceInformation 对象的 Properties 属性中的附加属性的可迭代列表。 有关属性表示的内容的详细信息，请参阅 设备信息属性。

kind

DeviceInformationKind

DeviceWatcher 感兴趣的特定类型的设备。

返回

DeviceWatcher

创建的 DeviceWatcher。

属性

OverloadAttribute

另请参阅

• CreateWatcher()
• CreateWatcher(DeviceClass)
• CreateWatcher(String)
• CreateWatcher(String, IIterable<String>)