ContextWrapper.RegisterReceiver Метод

Определение

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

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

Важно!

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

Перегрузки

Имя	Описание
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags)	Устаревшие. Зарегистрируйтесь для получения трансляций намерений, чтобы запуститься в контексте планировщика. Дополнительные сведения см. в разделе registerReceiver(BroadcastReceiver,IntentFilter,int) и registerReceiver(BroadcastReceiver,IntentFilter,String,Handler). Дополнительные сведения о трансляциях намерений см. в разделе BroadcastReceiver. По состоянию на Build.VERSION_CODES. UPSIDE_DOWN_CAKE система может размещать зарегистрированные в контексте трансляции в очереди, пока приложение находится в кэшированном состоянии. Когда приложение покидает кэшированное состояние, например возвращение на передний план, система предоставляет все очереди трансляций. Несколько экземпляров определенных широковещательных трансляций могут быть объединены в одну трансляцию. По состоянию на Build.VERSION_CODES. ICE_CREAM_SANDWICH, получатели, зарегистрированные в этом методе, правильно уважают объект Intent.setPackage(String), указанный для трансляции намерения. До этого он будет игнорироваться и доставляться всем соответствующим зарегистрированным получателям. Будьте осторожны, если это используется для безопасности. Приемник параметров BroadcastReceiver: это значение может иметь значение NULL.
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)	Зарегистрируйтесь для получения трансляций намерений, чтобы запуститься в контексте планировщика <>или<var>.
RegisterReceiver(BroadcastReceiver, IntentFilter)	Зарегистрируйте широковещательныйreceiver для запуска в основном потоке действий.
RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)	Устаревшие. Зарегистрируйтесь для передачи намерений, при этом получатель при необходимости предоставляется мгновенным приложениям. Дополнительные сведения см. в разделе registerReceiver(BroadcastReceiver,IntentFilter). По умолчанию мгновенные приложения не могут взаимодействовать с приемниками в других приложениях, это позволяет предоставлять получателю, с которыми могут взаимодействовать мгновенные приложения. Дополнительные сведения о трансляциях намерений см. в разделе BroadcastReceiver. По состоянию на Build.VERSION_CODES. UPSIDE_DOWN_CAKE система может размещать зарегистрированные в контексте трансляции в очереди, пока приложение находится в кэшированном состоянии. Когда приложение покидает кэшированное состояние, например возвращение на передний план, система предоставляет все очереди трансляций. Несколько экземпляров определенных широковещательных трансляций могут быть объединены в одну трансляцию. По состоянию на Build.VERSION_CODES. ICE_CREAM_SANDWICH, получатели, зарегистрированные в этом методе, правильно уважают объект Intent.setPackage(String), указанный для трансляции намерения. До этого он будет игнорироваться и доставляться всем соответствующим зарегистрированным получателям. Будьте осторожны, если это используется для безопасности. Приемник параметров BroadcastReceiver: это значение может иметь значение NULL.

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags)

Внимание!

This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.

Зарегистрируйтесь для получения трансляций намерений, чтобы запуститься в контексте планировщика. Дополнительные сведения см. в разделе registerReceiver(BroadcastReceiver,IntentFilter,int) и registerReceiver(BroadcastReceiver,IntentFilter,String,Handler). Дополнительные сведения о трансляциях намерений см. в разделе BroadcastReceiver. По состоянию на Build.VERSION_CODES. UPSIDE_DOWN_CAKE система может размещать зарегистрированные в контексте трансляции в очереди, пока приложение находится в кэшированном состоянии. Когда приложение покидает кэшированное состояние, например возвращение на передний план, система предоставляет все очереди трансляций. Несколько экземпляров определенных широковещательных трансляций могут быть объединены в одну трансляцию. По состоянию на Build.VERSION_CODES. ICE_CREAM_SANDWICH, получатели, зарегистрированные в этом методе, правильно уважают объект Intent.setPackage(String), указанный для трансляции намерения. До этого он будет игнорироваться и доставляться всем соответствующим зарегистрированным получателям. Будьте осторожны, если это используется для безопасности. Приемник параметров BroadcastReceiver: это значение может иметь значение NULL.

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_IHandler", ApiSince=26)]
[System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")]
public override Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, string? broadcastPermission, Android.OS.Handler? scheduler, Android.Content.ActivityFlags flags);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_IHandler", ApiSince=26)>]
[<System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler * Android.Content.ActivityFlags -> Android.Content.Intent

Параметры

receiver: BroadcastReceiver

Приемник широковещательной трансляции, который необходимо зарегистрировать.

filter: IntentFilter

Фильтр намерений, который выбирает трансляции для получения.

broadcastPermission: String

Имя разрешения, которое должен хранить вещатель для отправки намерения этому получателю. Если значение NULL, разрешение не требуется.

scheduler: Handler

Обработчик, на котором выполняются обратные вызовы приемника.

flags: ActivityFlags

Флаги, управляющие этой операцией.

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

Intent

Первое липкое намерение показало, что соответствует фильтру или null, если нет.

Атрибуты: RegisterAttribute ObsoleteAttribute

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

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)

Зарегистрируйтесь для получения трансляций намерений, чтобы запуститься в контексте планировщика <>или<var>.

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_Handler")]
public override Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, string? broadcastPermission, Android.OS.Handler? scheduler);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_Handler")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler -> Android.Content.Intent

Параметры

receiver: BroadcastReceiver

Широковещательныйreceiver для обработки трансляции.

filter: IntentFilter

Выбирает передачу намерений, которые будут получены.

broadcastPermission: String

scheduler: Handler

Обработчик, определяющий поток, который получит намерение. Если значение NULL, будет использоваться основной поток процесса.

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

Intent

Первое липкое намерение показало, что соответствует фильтру или null, если нет.

Атрибуты: RegisterAttribute

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

RegisterReceiver(BroadcastReceiver, IntentFilter)

Зарегистрируйте широковещательныйreceiver для запуска в основном потоке действий.

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Handler")]
public override Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Handler")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter -> Android.Content.Intent

Параметры

receiver: BroadcastReceiver

Широковещательныйreceiver для обработки трансляции.

filter: IntentFilter

Выбирает передачу намерений, которые будут получены.

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

Intent

Зарегистрируйте широковещательныйreceiver для запуска в основном потоке действий. Получатель будет вызываться с любым широковещательным намерением, которое соответствует фильтру в основном потоке приложения. Система может транслировать намерения, которые являются "липкими" - они остаются вокруг после завершения трансляции, чтобы отправляться в любые последующие регистрации. Если ваш IntentFilter соответствует одному из этих липких намерений, это намерение будет возвращено этой функцией и отправлено получателю, как если бы он только что был широковещательным. Существует несколько липких намерений, которые соответствуют фильтру, в этом случае каждый из них будет отправлен получателю. В этом случае только одно из них может быть возвращено непосредственно функцией; какое из возвращаемых объектов произвольно определяется системой. Если вы знаете, что намерение, для которых вы регистрируетесь, является липким, вы можете указать значение NULL для получателя. В этом случае получатель не зарегистрирован - функция просто возвращает липкое намерение, соответствующее фильтру. В случае нескольких совпадений применяются те же правила, что и описанные выше. Дополнительные сведения о трансляциях намерений см. в разделе BroadcastReceiver. По состоянию на Build.VERSION_CODES. UPSIDE_DOWN_CAKE система может размещать зарегистрированные в контексте трансляции в очереди, пока приложение находится в кэшированном состоянии. Когда приложение покидает кэшированное состояние, например возвращение на передний план, система предоставляет все очереди трансляций. Несколько экземпляров определенных широковещательных трансляций могут быть объединены в одну трансляцию. По состоянию на Build.VERSION_CODES. ICE_CREAM_SANDWICH, получатели, зарегистрированные в этом методе, правильно уважают объект Intent.setPackage(String), указанный для трансляции намерения. До этого он будет игнорироваться и доставляться всем соответствующим зарегистрированным получателям. Будьте осторожны, если это используется для безопасности. Для приложений, предназначенных для Build.VERSION_CODES. UPSIDE_DOWN_CAKE, RECEIVER_EXPORTED или RECEIVER_NOT_EXPORTED необходимо указать, если получатель не зарегистрирован для системных трансляций или будет создано исключение SecurityException. Чтобы зарегистрировать приемник с флагами, см. раздел registerReceiver(BroadcastReceiver,IntentFilter,int). Примечание. Этот метод не может вызываться из компонента BroadcastReceiver; т. е. из broadcastReceiver, объявленного в манифесте приложения. Однако это нормально, чтобы вызвать этот метод из другого широковещательногоReceiver, который сам был зарегистрирован во время выполнения с помощью registerReceiver(BroadcastReceiver, IntentFilter), с момента существования такого зарегистрированного широковещательногоReceiver привязан к объекту, зарегистрированному в нем. Приемник параметров BroadcastReceiver: это значение может иметь значение NULL. filter IntentFilter: выбирает получаемые трансляции намерений. Возвращает намерение Первое липкое намерение, которое соответствует фильтру или null, если нет.

Атрибуты: RegisterAttribute

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

RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)

Внимание!

This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.

Зарегистрируйтесь для передачи намерений, при этом получатель при необходимости предоставляется мгновенным приложениям. Дополнительные сведения см. в разделе registerReceiver(BroadcastReceiver,IntentFilter). По умолчанию мгновенные приложения не могут взаимодействовать с приемниками в других приложениях, это позволяет предоставлять получателю, с которыми могут взаимодействовать мгновенные приложения. Дополнительные сведения о трансляциях намерений см. в разделе BroadcastReceiver. По состоянию на Build.VERSION_CODES. UPSIDE_DOWN_CAKE система может размещать зарегистрированные в контексте трансляции в очереди, пока приложение находится в кэшированном состоянии. Когда приложение покидает кэшированное состояние, например возвращение на передний план, система предоставляет все очереди трансляций. Несколько экземпляров определенных широковещательных трансляций могут быть объединены в одну трансляцию. По состоянию на Build.VERSION_CODES. ICE_CREAM_SANDWICH, получатели, зарегистрированные в этом методе, правильно уважают объект Intent.setPackage(String), указанный для трансляции намерения. До этого он будет игнорироваться и доставляться всем соответствующим зарегистрированным получателям. Будьте осторожны, если это используется для безопасности. Приемник параметров BroadcastReceiver: это значение может иметь значение NULL.

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_IHandler", ApiSince=26)]
[System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")]
public override Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, Android.Content.ActivityFlags flags);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_IHandler", ApiSince=26)>]
[<System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * Android.Content.ActivityFlags -> Android.Content.Intent

Параметры

receiver: BroadcastReceiver

Приемник широковещательной трансляции, который необходимо зарегистрировать.

filter: IntentFilter

Фильтр намерений, который выбирает трансляции для получения.

flags: ActivityFlags

Флаги, управляющие этой операцией.

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

Intent

Первое липкое намерение показало, что соответствует фильтру или null, если нет.

Атрибуты: RegisterAttribute ObsoleteAttribute

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

ContextWrapper.RegisterReceiver Метод

Определение

Перегрузки

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags)

Параметры

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

Комментарии

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

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)

Параметры

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

Комментарии

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

RegisterReceiver(BroadcastReceiver, IntentFilter)

Параметры

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

Комментарии

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

RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)

Параметры

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

Комментарии

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