MsnNotificationClass.SiteURL プロパティ

  • [アーティクル]

MsnNotificationClass

SiteURL は、Microsoft® .NET Alerts プロバイダの Web サイトへの基本 URL を指定する文字列のプロパティです。ActionURL、SubscribeURL、および BodyIcon の各プロパティで指定した値は、この URL を基準にしている必要があります。このプロパティは必須です。

定義

public string SiteURL [ get, set ]

プロパティの値

文字列。サイト URL が含まれます。

解説

このプロパティに指定できる最大許容バイト数は 256 バイトです。この制限は、.NET Alerts クライアント ライブラリではなく、.NET Alerts ルーティング エンジンによって強制されます。長さの制限を超えてもクライアント ライブラリは警告やエラーを出しませんが、ルーティング エンジンによって通知が拒否されます。

.NET Alerts ルーティング エンジンによって通知が処理されると、ActionURL、BodyIcon、および SubscribeURL の各プロパティで指定した相対 URL が、SiteURL で指定した基本サイト URL に追加されます。サイト URL と相対 URL は、結合されて正しい形式の URL になるように指定してください。サイト URL の末尾にスラッシュ ("/") を付けるか、相対 URL の先頭にスラッシュを付けますが、両方付ける必要はありません。

このプロパティは、XML でエンコードされている必要があります。XML エンコードの問題は、通知が米国 MSN® Mobile に登録されたデバイスに配信されない一般的な原因の 1 つです。次の表に、エンコードが必要な文字を示します。

文字 エンコード
< &lt;
> &gt;
& &amp;
" &quot;
' &apos;

.NET Framework クラス ライブラリのメソッド System.Web.HttpUtility.HtmlEncode を使用すると、文字列を XML でエンコードできます。ただし、このメソッドではアポストロフィ (') はエンコードされないので注意が必要です。アポストロフィを使用する場合は、&apos; としてエンコードする必要があります。詳細については、「HtmlEncode メソッド (String) 」を参照してください。

関連項目

C# リファレンスの概要

  |