ContextWrapper.StartService(Intent) Метод

Определение

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

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Запрос на запуск данной службы приложений.

[Android.Runtime.Register("startService", "(Landroid/content/Intent;)Landroid/content/ComponentName;", "GetStartService_Landroid_content_Intent_Handler")]
public override Android.Content.ComponentName? StartService(Android.Content.Intent? service);

[<Android.Runtime.Register("startService", "(Landroid/content/Intent;)Landroid/content/ComponentName;", "GetStartService_Landroid_content_Intent_Handler")>]
override this.StartService : Android.Content.Intent -> Android.Content.ComponentName

Параметры

service: Intent

Определяет службу, которая должна быть запущена. Намерение должно быть полностью явным (указание имени компонента) или указать определенное имя пакета, в который он предназначен. Дополнительные значения могут быть включены в дополнительные сведения о намерении для предоставления аргументов вместе с этим конкретным начальным вызовом.

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

ComponentName

Запрос на запуск данной службы приложений. Намерение должно содержать полное имя класса для запуска определенной реализации службы или конкретное имя пакета для целевого объекта. Если намерение меньше указано, он регистрирует предупреждение об этом. В этом случае может использоваться любой из нескольких соответствующих служб. Если эта служба еще не запущена, она будет создана и запущена (при необходимости создайте для нее процесс); Если он запущен, он остается запущенным. Каждый вызов этого метода приведет к соответствующему вызову метода Service.onStartCommand(Intent, int, int) с намерением, указанным здесь. Это обеспечивает удобный способ отправки заданий в службу без привязки и вызова к интерфейсу. При использовании startService() переопределяет время существования службы по умолчанию, управляемое bindService(Intent, BindServiceFlags, Executor, ServiceConnection). Служба должна оставаться запущенной до вызова stopService(Намерение), независимо от того, подключены ли к нему какие-либо клиенты. Обратите внимание, что вызовы startService() не вложены: независимо от того, сколько раз вы вызываете startService(), один вызов stopService(Намерение) остановит его. Система пытается обеспечить максимальное количество выполняемых служб. Единственное время их остановки — если текущее приложение переднего плана использует так много ресурсов, что служба должна быть убита. Если в процессе службы возникают какие-либо ошибки, она будет автоматически перезапущена. Эта функция создает исключение SecurityException, если у вас нет разрешения на запуск данной службы. Примечание. Каждый вызов startService() приводит к значительной работе системы для управления жизненным циклом службы, окружающим обработку намерения, что может занять несколько миллисекундах времени ЦП. Из-за этой стоимости startService() не следует использовать для частой доставки намерений в службу и только для планирования значительной работы. Используйте привязанные службы для вызовов высокой частоты. Начиная с версии пакета SDK Build.VERSION_CODES. O , приложения, предназначенные для пакета SDK версии Build.VERSION_CODES. Не разрешено запускать фоновые службы из фонового режима. Дополнительные сведения см. в разделе "Ограничения фонового выполнения". Примечание. Начиная с версии пакета SDK Build.VERSION_CODES. S, приложения, предназначенные для версии пакета SDK Build.VERSION_CODES. Не разрешено запускать службы переднего плана из фонового режима. Дополнительные сведения см. в статье "Изменения в поведении: приложения, предназначенные для Android 12". Намерение службы параметров: определяет запущенную службу. Намерение должно быть полностью явным (указание имени компонента). Дополнительные значения могут быть включены в дополнительные сведения о намерении для предоставления аргументов вместе с этим конкретным начальным вызовом. Возвращает имя компонента Это значение может иметь значение NULL.

Атрибуты: RegisterAttribute

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