Поделиться через


DeviceInformation.CreateWatcher Метод

Определение

Перегрузки

CreateWatcher()

Создает DeviceWatcher для всех устройств.

CreateWatcher(String)

Создает DeviceWatcher для устройств, соответствующих указанной строке расширенного синтаксиса запросов (AQS).

CreateWatcher(DeviceClass)

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

CreateWatcher(String, IIterable<String>)

Создает DeviceWatcher для устройств, соответствующих указанной строке расширенного синтаксиса запросов (AQS) и указанной коллекции свойств.

CreateWatcher(String, IIterable<String>, DeviceInformationKind)

Создает DeviceWatcher для устройств, соответствующих указанной строке расширенного синтаксиса запросов (AQS), указанной коллекции свойств и типу устройств.

CreateWatcher(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)

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 сначала выполняет начальное перечисление устройств, вызывая событие Added для каждого найденного устройства и вызывая событие EnumerationCompleted после завершения начального перечисления. После завершения начального перечисления возникают события при добавлении, удалении или обновлении устройства.

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

Примечание

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

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

Применяется к

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.

Атрибуты

Комментарии

Примечание

Эта перегрузка недоступна в JavaScript. Чтобы создать DeviceWatcher из строки AQS в JavaScript, используйте перегрузку CreateWatcher(String, IIterable_1) и передайте null в качестве второго параметра.

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

Примечание

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

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

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

Применяется к

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 сначала выполняет начальное перечисление устройств, вызывая событие Added для каждого найденного устройства и вызывая событие EnumerationCompleted после завершения начального перечисления. После завершения начального перечисления возникают события при добавлении, удалении или обновлении устройства.

Примечание

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

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

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

Применяется к

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 сначала выполняет начальное перечисление устройств, вызывая событие Added для каждого найденного устройства и вызывая событие EnumerationCompleted после завершения начального перечисления. После завершения начального перечисления возникают события при добавлении, удалении или обновлении устройства.

Примечание

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

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

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

Применяется к

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.

Атрибуты

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

Применяется к

CreateWatcher(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)

public:
 static DeviceWatcher ^ CreateWatcher(Platform::String ^ aqsFilter, IIterable<Platform::String ^> ^ additionalProperties, DeviceInformationKind kind, IDeviceEnumerationSettings ^ settings);
/// [Windows.Foundation.Metadata.Overload("CreateWatcherWithAqsFilterAdditionalPropertiesKindAndSettings")]
 static DeviceWatcher CreateWatcher(winrt::hstring const& aqsFilter, IIterable<winrt::hstring> const& additionalProperties, DeviceInformationKind const& kind, IDeviceEnumerationSettings const& settings);
[Windows.Foundation.Metadata.Overload("CreateWatcherWithAqsFilterAdditionalPropertiesKindAndSettings")]
public static DeviceWatcher CreateWatcher(string aqsFilter, IEnumerable<string> additionalProperties, DeviceInformationKind kind, IDeviceEnumerationSettings settings);
function createWatcher(aqsFilter, additionalProperties, kind, settings)
Public Shared Function CreateWatcher (aqsFilter As String, additionalProperties As IEnumerable(Of String), kind As DeviceInformationKind, settings As IDeviceEnumerationSettings) As DeviceWatcher

Параметры

aqsFilter
String

Platform::String

winrt::hstring

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

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

Атрибуты

Применяется к