From: Jongkyu Koo Date: Fri, 29 Sep 2017 01:53:48 +0000 (+0900) Subject: Add csharp guide for PhonenumberUtils X-Git-Tag: MD/guides-dotnet~109^2 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=5f0598bab7b072bde6cf19d6fb4b477c1045036c;p=sdk%2Fonline-doc.git Add csharp guide for PhonenumberUtils PS2: Reviewed Change-Id: I7d7f37ebce846c66817b384104ef2dbedd15b199 Signed-off-by: Jongkyu Koo --- diff --git a/org.tizen.guides/html/dotnet/phonenumber-utils.htm b/org.tizen.guides/html/dotnet/phonenumber-utils.htm new file mode 100644 index 0000000..d2c59ad --- /dev/null +++ b/org.tizen.guides/html/dotnet/phonenumber-utils.htm @@ -0,0 +1,123 @@ + + + + + + + + + + + + + + Phone Number Management + + + + +
+ +
+

Dependencies

+
    +
  • Tizen 4.0 and Higher
    • +
+

Content

+ +

Related Info

+ +
+
+ +
+ +

Phone Number Management

+ +

You can parse, format, and normalize phone numbers. The Tizen.PhonenumberUtils namespace is implemented with the libphonenumber open source library.

+ +

The main features of the Tizen.PhonenumberUtils namespace include:

+ + +

Prerequisites

+

To enable your application to use the phone number management functionality:

+
    +
  1. To use the GetNormalizedNumber() method of the Tizen.PhonenumberUtils.PhonenumberUtils class, the application has to request permission by adding the following privilege to the tizen-manifest.xml file: +
    +<privileges>
+   <privilege>http://tizen.org/privilege/telephony</privilege>
+</privileges>
+
    +
    2. +
  2. To use the methods and properties of the Tizen.PhonenumberUtils namespace, include it in your application: +
    +using Tizen.PhonenumberUtils;
+
    +
    3. +
+ + +

Retrieving Location Information

+ +

To retrieve the location from a phone number, use the GetLocationFromNumber() method of the Tizen.PhonenumberUtils.PhonenumberUtils class. Provide the region of the phone number and the language of the returned location string as parameters, using the values defined in the Tizen.PhonenumberUtils.Region and Tizen.PhonenumberUtils.Language enumerations, respectively.

+
+var utils = new PhonenumberUtils();
+var location = utils.GetLocationFromNumber("0222550114", Region.Korea, Language.English);
+/// Method returns the location string "Seoul"
+
+ +

Formatting Phone Numbers

+ +

To format a phone number to use region-specific separators, use the GetFormattedNumber() method of the Tizen.PhonenumberUtils.PhonenumberUtils class, which takes the region parameter as a value of the Tizen.PhonenumberUtils.Region enumeration:

+
+var utils = new PhonenumberUtils();
+var formattedNumber = utils.GetFormattedNumber("0222550114", Region.Korea);
+/// Method returns the formatted number string "02-2255-0114"
+
+ +

Normalizing Phone Numbers

+ +

To retrieve a phone number in a normalized format, use the GetNormalizedNumber() method of the Tizen.PhonenumberUtils.PhonenumberUtils class:

+
+var utils = new PhonenumberUtils();
+var normalizedNumber = utils.GetNormalizedNumber("0222550114");
+/// Method returns the normalized number string "+821022550114"
+
+ + + +
+ +Go to top + + + + + + +