Freigeben über


SubscriptionManager.GetPhoneNumber Methode

Definition

Überlädt

GetPhoneNumber(Int32)

Gibt die Telefonnummer für das angegebene subIdOder eine leere Zeichenfolge zurück, falls nicht verfügbar.

GetPhoneNumber(Int32, Int32)

Gibt die Telefonnummer für die angegebene subscriptionId und source, oder eine leere Zeichenfolge zurück, falls nicht verfügbar.

GetPhoneNumber(Int32)

Gibt die Telefonnummer für das angegebene subIdOder eine leere Zeichenfolge zurück, falls nicht verfügbar.

[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

Parameter

subscriptionId
Int32

die Abonnement-ID oder #DEFAULT_SUBSCRIPTION_ID für die Standard-ID.

Gibt zurück

die Telefonnummer oder eine leere Zeichenfolge, falls nicht verfügbar.

Attribute

Hinweise

Gibt die Telefonnummer für das angegebene subIdOder eine leere Zeichenfolge zurück, falls nicht verfügbar.

Diese API eignet sich für allgemeine Apps, die die Telefonnummer kennen müssen. Für bestimmte Apps, die die von einer bestimmten Quelle bereitgestellte Telefonnummer kennen müssen, #getPhoneNumber(int, int) kann dies geeignet sein.

Diese API basiert auf #getPhoneNumber(int, int), wählt aber aus verfügbaren Quellen in der folgenden Reihenfolge aus: #PHONE_NUMBER_SOURCE_CARRIER>#PHONE_NUMBER_SOURCE_UICC>#PHONE_NUMBER_SOURCE_IMS

Die API bietet keine Garantien dafür, in welchem Format sich die Zahl befindet: Das Format kann je nach zugrunde liegender Quelle und dem Netzwerk usw. variieren. Die programmgesteuerte Analyse sollte z. B. nach dem Formatieren der Zahl in ein konsistentes Format android.telephony.PhoneNumberUtils#formatNumberToE164(String, String)vorsichtig erfolgen.

Die Verfügbarkeit und Richtigkeit der Telefonnummer hängt von der zugrunde liegenden Quelle und dem Netzwerk usw. ab. Um diese Nummer für sicherheitsbezogene oder andere vertrauliche Szenarien zu verwenden, ist eine zusätzliche Überprüfung erforderlich.

Java-Dokumentation für android.telephony.SubscriptionManager.getPhoneNumber(int).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

GetPhoneNumber(Int32, Int32)

Gibt die Telefonnummer für die angegebene subscriptionId und source, oder eine leere Zeichenfolge zurück, falls nicht verfügbar.

[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

Parameter

subscriptionId
Int32

die Abonnement-ID oder #DEFAULT_SUBSCRIPTION_ID für die Standard-ID.

source
Int32

die Quelle der Telefonnummer, eine der PHONE_NUMBER_SOURCE_*-Konstanten.

Gibt zurück

die Telefonnummer oder eine leere Zeichenfolge, falls nicht verfügbar.

Attribute

Hinweise

Gibt die Telefonnummer für die angegebene subscriptionId und source, oder eine leere Zeichenfolge zurück, falls nicht verfügbar.

Allgemeine Apps, die die Telefonnummer kennen müssen, sollten stattdessen verwendet werden #getPhoneNumber(int) . Diese API eignet sich möglicherweise für bestimmte Apps, die die Telefonnummer aus einer bestimmten Quelle kennen müssen. Beispielsweise muss eine Netzbetreiber-App genau wissen, worum es geht #PHONE_NUMBER_SOURCE_UICC UICC , und entscheiden, ob die zuvor festgelegte Telefonnummer der Quelle #PHONE_NUMBER_SOURCE_CARRIER carrier aktualisiert werden soll.

Die API bietet keine Garantien dafür, in welchem Format sich die Zahl befindet: Das Format kann je nach Netzwerk source usw. programmgesteuert analysiert werden, z. B. nach dem Formatieren der Zahl in ein konsistentes Format mit android.telephony.PhoneNumberUtils#formatNumberToE164(String, String).

Beachten Sie, dass ein Abonnement (was normalerweise eine SIM-Karte bedeutet) nur eine Telefonnummer hat. Die mehrere Quellen sichern sich gegenseitig, sodass hoffentlich mindestens eine verfügbar ist. Bei einem Netzbetreiber, der in der Regel keine Telefonnummern #PHONE_NUMBER_SOURCE_UICC UICCfestgelegt hat, kann die Quelle #PHONE_NUMBER_SOURCE_IMS IMS eine angeben. Oder ein Netzbetreiber kann entscheiden, die Telefonnummer über die Quelle #PHONE_NUMBER_SOURCE_CARRIER carrier bereitzustellen, wenn weder quell-UICC noch IMS verfügbar sind.

Die Verfügbarkeit und Richtigkeit der Telefonnummer hängt von der zugrunde liegenden Quelle und dem Netzwerk usw. ab. Um diese Nummer für sicherheitsbezogene oder andere vertrauliche Szenarien zu verwenden, ist eine zusätzliche Überprüfung erforderlich.

Java-Dokumentation für android.telephony.SubscriptionManager.getPhoneNumber(int, int).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: