mCore™ .NET SMS Library 1.2

WapPush.Text Property

Description:

The Text property gets or sets the WAP Push text message that will be displayed on the recipients phone screen.

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

Exceptions:

mCore.WapPushException
mCore.GeneralException

Remarks:

When sending WAP Push message using mCore™ the total maximum allowed length of Text and URL property can be roughly estimated using the following thumb rule:

If Created and Expiry properties are included then the maximum total allowed length of Text and URL property together is approximately 89 characters.
The following strings will are not counted in the length of the URL: 'http://', 'https://', 'http://www.', 'https://www.', '.com/', '.net/', '.edu/', '.org/'.
If Created property is set to 0 then the maximum total permissible length of Text and URL can be increased by 9 characters
If Expiry property is set to 0 then the maximum total permissible length of Text and URL can be increased by 8 characters
The Text property accepts Unicode characters too, and does not depend on the value of mCore.SMS.Encoding property. mCore™ encodes the text to UTF-8 internally.

You can use the IsLengthOK property to check if the length of URL and Text is within permissible length to send the WAP Push message. However, using this method before sending every WAP Push message will reduce the throughput of messages.

Usage Example:

Visual Basic

Public Class MyClass
   Public WithEvents objSMS As New mCore.SMS
   Public Sub SendWapPush()
      Dim objWP As mCore.WapPush = objSMS.WapPush
      Try
         SetCommParameters()
         objWP.Destination = "+919873094767"
         objWP.Text = "Check your emails online"
         objWP.URL = "http://www.mobulus.com/mobile"
         objWP.Action = mCore.WapPushAction.SignalMedium
         objWP.Created = DateTime.Now
         objWP.Expiry = "1W"

         If objWP.IsLengthOK Then
            objWP.Send()
            MsgBox("WAP Push Sent!")
         Else
            MsgBox("WAP Push message length exceeds the length of a SMS")
         End If

      Catch ex As mCore.WapPushException
         MsgBox(ex.Message, MsgBoxStyle.Critical, "mCore Demo")
      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 SendWapPush()
   {
      mCore.WapPush objWP = objSMS.WapPush();
      try
      {

         SetCommParameters();
         objWP.Destination = "+919873094767";
         objWP.Text = "Check your emails online";
         objWP.URL = "http://www.mobulus.com/mobile";
         objWP.Action = mCore.WapPushAction.SignalMedium;
         objWP.Created = DateTime.Now;
         objWP.Expiry = "1W";

         If (objWP.IsLengthOK)
         {
            objWP.Send();
            MessageBox.Show("WAP Push Sent!");
         }
         else
         {
            MessageBox.Show("WAP Push message length exceeds the length of a SMS")
         }
      }

      catch (mCore.WapPushException e)
      {
         MessageBox.Show(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 WapPush.Text Property

Description:

Exceptions:

Remarks:

Usage Example:

See Also:

mCore™ .NET SMS Library 1.2

WapPush.Text Property