mCore™ .NET SMS Library 1.2

mCore.SMS.Encoding Property

Description:

The Encoding property gets or sets the type of character encoding to be used for sending text messages. The character encoding can be set to one of the following types:

7-Bit Default GSM Character Encoding (Maximum 160 characters per message)
8-Bit ANSI Character Encoding (Maximum 140 characters per message)
16-Bit Unicode Character Encoding (Maximum 70 characters per message)

The Encoding property value is of type mCore.Encoding

Namespace: mCore
Assembly: mCoreLib (in mCoreLib.dll)

Remarks:

When sending messages using 7-bit encoding, you must ensure that the characters used are limited to the ones defined in 7-bit default alphabet. If a character used is not as per 7-bit default alphabet then it will be replaced by '?' (question mark) symbol.
Certain characters (e.g. ^{}[]\~ ) are 14-bits long (as per 7-bit default alphabet defined by GSM 03.38) and therefore are equivalent to two characters when used in text messages with 7-bit encoding.
If you use 8-bit character encoding then you must ensure that each character used in the text message is restricted to 8-bit size or else the message will not be displayed correctly by the recipient's mobile phone.
Encoding property value does not have any affect on sending of WapPush, vCard or vCalendar (The text is automatically encoded as UTF-8).

Exceptions:

mCore.GeneralException

Usage Example:

Visual Basic

Public Class MyClass
   Public WithEvents objSMS As New mCore.SMS
   Public Sub SendMessage()
      Try
         SetCommParameters()
         objSMS.Encoding = mCore.Encoding.GSM_Default_7Bit
         objSMS.LongMessage = mCore.LongMessage.Concatenate
         Try
            objSMS.SendSMS("+919873094767", "This is a test message")
            MsgBox("Message Sent!")
         Catch ex As mCore.SMSSendException
            MsgBox("Message Failed!" & vbCrLf & ex.Message)
         End Try

      Catch ex As mCore.GeneralException
         MsgBox(ex.Message, MsgBoxStyle.Critical, "mCore Demo")
      Catch ex As Exception
      End Try
   End Sub

   Public Sub SetCommParameters()
      Try
         objSMS.Port = "COM1"
         objSMS.BaudRate = mCore.BaudRate.BaudRate_19200
         objSMS.DataBits = mCore.DataBits.Eight
         objSMS.StopBits = mCore.StopBits.One
         objSMS.Parity = mCore.Parity.None
         objSMS.FlowControl = mCore.FlowControl.RTS_CTS

      Catch ex As mCore.GeneralException
         MsgBox(ex.Message)
      Catch ex As Exception
      End Try
   End Function
End Class

class MyClass
{
   public mCore.SMS objSMS = new mCore.SMS();
   public static void SendMessage()
   {
      try
      {

            SetCommParameters();
            objSMS.Encoding = mCore.Encoding.GSM_Default_7Bit;
            objSMS.LongMessage = mCore.LongMessage.Concatenate;
            try
            {
               objSMS.SendSMS("+919873094767", "This is a test message");
               MessageBox.Show("Message Sent!");
            }
            catch (mCore.SMSSendException e)
            {
               MessageBox.Show("Message Failed!" + "\r\n" + e.ToString());
            }
      }

      catch (mCore.GeneralException e)
      {
         MessageBox.Show(e.ToString());
      }
      catch (Exception e)
      {
      }
   }

   public static void SetCommParameters()
   {
      try
      {
         objSMS.Port = "COM1";
         objSMS.BaudRate = mCore.BaudRate.BaudRate_19200;
         objSMS.DataBits = mCore.DataBits.Eight;
         objSMS.StopBits = mCore.StopBits.One;
         objSMS.Parity = mCore.Parity.None;
         objSMS.FlowControl = mCore.FlowControl.RTS_CTS;
      }

      catch (mCore.GeneralException e)
      {
         MessageBox.Show(e.ToString());
      }
      catch (Exception e)
      {
      }
   }
}

mCore™ .NET SMS Library 1.2 mCore.SMS.Encoding Property

Description:

Remarks:

Exceptions:

Usage Example:

See Also:

mCore™ .NET SMS Library 1.2

mCore.SMS.Encoding Property