PhoneCall.PhoneNumber Property

Definition

Gets or sets a string that represents a phone number. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

public:
 property System::String ^ PhoneNumber { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string PhoneNumber { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.PhoneNumber : string with get, set
Public Property PhoneNumber As String

Property Value

A string that represents a phone number.

Attributes

Exceptions

the format of the number is invalid.

Remarks

The PhoneNumber property is required on PhoneCall controls. The PhoneNumber property accepts strings in a variety of formats. The format for the following types of numbers is described by using the Backus-Naur Format (BNF syntax is a way to describe the syntax of file formats):

phone_number ::= international_number | national_number | short_number  

international_number ::= "+" country_code national_number  

short_number ::= "#" national_number  

country_code ::= (decoration_character | digit)* digit (decoration_character   
       | digit)*  

national_number ::= (decoration_character | digit)+  

digit ::= 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9  

decoration_character ::= "(" | ")" | "." | "-" | {space}  

A phone number can consist of an optional country or region code, prefixed with a + sign, followed by any sequence of numbers that makes up the phone number. The characters marked as decoration_character can appear anywhere in the phone number and are ignored.

For i-Mode phones, the following rules currently apply when specifying a phone number:

  • The string must begin with "0" or "#".

  • If the string begins with "0", the numbers are more than nine digits.

  • If the string begins with "#", the numbers are more than three digits.

  • The numbers can contain "(", ")" and "-" in the string.

  • The string must be fewer than 24 characters.

The following list shows some examples of valid phone numbers:

  • 800.522.2920

  • +1 (425) 885-8080

  • +91335303197

Applies to

See also