mCore™ .NET SMS Library 1.2

mCore.SMS.LongMessage Property

Description:

The LongMessage property gets or sets how a message (sent using SMS.SendSMS and SMS.SendSMSToQueue methods) is to be treated if it exceeds the maximum permissible length for a given type of Encoding.

The LongMessage property value is of type mCore.LongMessage

LongMessage setting can be defined to do one of the following in case of long messages:

Truncate - The outgoing text message is truncated to one message of length based on type of character encoding
Split - The message is split in to multiple messages with each message length within the maximum size depending on character encoding
Formatted Split - Same as Split, except that this mode adds a page number to each split part of outgoing message at the end of the message (e.g. Msg 1/2)
Concatenate - Splits the outgoing message to multiple messages, which when received by the recipient, is displayed as one single message.

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

Remarks:

As per GSM specifications, the maximum number of characters allowed in a single text message is dependent on the type of character encoding as given below:

7-bit default GSM encoding: Maximum 160 characters per message
8-bit ANSI encoding: Maximum 140 characters per message
16-bit Unicode UCS2: Maximum 70 characters per message

Important:

Permissible message length i.e. maximum number of characters allowed in a one single message is dependent on type of character encoding as defined in Encoding property
Mobile phone handsets that do not support concatenated messages, will display the received concatenated message as multiple messages.
If Formatted Split is selected then the page number is not added if the message size is within the maximum permissible length.

Exceptions:

mCore.GeneralException

Usage Example:

Visual Basic

Public Class MyClass
Public WithEvents objSMS As New mCore.SMS
Public Sub SendMessage()

      Dim strMsg As String
      strMsg = "This is a very long text message and it has more than one _
               hundred sixty characters in it. This is to test how the _
               long message will be sent using mCore .NET SMS Library."
      Try
         SetCommParameters()
         objSMS.Encoding = mCore.Encoding.GSM_Default_7Bit
         objSMS.LongMessage = mCore.LongMessage.Concatenate
         Try
            objSMS.SendSMS("+919873094767", strMsg)
            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()
   {
      string strMsg = "This is a very long text message and";
      strMsg = strMsg + " it has more than one hundred sixty";
      strMsg = strMsg + " characters in it. This is to test how";
      strMsg = strMsg + " the long message will be sent using";
      strMsg = strMsg + " mCore .NET SMS Library.";
      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.LongMessage Property

Description:

Remarks:

Exceptions:

Usage Example:

See Also:

mCore™ .NET SMS Library 1.2

mCore.SMS.LongMessage Property