Partager via

SubscriptionManager.GetPhoneNumber Méthode

  • Référence

Définition

Espace de noms:
Android.Telephony
Assembly:
Mono.Android.dll

Surcharges

GetPhoneNumber(Int32)

Retourne le numéro de téléphone pour le numéro de téléphone donné subIdou une chaîne vide si elle n’est pas disponible.
GetPhoneNumber(Int32, Int32)

Retourne le numéro de téléphone pour le numéro de téléphone donné subscriptionId et source, ou une chaîne vide si elle n’est pas disponible.

GetPhoneNumber(Int32)

Retourne le numéro de téléphone pour le numéro de téléphone donné subIdou une chaîne vide si elle n’est pas disponible.

[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

Paramètres

subscriptionId
Int32

l’ID d’abonnement, ou #DEFAULT_SUBSCRIPTION_ID pour le numéro par défaut.

Retours

String

le numéro de téléphone ou une chaîne vide s’il n’est pas disponible.

Attributs
RegisterAttribute

Remarques

Retourne le numéro de téléphone pour le numéro de téléphone donné subIdou une chaîne vide si elle n’est pas disponible.

Cette API convient aux applications générales qui doivent connaître le numéro de téléphone. Pour des applications spécifiques qui doivent connaître le numéro de téléphone fourni par une source spécifique, #getPhoneNumber(int, int) peuvent convenir.

Cette API est basée sur #getPhoneNumber(int, int), mais sélectionne parmi les sources disponibles dans l’ordre suivant : #PHONE_NUMBER_SOURCE_CARRIER>#PHONE_NUMBER_SOURCE_UICC>#PHONE_NUMBER_SOURCE_IMS

L’API ne fournit aucune garantie quant au format dans lequel se trouve le nombre : le format peut varier en fonction de la source sous-jacente et du réseau, etc. L’analyse programmatique doit être effectuée avec prudence, par exemple après avoir mis en forme le nombre dans un format cohérent avec android.telephony.PhoneNumberUtils#formatNumberToE164(String, String).

La disponibilité et la correction du numéro de téléphone dépendent de la source sous-jacente et du réseau, etc. Une vérification supplémentaire est nécessaire pour utiliser ce numéro pour des scénarios sensibles ou liés à la sécurité.

Documentation Java pour android.telephony.SubscriptionManager.getPhoneNumber(int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à

GetPhoneNumber(Int32, Int32)

Retourne le numéro de téléphone pour le numéro de téléphone donné subscriptionId et source, ou une chaîne vide si elle n’est pas disponible.

[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

Paramètres

subscriptionId
Int32

l’ID d’abonnement, ou #DEFAULT_SUBSCRIPTION_ID pour le numéro par défaut.

source
Int32

source du numéro de téléphone, l’une des constantes PHONE_NUMBER_SOURCE_*.

Retours

String

le numéro de téléphone ou une chaîne vide s’il n’est pas disponible.

Attributs
RegisterAttribute

Remarques

Retourne le numéro de téléphone pour le numéro de téléphone donné subscriptionId et source, ou une chaîne vide si elle n’est pas disponible.

Les applications générales qui doivent connaître le numéro de téléphone doivent être utilisées #getPhoneNumber(int) à la place. Cette API peut convenir à des applications spécifiques qui doivent connaître le numéro de téléphone d’une source spécifique. Par exemple, une application opérateur doit savoir exactement ce qui est activé #PHONE_NUMBER_SOURCE_UICC UICC et décider si le numéro de #PHONE_NUMBER_SOURCE_CARRIER carrier téléphone défini précédemment doit être mis à jour.

L’API ne fournit aucune garantie quant au format dans lequel se trouve le nombre : le format peut varier en fonction du source réseau et du réseau, etc. L’analyse programmatique doit être effectuée avec prudence, par exemple, après avoir mis en forme le nombre dans un format cohérent avec android.telephony.PhoneNumberUtils#formatNumberToE164(String, String).

Notez que l’hypothèse est qu’un abonnement (ce qui signifie généralement qu’un sim) n’a qu’un seul numéro de téléphone. Les plusieurs sources se sauvegardent l’une l’autre de sorte qu’au moins une est disponible. Par exemple, pour un opérateur qui ne définit généralement pas de numéros de téléphone sur #PHONE_NUMBER_SOURCE_UICC UICC, la source #PHONE_NUMBER_SOURCE_IMS IMS peut en fournir un. Ou bien, un opérateur peut décider de fournir le numéro de téléphone via la source #PHONE_NUMBER_SOURCE_CARRIER carrier si ni l’UICC source ni IMS n’est disponible.

La disponibilité et la correction du numéro de téléphone dépendent de la source sous-jacente et du réseau, etc. Une vérification supplémentaire est nécessaire pour utiliser ce numéro pour des scénarios sensibles ou liés à la sécurité.

Documentation Java pour android.telephony.SubscriptionManager.getPhoneNumber(int, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à