SmsTextMessage Klasse

Definition

Namespace:

Windows.Devices.Sms

Verwaltet eine decodierte SMS-Textnachricht und bietet direkten Zugriff auf den Nur-Text-Text der Nachricht sowie wichtige Headereigenschaften, z. B. Zeitstempel.

Hinweis

Diese Funktionalität steht nur für Apps von Mobilfunkanbietern und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber, mobile Breitbandadapter IHV oder OEM zur Verfügung. Weitere Informationen finden Sie unter Mobiles Breitband.

Hinweis

Diese Klasse und ihre Methoden werden für die Wartung von Legacy-Desktop-Apps unterstützt, die sie in früheren Versionen von Windows verwendet haben. Wenn Sie diese Klasse verwenden, müssen Sie windows.Devices.Sms.LegacySmsApiContract im Manifest Ihrer App angeben. Verwenden Sie diese Klasse nicht, wenn Sie eine neue App für Windows entwickeln. Verwenden Sie stattdessen die APIs in diesem Namespace, für die windows.Devices.Sms.LegacySmsApiContract nicht erforderlich ist.

public ref class SmsTextMessage sealed : 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.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

Vererbung

Object Platform::Object IInspectable SmsTextMessage

Attribute

ActivatableAttribute ContractVersionAttribute DeprecatedAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

ISmsMessage ISmsTextMessage

Windows-Anforderungen

Gerätefamilie	Windows Desktop Extension SDK (eingeführt in 10.0.10240.0)
API contract	Windows.Devices.Sms.LegacySmsApiContract (eingeführt in v1.0)
App-Funktionen	cellularMessaging sms

Konstruktoren

SmsTextMessage()

Erstellt eine instance der SmsTextMessage-Klasse.

Eigenschaften

Body	Gibt den Nur-Text-Text der Nachricht an.
Encoding	Gibt den Codierungstyp an, der beim Senden dieser Nachricht verwendet werden soll.
From	Gibt die Telefonnummer des Absenders der Nachricht an.
Id	Gibt die ID der SMS-Textnachricht an.
MessageClass	Gibt die Nachrichtenklasse einer Nachricht an. Diese Nachrichtenklasse stammt in der Regel aus dem Netzwerk, nicht vom mobilen Gerät.
PartCount	Gibt die Gesamtzahl der Teile in der ursprünglichen Nachricht an, wenn die Nachricht Teil einer mehrteiligen Nachricht ist.
PartNumber	Gibt die Teilnummer einer mehrteiligen Nachricht an, wenn diese Nachricht Teil einer mehrteiligen Nachricht ist. Es kann verwendet werden, um die ursprüngliche Nachricht zu rekonstruieren, indem die Teile in Verbindung mit den Eigenschaften PartReferenceId und PartCount verknüpft werden.
PartReferenceId	Gibt einen Verweiswert an, der verwendet werden kann, wenn die Nachricht Teil einer mehrteiligen Nachricht ist. Wenn diese Nachricht zu einer mehrteiligen Nachricht gehört, kann der PartNumber-Wert verwendet werden, um die vollständige ursprüngliche Nachricht zu rekonstruieren, und jeder Teil dieser Nachricht hat den gleichen Wert für PartReferenceId.
Timestamp	Gibt den Zeitstempel der Nachricht an. Sie wird lokal für eine erstellte Nachricht instance oder aus dem Service Center-Zeitstempel einer empfangenen Nachricht bestimmt.
To	Gibt die Telefonnummer des Empfängers dieser Nachricht an.

Methoden

FromBinaryData(SmsDataFormat, Byte[])	Decodiert eine binäre Nachricht und platziert die Ergebnisse in einer neuen instance einer TEXTnachricht. Diese Methode stellt die binäre Nachricht als Verweis auf einen Bytespuffer und eine Auswahl der Codierung des Puffers dar. Daher kann es verwendet werden, wenn die Nachricht nicht direkt vom Gerät stammt oder als instance einer SmsBinaryMessage-Klasse.
FromBinaryMessage(SmsBinaryMessage)	Liest eine binäre Nachricht und decodiert sie. Die Ergebnisse werden in einer neuen instance einer SMS platziert.
ToBinaryMessages(SmsDataFormat)	Liest eine Nachricht im angegebenen Format und platziert die Ergebnisse in einer neuen instance einer binären Nachricht.