SmsTextMessage クラス

定義

デコードされた SMS テキスト メッセージを管理し、メッセージのプレーン テキスト本文への直接アクセスと、タイムスタンプなどのキー ヘッダー プロパティを提供します。

注意

この機能は、モバイル ネットワークオペレーター、モバイル ブロードバンド アダプター IHV、または OEM による特権アクセスを与えられた、モバイル オペレーター アプリと UWP アプリでのみ使用できます。 詳細については、「 モバイル ブロードバンド」を参照してください。

注意

このクラスとそのメソッドは、以前のバージョンの Windows で使用された従来のデスクトップ アプリのメンテナンスでサポートされています。 このクラスを使用する場合は、アプリのマニフェストで Windows.Devices.Sms.LegacySmsApiContract を指定する必要があります。 Windows 用の新しいアプリを開発する場合は、このクラスを使用しないでください。 代わりに、 Windows.Devices.Sms.LegacySmsApiContract を必要としないこの名前空間の API を使用してください。

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
継承
Object Platform::Object IInspectable SmsTextMessage
属性
実装

Windows の要件

デバイス ファミリ
Windows Desktop Extension SDK (10.0.10240.0 で導入)
API contract
Windows.Devices.Sms.LegacySmsApiContract (v1.0 で導入)
アプリの機能
cellularMessaging sms

コンストラクター

SmsTextMessage()

SmsTextMessage クラスのインスタンスを作成します。

プロパティ

Body

メッセージのプレーン テキスト本文を指定します。

Encoding

このメッセージの送信時に使用するように設定されているエンコードの種類を指定します。

From

メッセージの送信者の電話番号を指定します。

Id

SMS テキスト メッセージの ID を示します。

MessageClass

メッセージのメッセージ クラスを指定します。 このメッセージ クラスは通常、モバイル デバイスではなくネットワーク上で発生します。

PartCount

メッセージがマルチパート メッセージの一部である場合に、元のメッセージのパートの合計数を示します。

PartNumber

このメッセージがマルチパート メッセージの一部である場合に、マルチパート メッセージのパート番号を示します。 PartReferenceId プロパティと PartCount プロパティを組み合わせてパーツを結合することで、元のメッセージを再構築するために使用できます。

PartReferenceId

メッセージがマルチパート メッセージの一部である場合に使用できる参照値を示します。 このメッセージがマルチパート メッセージに属している場合は、 PartNumber 値を使用して元のメッセージ全体を再構築できます。また、そのメッセージの各部分の PartReferenceId の値は同じです。

Timestamp

メッセージのタイムスタンプを示します。 これは、構築されたメッセージ インスタンスに対して、または受信したメッセージのサービス センタータイムスタンプからローカルで決定されます。

To

このメッセージの受信者の電話番号を示します。

メソッド

FromBinaryData(SmsDataFormat, Byte[])

バイナリ メッセージをデコードし、結果をテキスト メッセージの新しいインスタンスに配置します。 このメソッドは、バイナリ メッセージをバイトバッファーへの参照として表し、バッファーのエンコード方法を選択します。 したがって、メッセージがデバイスから直接発信されなかった場合、または SmsBinaryMessage クラスのインスタンスとして使用できます。

FromBinaryMessage(SmsBinaryMessage)

バイナリ メッセージを読み取ってデコードします。 結果は、テキスト メッセージの新しいインスタンスに配置されます。

ToBinaryMessages(SmsDataFormat)

指定した形式のメッセージを読み取り、結果をバイナリ メッセージの新しいインスタンスに配置します。

適用対象