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

列挙する DeviceInformation オブジェクトをフィルター処理する AQS 文字列。 通常、この文字列は、デバイスと対話するクラスの GetDeviceSelector メソッドから取得されます。 たとえば、 GetDeviceSelector は StorageDevice クラスの文字列を取得します。

戻り値

DeviceWatcher

作成された DeviceWatcher。

属性

OverloadAttribute

注釈

注意

このオーバーロードは JavaScript からは使用できません。 JavaScript の AQS 文字列から DeviceWatcher を作成するには、 CreateWatcher(String, IIterable_1) オーバーロードを使用し、2 番目のパラメーターとして を渡 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

列挙する DeviceInformation オブジェクトをフィルター処理する AQS 文字列。 通常、この文字列は、デバイスと対話するクラスの 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

列挙する DeviceInformation オブジェクトをフィルター処理する AQS 文字列。 通常、この文字列は、デバイスと対話するクラスの 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>)