DeviceInformation.CreateWatcher 方法

定義

命名空間:

Windows.Devices.Enumeration

多載

CreateWatcher()	為所有裝置建立 DeviceWatcher 。
CreateWatcher(String)	為符合指定進階查詢語法的裝置建立 DeviceWatcher ， (AQS) 字串。
CreateWatcher(DeviceClass)	為符合指定DeviceClass的裝置建立DeviceWatcher。
CreateWatcher(String, IIterable<String>)	為符合指定進階查詢語法的裝置建立 DeviceWatcher ， (AQS) 字串和指定的屬性集合。
CreateWatcher(String, IIterable<String>, DeviceInformationKind)	為符合指定進階查詢語法的裝置建立 DeviceWatcher ， (AQS) 字串、屬性的指定集合，以及裝置的類型。

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)

為符合指定進階查詢語法的裝置建立 DeviceWatcher ， (AQS) 字串。

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>)

為符合指定進階查詢語法的裝置建立 DeviceWatcher ， (AQS) 字串和指定的屬性集合。

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)

為符合指定進階查詢語法的裝置建立 DeviceWatcher ， (AQS) 字串、屬性的指定集合，以及裝置的類型。

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>)