DeviceInformation.CreateWatcher Метод

Определение

Пространство имен:

Windows.Devices.Enumeration

Перегрузки

CreateWatcher()	Создает DeviceWatcher для всех устройств.
CreateWatcher(String)	Создает DeviceWatcher для устройств, соответствующих указанной строке расширенного синтаксиса запросов (AQS).
CreateWatcher(DeviceClass)	Создает DeviceWatcher для устройств, соответствующих указанному классу DeviceClass.
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. Чтобы создать DeviceWatcher из строки AQS в JavaScript, используйте перегрузку CreateWatcher(String, IIterable_1) и передайте null в качестве второго параметра.

DeviceWatcher сначала выполняет начальное перечисление устройств, вызывая событие Added для каждого найденного устройства и вызывая событие EnumerationCompleted после завершения начального перечисления. После завершения начального перечисления возникают события при добавлении, удалении или обновлении устройства.

Примечание

Приложение должно подписаться на все добавленные, удаленные и обновленные события, чтобы получать уведомления о добавлении, удалении или обновлении устройства. Если приложение обрабатывает только добавленное событие, оно не получит обновление, если устройство будет добавлено в систему после завершения начального перечисления устройств.

Пример см. в разделе Класс DeviceWatcher .

См. также раздел

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

CreateWatcher(DeviceClass)

Создает DeviceWatcher для устройств, соответствующих указанному классу DeviceClass.

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>

Итерируемый список дополнительных свойств для включения в свойство Properties объектов DeviceInformation в результатах перечисления. Дополнительные сведения о том, что представляют свойства, см. в разделе Свойства сведений об устройстве.

Возвращаемое значение

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>

Итерируемый список дополнительных свойств для включения в свойство Properties объектов DeviceInformation в результатах перечисления. Дополнительные сведения о том, что представляют свойства, см. в разделе Свойства сведений об устройстве.

kind

DeviceInformationKind

Конкретные типы устройств, которые интересуют DeviceWatcher .

Возвращаемое значение

DeviceWatcher

Созданный Объект DeviceWatcher.

Атрибуты

OverloadAttribute

См. также раздел

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