SubscriptionManager.GetPhoneNumber Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
GetPhoneNumber(Int32) |
Gibt die Telefonnummer für das angegebene |
GetPhoneNumber(Int32, Int32) |
Gibt die Telefonnummer für die angegebene |
GetPhoneNumber(Int32)
Gibt die Telefonnummer für das angegebene subId
Oder 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 subId
Oder 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 UICC
festgelegt 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.