SubscriptionManager.GetPhoneNumber 方法

定義

命名空間:

Android.Telephony

組件:

Mono.Android.dll

多載

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

訂用帳戶標識碼，或 #DEFAULT_SUBSCRIPTION_ID 預設標識符。

傳回

String

電話號碼，如果無法使用，則為空字串。

屬性

RegisterAttribute

備註

傳回指定 subId之的電話號碼，如果無法使用，則傳回空字串。

此 API 適用於需要知道電話號碼的一般應用程式。 對於需要知道特定來源所提供電話號碼的特定應用程式， #getPhoneNumber(int, int) 可能適用。

此 API 建置在 上#getPhoneNumber(int, int)，但會依下列順序從可用的來源挑選：>#PHONE_NUMBER_SOURCE_IMS#PHONE_NUMBER_SOURCE_UICC#PHONE_NUMBER_SOURCE_CARRIER>。

API 不保證數位的格式為何：格式可能會根據基礎來源和網路等而有所不同。以程式設計方式剖析應該謹慎執行，例如，將數位格式化為與 android.telephony.PhoneNumberUtils#formatNumberToE164(String, String)一致的格式之後。

電話號碼的可用性和正確性取決於基礎來源和網路等。需要額外的驗證，才能將此號碼用於安全性相關或其他敏感性案例。

的 android.telephony.SubscriptionManager.getPhoneNumber(int)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

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

訂用帳戶標識碼，或 #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)一致的格式之後。

請注意，假設一個訂用帳戶（通常表示一個 SIM 卡）只有一個電話號碼。 多個來源彼此備份，因此希望至少有一個可用。 例如，對於通常未在 上 #PHONE_NUMBER_SOURCE_UICC UICC設定電話號碼的電信業者，來源 #PHONE_NUMBER_SOURCE_IMS IMS 可能會提供電話號碼。 或者，如果來源 UICC 和 IMS 都無法使用，電信業者可能會決定透過來源 #PHONE_NUMBER_SOURCE_CARRIER carrier 提供電話號碼。

電話號碼的可用性和正確性取決於基礎來源和網路等。需要額外的驗證，才能將此號碼用於安全性相關或其他敏感性案例。

的 android.telephony.SubscriptionManager.getPhoneNumber(int, int)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。