SmsManager Class

Definition

Namespace:

Android.Telephony

Assembly:

Mono.Android.dll

Manages SMS operations such as sending data, text, and pdu SMS messages.

[Android.Runtime.Register("android/telephony/SmsManager", DoNotGenerateAcw=true)]
public sealed class SmsManager : Java.Lang.Object

[<Android.Runtime.Register("android/telephony/SmsManager", DoNotGenerateAcw=true)>]
type SmsManager = class
    inherit Object

Inheritance

Object

Object

SmsManager

Attributes

RegisterAttribute

Remarks

Manages SMS operations such as sending data, text, and pdu SMS messages. Get this object by calling the static method #getDefault(). To create an instance of SmsManager associated with a specific subscription ID, call #getSmsManagerForSubscriptionId(int). This is typically used for devices that support multiple active subscriptions at once.

For information about how to behave as the default SMS app on Android 4.4 (API level 19) and higher, see android.provider.Telephony.

Java documentation for android.telephony.SmsManager.

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.

Fields

ExtraMmsData	Intent extra name for MMS sending result data in byte array type
ExtraMmsHttpStatus	Intent extra name for HTTP status code for MMS HTTP failure in integer type
MmsConfigAliasEnabled	Whether alias is enabled (boolean type)
MmsConfigAliasMaxChars	Max alias character count (int type)
MmsConfigAliasMinChars	Min alias character count (int type)
MmsConfigAllowAttachAudio	Whether audio is allowed to be attached for MMS messages (boolean type)
MmsConfigAppendTransactionId	Whether to append transaction id to MMS WAP Push M-Notification.
MmsConfigEmailGatewayNumber	Email gateway number (String type)
MmsConfigGroupMmsEnabled	Whether group MMS is enabled for the current carrier (boolean type)
MmsConfigHttpParams	A list of HTTP headers to add to MMS HTTP request, separated by "|" (String type)
MmsConfigHttpSocketTimeout	MMS HTTP socket timeout in milliseconds (int type)
MmsConfigMaxImageHeight	Max MMS image height (int type)
MmsConfigMaxImageWidth	Max MMS image width (int type)
MmsConfigMaxMessageSize	Max MMS message size in bytes (int type)
MmsConfigMessageTextMaxSize	Max message text size (int type)
MmsConfigMmsDeliveryReportEnabled	Whether MMS delivery report is enabled (boolean type)
MmsConfigMmsEnabled	Whether MMS is enabled for the current carrier (boolean type)
MmsConfigMmsReadReportEnabled	Whether MMS read report is enabled (boolean type)
MmsConfigMultipartSmsEnabled	Whether multipart SMS is enabled (boolean type)
MmsConfigNaiSuffix	The suffix to append to the NAI header value for MMS HTTP request (String type)
MmsConfigNotifyWapMmscEnabled	If this is enabled, M-NotifyResp.
MmsConfigRecipientLimit	Limit of recipients of MMS messages (int type)
MmsConfigSendMultipartSmsAsSeparateMessages	Whether multipart SMS should be sent as separate messages
MmsConfigShowCellBroadcastAppLinks	If true, show the cell broadcast (amber alert) in the SMS settings.
MmsConfigSmsDeliveryReportEnabled	Whether SMS delivery report is enabled (boolean type)
MmsConfigSmsToMmsTextLengthThreshold	Some carriers require SMS to be converted into MMS when text length reaches this threshold (int type)
MmsConfigSmsToMmsTextThreshold	When the number of parts of a multipart SMS reaches this threshold, it should be converted into an MMS (int type)
MmsConfigSubjectMaxLength	Max message subject length (int type)
MmsConfigSupportHttpCharsetHeader	Whether the carrier MMSC supports charset field in Content-Type header.
MmsConfigSupportMmsContentDisposition	Whether content-disposition field should be expected in an MMS PDU (boolean type)
MmsConfigUaProfTagName	The name of the UA Prof URL HTTP header for MMS HTTP request (String type)
MmsConfigUaProfUrl	The UA Profile URL header value for MMS HTTP request (String type)
MmsConfigUserAgent	The User-Agent header value for MMS HTTP request (String type)
MmsErrorDataDisabled	Obsolete. Data is disabled for the MMS APN.
MmsErrorInactiveSubscription	Obsolete. The subscription id for the send/download is inactive.
MmsErrorInvalidSubscriptionId	Obsolete. The subscription id for the send/download is invalid.
ResultBluetoothDisconnected	Obsolete. Failed sending via bluetooth because bluetooth disconnected
ResultCancelled	Obsolete. Failed because the operation was cancelled
ResultEncodingError	Obsolete. Failed because of an encoding error
ResultErrorFdnCheckFailure	Obsolete. Failed because FDN is enabled.
ResultErrorNone	Obsolete. No error.
ResultInternalError	Obsolete. Failed because of an internal error
ResultInvalidArguments	Obsolete. Failed because of invalid arguments
ResultInvalidBluetoothAddress	Obsolete. Failed sending via bluetooth because the bluetooth device address is invalid
ResultInvalidSmscAddress	Obsolete. Failed because of an invalid smsc address
ResultInvalidSmsFormat	Obsolete. Failed because the sms format is not valid
ResultInvalidState	Obsolete. Failed because of an invalid state
ResultModemError	Obsolete. Failed because of a modem error
ResultNetworkError	Obsolete. Failed because of a network error
ResultNetworkReject	Obsolete. Failed because of network rejection
ResultNoBluetoothService	Obsolete. Failed sending via bluetooth because the bluetooth service is not available
ResultNoDefaultSmsApp	Obsolete. Set by BroadcastReceiver to indicate there's no default sms app.
ResultNoMemory	Obsolete. Failed because there is no memory
ResultNoResources	Obsolete. Failed because there are no resources
ResultOperationNotAllowed	Obsolete. Failed because the operation is not allowed
ResultRadioNotAvailable	Obsolete. Failed because the radio was not available
ResultReceiveDispatchFailure	Obsolete. SMS receive dispatch failure.
ResultReceiveInjectedNullPdu	Obsolete. SMS receive injected null PDU.
ResultReceiveNullMessageFromRil	Obsolete. SMS received null message from the radio interface layer.
ResultReceiveRuntimeException	Obsolete. SMS receive encountered runtime exception.
ResultReceiveSqlException	Obsolete. SMS receive encountered an SQL exception.
ResultReceiveUriException	Obsolete. SMS receive an exception parsing a uri.
ResultReceiveWhileEncrypted	Obsolete. SMS short code received while the phone is in encrypted state.
ResultRemoteException	Obsolete. Set by BroadcastReceiver to indicate a remote exception while handling a message.
ResultRequestNotSupported	Obsolete. Failed because the request is not supported
ResultRilAborted	Obsolete. Operation aborted
ResultRilAccessBarred	Obsolete. Access is barred.
ResultRilBlockedDueToCall	Obsolete. SMS is blocked due to call control, e.
ResultRilCancelled	Obsolete. The request has been cancelled.
ResultRilDeviceInUse	Obsolete. Operation cannot be performed because the device is currently in use
ResultRilEncodingErr	Obsolete. The SMS message was not encoded properly.
ResultRilGenericError	Obsolete. A RIL error occurred during the SMS send.
ResultRilInternalErr	Obsolete. The modem encountered an unexpected error scenario while handling the request.
ResultRilInvalidArguments	Obsolete. The radio received invalid arguments in the request.
ResultRilInvalidModemState	Obsolete. The radio cannot process the request in the current modem state.
ResultRilInvalidResponse	Obsolete. A RIL internal error when one of the RIL layers receives an unrecognized response from a lower layer.
ResultRilInvalidSimState	Obsolete. Cannot process the request in current SIM state
ResultRilInvalidSmscAddress	Obsolete. The specified SMSC address was invalid.
ResultRilInvalidSmsFormat	Obsolete. The radio returned an error indicating invalid sms format.
ResultRilInvalidState	Obsolete. The radio returned an unexpected request for the current state.
ResultRilModemErr	Obsolete. The vendor RIL received an unexpected or incorrect response.
ResultRilNetworkErr	Obsolete. The radio received an error from the network.
ResultRilNetworkNotReady	Obsolete. The network is not ready to perform the request.
ResultRilNetworkReject	Obsolete. The sms request was rejected by the network.
ResultRilNoMemory	Obsolete. The radio didn't have sufficient memory to process the request.
ResultRilNoNetworkFound	Obsolete. Network cannot be found
ResultRilNoResources	Obsolete. There are insufficient resources to process the request.
ResultRilNoSmsToAck	Obsolete. ACK received when there is no SMS to ack
ResultRilNoSubscription	Obsolete. Device does not have subscription
ResultRilOperationNotAllowed	Obsolete. The radio reports the request is not allowed.
ResultRilRadioNotAvailable	Obsolete. The radio did not start or is resetting.
ResultRilRequestNotSupported	Obsolete. The request was not supported by the radio.
ResultRilRequestRateLimited	Obsolete. The radio denied the operation due to overly-frequent requests.
ResultRilSimAbsent	Obsolete. The radio failed to set the location where the CDMA subscription can be retrieved because the SIM or RUIM is absent.
ResultRilSimBusy	Obsolete. SIM is busy
ResultRilSimError	Obsolete. Received error from SIM card
ResultRilSimFull	Obsolete. The target EF is full
ResultRilSimPin2	Obsolete. Operation requires SIM PIN2 to be entered
ResultRilSimPuk2	Obsolete. Operation requires SIM PUK2 to be entered
ResultRilSimultaneousSmsAndCallNotAllowed	Obsolete. 1X voice and SMS are not allowed simultaneously.
ResultRilSmsSendFailRetry	Obsolete. The radio failed to send the sms and needs to retry.
ResultRilSubscriptionNotAvailable	Obsolete. Fail to find CDMA subscription from specified location
ResultRilSystemErr	Obsolete. The radio encountered a platform or system error.
ResultSmsBlockedDuringEmergency	Obsolete. Failed sending during an emergency call
ResultSmsSendRetryFailed	Obsolete. Failed to send an sms retry
ResultSystemError	Obsolete. Failed because of a system error
ResultUnexpectedEventStopSending	Obsolete. Failed sending because the user denied or canceled the dialog displayed for a premium shortcode sms or rate-limited sms.
ResultUserNotAllowed	Obsolete. User is not associated with the subscription.
SmsRpCauseCallBarring	Obsolete. RP-Cause Value for Call Barring
SmsRpCauseCongestion	Obsolete. RP-Cause Value for SMS Failure due to Congestion in network
SmsRpCauseDestinationOutOfOrder	Obsolete. RP-Cause Value for Destination is Out of Order
SmsRpCauseFacilityNotImplemented	Obsolete. RP-Cause Value when network does not provide the received service
SmsRpCauseFacilityNotSubscribed	Obsolete. RP-Cause Value when SMS Facilty is not subscribed by Reote device
SmsRpCauseFacilityRejected	Obsolete. RP-Cause Value when SMS Facility if Rejected by Operator
SmsRpCauseInformationElementNonExistent	Obsolete. RP-Cause Value when network does not provide the received service
SmsRpCauseInterworkingUnspecified	Obsolete. RP-Cause Value when network does not provide the received service
SmsRpCauseInvalidMandatoryInformation	Obsolete. RP-Cause Value when network does not provide the received service
SmsRpCauseInvalidMessageReferenceValue	Obsolete. RP-Cause Value when RP-MessageRefere
SmsRpCauseMessageIncompatibleWithProtocolState	Obsolete. RP-Cause Value when network does not provide the received service
SmsRpCauseMessageTypeNonExistent	Obsolete. RP-Cause Value when network does not provide the received service
SmsRpCauseNetworkOutOfOrder	Obsolete. RP-Cause Value when network is out of order
SmsRpCauseOperatorDeterminedBarring	Obsolete. RP-Cause for Operator Barring
SmsRpCauseProtocolError	Obsolete. RP-Cause Value when network does not provide the received service
SmsRpCauseReserved	Obsolete. RP-Cause value for Reserved Number
SmsRpCauseResourcesUnavailable	Obsolete. RP-Cause Value when Network Resources are unavailable
SmsRpCauseSemanticallyIncorrectMessage	Obsolete. RP-Cause Value when network does not provide the received service
SmsRpCauseShortMessageTransferRejected	Obsolete. RP-Cause Value for Message Transfer Rejected by Network
SmsRpCauseTemporaryFailure	Obsolete. RP-Cause Value For Temporary failure
SmsRpCauseUnallocatedNumber	Obsolete. Unallocated Number Cause
SmsRpCauseUnidentifiedSubscriber	Obsolete. RP-Cause Value when Subscriber is not Identified
SmsRpCauseUnknownSubscriber	Obsolete. RP-Cause Value when Subscriber is not Identified

Properties

CarrierConfigValues	Get carrier-dependent MMS configuration values.
Class	Returns the runtime class of this Object. (Inherited from Object)
Default	Get the SmsManager associated with the default subscription id.
DefaultSmsSubscriptionId	Get default sms subscription id.
Handle	The handle to the underlying Android instance. (Inherited from Object)
JniIdentityHashCode	(Inherited from Object)
JniPeerMembers
PeerReference	(Inherited from Object)
SmscAddress	Gets the SMSC address from (U)SIM.
SmsCapacityOnIcc	Gets the total capacity of SMS storage on the SIM card.
SubscriptionId	Get the associated subscription id.
ThresholdClass	This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. (Inherited from Object)
ThresholdType	This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. (Inherited from Object)

Methods

Clone()	Creates and returns a copy of this object. (Inherited from Object)
CreateAppSpecificSmsToken(PendingIntent)	Create a single use app specific incoming SMS request for the calling package.
CreateAppSpecificSmsTokenWithPackageInfo(String, PendingIntent)	Create a single use app specific incoming SMS request for the calling package.
CreateForSubscriptionId(Int32)	Get the instance of the SmsManager associated with a particular subscription ID.
Dispose()	(Inherited from Object)
Dispose(Boolean)	(Inherited from Object)
DivideMessage(String)	Divide a message text into several fragments, none bigger than the maximum SMS message size.
DownloadMultimediaMessage(Context, String, Uri, Bundle, PendingIntent, Int64)	Download an MMS message from carrier by a given location URL Same as <code data-dev-comment-type="c">#downloadMultimediaMessage(Context context, String locationUrl, Uri contentUri, Bundle configOverrides, PendingIntent downloadedIntent)</code>, but adds an optional messageId.
DownloadMultimediaMessage(Context, String, Uri, Bundle, PendingIntent)	Download an MMS message from carrier by a given location URL &lt;p class="note"&gt;&lt;strong&gt;Note:&lt;/strong&gt; If <code data-dev-comment-type="c">#getDefault()</code> is used to instantiate this manager on a multi-SIM device, this operation may fail downloading the MMS message because no suitable default subscription could be found.
Equals(Object)	Indicates whether some other object is "equal to" this one. (Inherited from Object)
GetHashCode()	Returns a hash code value for the object. (Inherited from Object)
GetSmsManagerForSubscriptionId(Int32)	Get the instance of the SmsManager associated with a particular subscription ID.
GetSmsMessagesForFinancialApp(Bundle, IExecutor, SmsManager+FinancialSmsCallback)	Get SMS messages for the calling financial app.
InjectSmsPdu(Byte[], String, PendingIntent)	Inject an SMS PDU into the android application framework.
JavaFinalize()	Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. (Inherited from Object)
Notify()	Wakes up a single thread that is waiting on this object's monitor. (Inherited from Object)
NotifyAll()	Wakes up all threads that are waiting on this object's monitor. (Inherited from Object)
SendDataMessage(String, String, Int16, Byte[], PendingIntent, PendingIntent)	Send a data based SMS to a specific application port.
SendMultimediaMessage(Context, Uri, String, Bundle, PendingIntent, Int64)	Send an MMS message Same as <code data-dev-comment-type="c">#sendMultimediaMessage(Context context, Uri contentUri, String locationUrl, Bundle configOverrides, PendingIntent sentIntent)</code>, but adds an optional messageId.
SendMultimediaMessage(Context, Uri, String, Bundle, PendingIntent)	Send an MMS message &lt;p class="note"&gt;&lt;strong&gt;Note:&lt;/strong&gt; If <code data-dev-comment-type="c">#getDefault()</code> is used to instantiate this manager on a multi-SIM device, this operation may fail sending the MMS message because no suitable default subscription could be found.
SendMultipartTextMessage(String, String, IList<String>, IList<PendingIntent>, IList<PendingIntent>, Int64)	Send a multi-part text based SMS.
SendMultipartTextMessage(String, String, IList<String>, IList<PendingIntent>, IList<PendingIntent>, String, String)	Similar method as #sendMultipartTextMessage(String, String, ArrayList, ArrayList, ArrayList) With an additional argument.
SendMultipartTextMessage(String, String, IList<String>, IList<PendingIntent>, IList<PendingIntent>)	Send a multi-part 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.
SendTextMessageWithoutPersisting(String, String, String, PendingIntent, PendingIntent)	Send a text based SMS without writing it into the SMS Provider.
SetHandle(IntPtr, JniHandleOwnership)	Sets the Handle property. (Inherited from Object)
SetSmscAddress(String)	Sets the SMSC address on (U)SIM.
ToArray<T>()	(Inherited from Object)
ToString()	Returns a string representation of the object. (Inherited from Object)
UnregisterFromRuntime()	(Inherited from Object)
Wait()	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>. (Inherited from Object)
Wait(Int64, Int32)	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object)
Wait(Int64)	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object)

Explicit Interface Implementations

IJavaPeerable.Disposed()	(Inherited from Object)
IJavaPeerable.DisposeUnlessReferenced()	(Inherited from Object)
IJavaPeerable.Finalized()	(Inherited from Object)
IJavaPeerable.JniManagedPeerState	(Inherited from Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	(Inherited from Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	(Inherited from Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	(Inherited from Object)

Extension Methods

JavaCast<TResult>(IJavaObject)	Performs an Android runtime-checked type conversion.
JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)