Share via


SmsTextMessage Classe

Definição

Gerencia uma mensagem de texto SMS decodificada, fornecendo acesso direto ao corpo do texto sem formatação da mensagem, bem como propriedades de cabeçalho de chave, como carimbo de data/hora.

Observação

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel, IHV de adaptador de banda larga móvel ou OEM. Para obter mais informações, consulte Banda Larga Móvel.

Observação

Essa classe e seus métodos têm suporte para a manutenção de aplicativos de área de trabalho herdados que a usaram em versões anteriores do Windows. Se você usar essa classe, deverá especificar o Windows.Devices.Sms.LegacySmsApiContract no manifesto do aplicativo. Não use essa classe se você estiver desenvolvendo um novo aplicativo para Windows. Em vez disso, use as APIs nesse namespace que não exigem o Windows.Devices.Sms.LegacySmsApiContract.

public ref class SmsTextMessage sealed : ISmsTextMessage
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Devices.Sms.LegacySmsApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("SmsTextMessage may be altered or unavailable for releases after Windows 10. Instead, use SmsTextMessage2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.Devices.Sms.LegacySmsApiContract)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SmsTextMessage final : ISmsTextMessage
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Devices.Sms.LegacySmsApiContract")]
/// [Windows.Foundation.Metadata.Deprecated("SmsTextMessage may be altered or unavailable for releases after Windows 10. Instead, use SmsTextMessage2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
class SmsTextMessage final : ISmsTextMessage
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Devices.Sms.LegacySmsApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("SmsTextMessage may be altered or unavailable for releases after Windows 10. Instead, use SmsTextMessage2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.Devices.Sms.LegacySmsApiContract))]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SmsTextMessage : ISmsTextMessage
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Devices.Sms.LegacySmsApiContract")]
[Windows.Foundation.Metadata.Deprecated("SmsTextMessage may be altered or unavailable for releases after Windows 10. Instead, use SmsTextMessage2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
public sealed class SmsTextMessage : ISmsTextMessage
function SmsTextMessage()
Public NotInheritable Class SmsTextMessage
Implements ISmsTextMessage
Herança
Object Platform::Object IInspectable SmsTextMessage
Atributos
Implementações

Requisitos do Windows

Família de dispositivos
Windows Desktop Extension SDK (introduzida na 10.0.10240.0)
API contract
Windows.Devices.Sms.LegacySmsApiContract (introduzida na v1.0)
Funcionalidades do aplicativo
cellularMessaging sms

Construtores

SmsTextMessage()

Cria uma instância da classe SmsTextMessage .

Propriedades

Body

Especifica o corpo do texto sem formatação da mensagem.

Encoding

Especifica o tipo de codificação que foi definido para ser usado ao enviar essa mensagem.

From

Especifica o número de telefone do remetente da mensagem.

Id

Indica a ID da mensagem de texto SMS.

MessageClass

Especifica a classe de mensagem de uma mensagem. Essa classe de mensagem normalmente se origina na rede, não no dispositivo móvel.

PartCount

Indica o número total de partes na mensagem original se a mensagem fizer parte de uma mensagem de várias partes.

PartNumber

Indica o número da parte de uma mensagem de várias partes se essa mensagem fizer parte de uma mensagem de várias partes. Ele pode ser usado para reconstruir a mensagem original unindo as partes, em conjunto com as propriedades PartReferenceId e PartCount .

PartReferenceId

Indica um valor de referência que pode ser usado se a mensagem fizer parte de uma mensagem de várias partes. Se essa mensagem pertencer a uma mensagem de várias partes, o valor PartNumber poderá ser usado para reconstruir a mensagem original completa e cada parte dessa mensagem terá o mesmo valor para PartReferenceId.

Timestamp

Indica o carimbo de data/hora da mensagem. Ele é determinado localmente para uma instância de mensagem construída ou do carimbo de data/hora da central de serviços de uma mensagem recebida.

To

Indica o número de telefone do destinatário desta mensagem.

Métodos

FromBinaryData(SmsDataFormat, Byte[])

Decodifica uma mensagem binária e coloca os resultados em uma nova instância de uma mensagem de texto. Esse método representa a mensagem binária como uma referência a um buffer de bytes e uma seleção de como o buffer é codificado. Portanto, ela pode ser usada quando a mensagem não foi originada diretamente do dispositivo ou como uma instância de uma classe SmsBinaryMessage .

FromBinaryMessage(SmsBinaryMessage)

Lê uma mensagem binária e a decodifica. Os resultados são colocados em uma nova instância de uma mensagem de texto.

ToBinaryMessages(SmsDataFormat)

Lê uma mensagem no formato especificado e coloca os resultados em uma nova instância de uma mensagem binária.

Aplica-se a