SubscriptionManager.GetPhoneNumber メソッド

定義

名前空間:: Android.Telephony

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

重要

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

オーバーロード

名前	説明
GetPhoneNumber(Int32)	指定した `subId`の電話番号を返します。使用できない場合は空の文字列を返します。
GetPhoneNumber(Int32, Int32)	指定した `subscriptionId` と `source`の電話番号を返します。使用できない場合は空の文字列を返します。

GetPhoneNumber(Int32)

指定した subIdの電話番号を返します。使用できない場合は空の文字列を返します。

[Android.Runtime.Register("getPhoneNumber", "(I)Ljava/lang/String;", "GetGetPhoneNumber_IHandler", ApiSince=33)]
public virtual string GetPhoneNumber(int subscriptionId);

[<Android.Runtime.Register("getPhoneNumber", "(I)Ljava/lang/String;", "GetGetPhoneNumber_IHandler", ApiSince=33)>]
abstract member GetPhoneNumber : int -> string
override this.GetPhoneNumber : int -> string

パラメーター

subscriptionId: Int32

サブスクリプション ID、または既定の ID の #DEFAULT_SUBSCRIPTION_ID 。

返品

String

電話番号、または空の文字列 (使用できない場合)。

属性: RegisterAttribute

注釈

指定した subIdの電話番号を返します。使用できない場合は空の文字列を返します。

この API は、電話番号を知る必要がある一般的なアプリに適しています。特定のソースによって提供される電話番号を知る必要がある特定のアプリの場合、 #getPhoneNumber(int, int) が適している可能性があります。

この API は #getPhoneNumber(int, int)に基づいて構築されていますが、使用可能なソースから次の順序で選択します: #PHONE_NUMBER_SOURCE_CARRIER>#PHONE_NUMBER_SOURCE_UICC>#PHONE_NUMBER_SOURCE_IMS。

この API では、数値の形式は保証されません。形式は、基になるソースやネットワークなどによって異なる場合があります。プログラムによる解析は、たとえば、数値を android.telephony.PhoneNumberUtils#formatNumberToE164(String, String) で一貫した形式に書式設定した後など、慎重に行う必要があります。

電話番号の可用性と正確性は、基になるソースやネットワークなどによって異なります。セキュリティ関連またはその他の機密性の高いシナリオでこの番号を使用するには、追加の検証が必要です。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

GetPhoneNumber(Int32, Int32)

指定した subscriptionId と sourceの電話番号を返します。使用できない場合は空の文字列を返します。

[Android.Runtime.Register("getPhoneNumber", "(II)Ljava/lang/String;", "GetGetPhoneNumber_IIHandler", ApiSince=33)]
public virtual string GetPhoneNumber(int subscriptionId, int source);

[<Android.Runtime.Register("getPhoneNumber", "(II)Ljava/lang/String;", "GetGetPhoneNumber_IIHandler", ApiSince=33)>]
abstract member GetPhoneNumber : int * int -> string
override this.GetPhoneNumber : int * int -> string

パラメーター

subscriptionId: Int32

サブスクリプション ID、または既定の ID の #DEFAULT_SUBSCRIPTION_ID 。

source: Int32

電話番号のソース。PHONE_NUMBER_SOURCE_* 定数のいずれか。

返品

String

電話番号、または空の文字列 (使用できない場合)。

属性: RegisterAttribute

注釈

指定した subscriptionId と sourceの電話番号を返します。使用できない場合は空の文字列を返します。

電話番号を知る必要がある一般的なアプリでは、代わりに #getPhoneNumber(int) を使用する必要があります。この API は、特定のソースからの電話番号を知る必要がある特定のアプリに適している場合があります。たとえば、通信事業者アプリでは、 #PHONE_NUMBER_SOURCE_UICC UICC の内容を正確に把握し、以前に設定したソース #PHONE_NUMBER_SOURCE_CARRIER carrier の電話番号を更新する必要があるかどうかを判断する必要があります。

この API では、数値の形式は保証されません。形式は、 source やネットワークなどによって異なる場合があります。プログラムによる解析は、たとえば、 android.telephony.PhoneNumberUtils#formatNumberToE164(String, String)で一貫した形式に書式設定した後など、慎重に行う必要があります。

1 つのサブスクリプション (通常は 1 つの SIM を意味) に電話番号が 1 つしかないことを前提としています。複数のソースが互いにバックアップするため、少なくとも 1 つを使用できます。たとえば、通常、 #PHONE_NUMBER_SOURCE_UICC UICCに電話番号を設定しない通信事業者の場合、ソース #PHONE_NUMBER_SOURCE_IMS IMS が電話番号を提供する場合があります。または、ソース UICC と IMS のどちらも使用できない場合は、通信事業者がソース #PHONE_NUMBER_SOURCE_CARRIER carrier 経由で電話番号を指定することを決定できます。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象