Fragment.RequestPermissions(String[], Int32) メソッド

定義

名前空間:: Android.App

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

このアプリケーションに付与するアクセス許可を要求します。

[Android.Runtime.Register("requestPermissions", "([Ljava/lang/String;I)V", "", ApiSince=23)]
public void RequestPermissions(string[] permissions, int requestCode);

[<Android.Runtime.Register("requestPermissions", "([Ljava/lang/String;I)V", "", ApiSince=23)>]
member this.RequestPermissions : string[] * int -> unit

パラメーター

permissions: String[]

要求されたアクセス許可。 null 以外で空ではない必要があります。

requestCode: Int32

#onRequestPermissionsResult(int, String[], int[])に報告された結果と一致するアプリケーション固有の要求コード。 >= 0 にする必要があります。

属性: RegisterAttribute

注釈

このアプリケーションに付与するアクセス許可を要求します。これらのアクセス許可は、マニフェストで要求する必要があります。アプリに付与する必要はありません。また、プラットフォームまたはサードパーティのアプリによって宣言されているかどうかに関係なく、保護レベルPROTECTION_DANGEROUS危険である必要があります。 PermissionInfo.PROTECTION_NORMAL通常のアクセス許可は、マニフェストで要求された場合、インストール時に付与されます。マニフェストで要求され、アプリの署名がアクセス許可を宣言するアプリの署名と一致する場合、PermissionInfo.PROTECTION_SIGNATURE署名アクセス許可はインストール時に付与されます。

この API を呼び出す前に shouldShowRequestPermissionRationale(String) を呼び出して、システムがアクセス許可を要求する前に論理的な UI を表示することを推奨しているかどうかを確認します。

アプリに要求されたアクセス許可がない場合、ユーザーはそれらを受け入れるための UI が表示されます。ユーザーが要求されたアクセス許可を受け入れるか拒否した後、アクセス許可が付与されたかどうかを報告する onRequestPermissionsResult(int,String[],int[]) のコールバックを受け取ります。

アクセス許可を要求しても、アクセス許可が付与されるとは限らず、アプリはこのアクセス許可を持たずに実行できる必要があることに注意してください。

このメソッドは、付与するアクセス許可と拒否するアクセス許可をユーザーが選択できるようにするアクティビティを開始できます。そのため、アクティビティを一時停止して再開できるように準備する必要があります。さらに、一部のアクセス許可を付与するには、アプリケーションの再起動が必要になる場合があります。このような場合、システムは結果を onRequestPermissionsResult(int,String[],int[],int[]) に配信する前に、アクティビティスタックを再作成します。

アクセス許可があるかどうかを確認するときは、android.content.Context.checkSelfPermission(String) を使用する必要があります。

アプリに既に付与されているアクセス許可に対してこの API を呼び出すと、ユーザーに UI が表示され、アプリがこれらのアクセス許可を引き続き保持できるかどうかを判断できます。これは、アクセス許可によって保護されたデータをアプリで使用する方法が大幅に変更される場合に役立ちます。

アクティビティが noHistory を true に設定した場合、アクセス許可を要求できません。この場合、アクティビティは onRequestPermissionsResult(int,String[],int[],int[]) を含む結果コールバックを受け取らないためです。

適用対象