SmsManager.SendTextMessage Method

Reference

Definition

Namespace:: Android.Telephony

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloads

SendTextMessage(String, String, String, PendingIntent, PendingIntent)	Send a text based SMS.
SendTextMessage(String, String, String, PendingIntent, PendingIntent, Int64)	Send a text based SMS.

SendTextMessage(String, String, String, PendingIntent, PendingIntent)

Send a text based SMS.

[Android.Runtime.Register("sendTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Landroid/app/PendingIntent;Landroid/app/PendingIntent;)V", "")]
public void SendTextMessage (string? destinationAddress, string? scAddress, string? text, Android.App.PendingIntent? sentIntent, Android.App.PendingIntent? deliveryIntent);

[<Android.Runtime.Register("sendTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Landroid/app/PendingIntent;Landroid/app/PendingIntent;)V", "")>]
member this.SendTextMessage : string * string * string * Android.App.PendingIntent * Android.App.PendingIntent -> unit

Parameters

destinationAddress: String

the address to send the message to

scAddress: String

is the service center address or null to use the current default SMSC

text: String

the body of the message to send

sentIntent: PendingIntent

if not NULL this PendingIntent is broadcast when the message is successfully sent, or failed. The result code will be Activity.RESULT_OK for success, or one of these errors: RESULT_ERROR_GENERIC_FAILURE RESULT_ERROR_RADIO_OFF RESULT_ERROR_NULL_PDU RESULT_ERROR_NO_SERVICE RESULT_ERROR_LIMIT_EXCEEDED RESULT_ERROR_FDN_CHECK_FAILURE RESULT_ERROR_SHORT_CODE_NOT_ALLOWED RESULT_ERROR_SHORT_CODE_NEVER_ALLOWED RESULT_RADIO_NOT_AVAILABLE RESULT_NETWORK_REJECT RESULT_INVALID_ARGUMENTS RESULT_INVALID_STATE RESULT_NO_MEMORY RESULT_INVALID_SMS_FORMAT RESULT_SYSTEM_ERROR RESULT_MODEM_ERROR RESULT_NETWORK_ERROR RESULT_ENCODING_ERROR RESULT_INVALID_SMSC_ADDRESS RESULT_OPERATION_NOT_ALLOWED RESULT_INTERNAL_ERROR RESULT_NO_RESOURCES RESULT_CANCELLED RESULT_REQUEST_NOT_SUPPORTED RESULT_NO_BLUETOOTH_SERVICE RESULT_INVALID_BLUETOOTH_ADDRESS RESULT_BLUETOOTH_DISCONNECTED RESULT_UNEXPECTED_EVENT_STOP_SENDING RESULT_SMS_BLOCKED_DURING_EMERGENCY RESULT_SMS_SEND_RETRY_FAILED RESULT_REMOTE_EXCEPTION RESULT_NO_DEFAULT_SMS_APP RESULT_RIL_RADIO_NOT_AVAILABLE RESULT_RIL_SMS_SEND_FAIL_RETRY RESULT_RIL_NETWORK_REJECT RESULT_RIL_INVALID_STATE RESULT_RIL_INVALID_ARGUMENTS RESULT_RIL_NO_MEMORY RESULT_RIL_REQUEST_RATE_LIMITED RESULT_RIL_INVALID_SMS_FORMAT RESULT_RIL_SYSTEM_ERR RESULT_RIL_ENCODING_ERR RESULT_RIL_INVALID_SMSC_ADDRESS RESULT_RIL_MODEM_ERR RESULT_RIL_NETWORK_ERR RESULT_RIL_INTERNAL_ERR RESULT_RIL_REQUEST_NOT_SUPPORTED RESULT_RIL_INVALID_MODEM_STATE RESULT_RIL_NETWORK_NOT_READY RESULT_RIL_OPERATION_NOT_ALLOWED RESULT_RIL_NO_RESOURCES RESULT_RIL_CANCELLED RESULT_RIL_SIM_ABSENT RESULT_RIL_SIMULTANEOUS_SMS_AND_CALL_NOT_ALLOWED RESULT_RIL_ACCESS_BARRED RESULT_RIL_BLOCKED_DUE_TO_CALL For RESULT_ERROR_GENERIC_FAILURE or any of the RESULT_RIL errors, the sentIntent may include the extra "errorCode" containing a radio technology specific value, generally only useful for troubleshooting.

deliveryIntent: PendingIntent

if not NULL this PendingIntent is broadcast when the message is delivered to the recipient. The raw pdu of the status report is in the extended data ("pdu").

Attributes: RegisterAttribute

Exceptions

IllegalArgumentException

if destinationAddress or text are empty

Remarks

Send a text based SMS.

Note: Using this method requires that your app has the android.Manifest.permission#SEND_SMS permission.

Note: Beginning with Android 4.4 (API level 19), if and only if an app is not selected as the default SMS app, the system automatically writes messages sent using this method to the SMS Provider (the default SMS app is always responsible for writing its sent messages to the SMS Provider). For information about how to behave as the default SMS app, see android.provider.Telephony.

Note: If #getDefault() is used to instantiate this manager on a multi-SIM device, this operation may fail sending the SMS message because no suitable default subscription could be found. In this case, if sentIntent is non-null, then the PendingIntent will be sent with an error code RESULT_ERROR_GENERIC_FAILURE and an extra string "noDefault" containing the boolean value true. See #getDefault() for more information on the conditions where this operation may fail.

Java documentation for android.telephony.SmsManager.sendTextMessage(java.lang.String, java.lang.String, java.lang.String, android.app.PendingIntent, android.app.PendingIntent).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

SendTextMessage(String, String, String, PendingIntent, PendingIntent, Int64)

Send a text based SMS.

[Android.Runtime.Register("sendTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Landroid/app/PendingIntent;Landroid/app/PendingIntent;J)V", "", ApiSince=30)]
public void SendTextMessage (string destinationAddress, string? scAddress, string text, Android.App.PendingIntent? sentIntent, Android.App.PendingIntent? deliveryIntent, long messageId);

[<Android.Runtime.Register("sendTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Landroid/app/PendingIntent;Landroid/app/PendingIntent;J)V", "", ApiSince=30)>]
member this.SendTextMessage : string * string * string * Android.App.PendingIntent * Android.App.PendingIntent * int64 -> unit

Parameters

destinationAddress: String

the address to send the message to

scAddress: String

is the service center address or null to use the current default SMSC

text: String

the body of the message to send

sentIntent: PendingIntent

if not NULL this <code>PendingIntent</code> is broadcast when the message is successfully sent, or failed. The result code will be <code>Activity.RESULT_OK</code> for success, or one of these errors: <code>RESULT_ERROR_GENERIC_FAILURE</code> <code>RESULT_ERROR_RADIO_OFF</code> <code>RESULT_ERROR_NULL_PDU</code> <code>RESULT_ERROR_NO_SERVICE</code> <code>RESULT_ERROR_LIMIT_EXCEEDED</code> <code>RESULT_ERROR_FDN_CHECK_FAILURE</code> <code>RESULT_ERROR_SHORT_CODE_NOT_ALLOWED</code> <code>RESULT_ERROR_SHORT_CODE_NEVER_ALLOWED</code> <code>RESULT_RADIO_NOT_AVAILABLE</code> <code>RESULT_NETWORK_REJECT</code> <code>RESULT_INVALID_ARGUMENTS</code> <code>RESULT_INVALID_STATE</code> <code>RESULT_NO_MEMORY</code> <code>RESULT_INVALID_SMS_FORMAT</code> <code>RESULT_SYSTEM_ERROR</code> <code>RESULT_MODEM_ERROR</code> <code>RESULT_NETWORK_ERROR</code> <code>RESULT_ENCODING_ERROR</code> <code>RESULT_INVALID_SMSC_ADDRESS</code> <code>RESULT_OPERATION_NOT_ALLOWED</code> <code>RESULT_INTERNAL_ERROR</code> <code>RESULT_NO_RESOURCES</code> <code>RESULT_CANCELLED</code> <code>RESULT_REQUEST_NOT_SUPPORTED</code> <code>RESULT_NO_BLUETOOTH_SERVICE</code> <code>RESULT_INVALID_BLUETOOTH_ADDRESS</code> <code>RESULT_BLUETOOTH_DISCONNECTED</code> <code>RESULT_UNEXPECTED_EVENT_STOP_SENDING</code> <code>RESULT_SMS_BLOCKED_DURING_EMERGENCY</code> <code>RESULT_SMS_SEND_RETRY_FAILED</code> <code>RESULT_REMOTE_EXCEPTION</code> <code>RESULT_NO_DEFAULT_SMS_APP</code> <code>RESULT_RIL_RADIO_NOT_AVAILABLE</code> <code>RESULT_RIL_SMS_SEND_FAIL_RETRY</code> <code>RESULT_RIL_NETWORK_REJECT</code> <code>RESULT_RIL_INVALID_STATE</code> <code>RESULT_RIL_INVALID_ARGUMENTS</code> <code>RESULT_RIL_NO_MEMORY</code> <code>RESULT_RIL_REQUEST_RATE_LIMITED</code> <code>RESULT_RIL_INVALID_SMS_FORMAT</code> <code>RESULT_RIL_SYSTEM_ERR</code> <code>RESULT_RIL_ENCODING_ERR</code> <code>RESULT_RIL_INVALID_SMSC_ADDRESS</code> <code>RESULT_RIL_MODEM_ERR</code> <code>RESULT_RIL_NETWORK_ERR</code> <code>RESULT_RIL_INTERNAL_ERR</code> <code>RESULT_RIL_REQUEST_NOT_SUPPORTED</code> <code>RESULT_RIL_INVALID_MODEM_STATE</code> <code>RESULT_RIL_NETWORK_NOT_READY</code> <code>RESULT_RIL_OPERATION_NOT_ALLOWED</code> <code>RESULT_RIL_NO_RESOURCES</code> <code>RESULT_RIL_CANCELLED</code> <code>RESULT_RIL_SIM_ABSENT</code> <code>RESULT_RIL_SIMULTANEOUS_SMS_AND_CALL_NOT_ALLOWED</code> <code>RESULT_RIL_ACCESS_BARRED</code> <code>RESULT_RIL_BLOCKED_DUE_TO_CALL</code> For <code>RESULT_ERROR_GENERIC_FAILURE</code> or any of the RESULT_RIL errors, the sentIntent may include the extra "errorCode" containing a radio technology specific value, generally only useful for troubleshooting.

deliveryIntent: PendingIntent

if not NULL this <code>PendingIntent</code> is broadcast when the message is delivered to the recipient. The raw pdu of the status report is in the extended data ("pdu").

messageId: Int64

An id that uniquely identifies the message requested to be sent. Used for logging and diagnostics purposes. The id may be 0.

Attributes: RegisterAttribute

Remarks

Send a text based SMS. Same as #sendTextMessage( String destinationAddress, String scAddress, String text, PendingIntent sentIntent, PendingIntent deliveryIntent), but adds an optional messageId.

Java documentation for android.telephony.SmsManager.sendTextMessage(java.lang.String, java.lang.String, java.lang.String, android.app.PendingIntent, android.app.PendingIntent, long).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

Share via

SmsManager.SendTextMessage Method

Definition

Overloads

SendTextMessage(String, String, String, PendingIntent, PendingIntent)

Parameters

Exceptions

Remarks

Applies to

SendTextMessage(String, String, String, PendingIntent, PendingIntent, Int64)

Parameters

Remarks

Applies to

Additional resources