UrlMapping クラス

.NET Framework クラス ライブラリ リファレンス

UrlMapping クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーに表示される URL を、Web アプリケーションのページの URL に割り当てます。このクラスは継承できません。

名前空間: System.Web.Configuration
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 UrlMapping
    Inherits ConfigurationElement

Visual Basic (使用法)

Dim instance As UrlMapping

C#

public sealed class UrlMapping : ConfigurationElement

C++

public ref class UrlMapping sealed : public
 ConfigurationElement

J#

public final class UrlMapping extends ConfigurationElement

JScript

public final class UrlMapping extends
 ConfigurationElement

解説

UrlMapping クラスを使用すると、ユーザーに表示される URL を Web アプリケーションに存在する URL に割り当てることができます。UrlMapping オブジェクトを UrlMappingCollection に追加することは、構成ファイルの urlMappings セクションに add 要素を含めることと、プログラム的に等価です。

各 UrlMapping オブジェクトには、URL を指定する 2 つのプロパティが格納されます。片方のプロパティはユーザーに表示される URL を指定し、もう片方には Web アプリケーションの URL を指定します。

メモ
UrlMapping は、値が MachineToApplication のセクション プロパティ AllowDefinition で定義される制限に従って、構成ファイルの関連するセクションに情報を書き込むことができます。階層構造の許可されていないレベルで構成ファイルに書き込みを行おうとした場合、パーサーによってエラー メッセージが生成されます。ただし、このクラスを使用して、階層構造の任意のレベルに構成情報を読み込むことができます。

使用例

既存の Web アプリケーションの構成ファイルに指定されているすべての UrlMapping オブジェクトにアクセスする方法を次のコード例に示します。

Visual Basic

Dim allUrlMappings As New
 StringBuilder()

Dim url_Mapping As UrlMapping
For Each url_Mapping In
 urlMappings

    shownUrl = url_Mapping.Url

    mappedUrl = url_Mapping.MappedUrl

    msg = String.Format( _
    "Shown URL:  {0}" + ControlChars.Lf + _
    "Mapped URL: {1}" + ControlChars.Lf, _
    shownUrl, mappedUrl)

    allUrlMappings.AppendLine(msg)
Next url_Mapping

C#

StringBuilder allUrlMappings = new StringBuilder();

foreach (UrlMapping url_Mapping in urlMappings)
{

  shownUrl = url_Mapping.Url;

  mappedUrl = url_Mapping.MappedUrl;

  msg = String.Format(
        "Shown URL:  {0}\nMapped URL: {1}\n",
        shownUrl, mappedUrl);

  allUrlMappings.AppendLine(msg);
}

以下は構成ファイルからの抜粋で、urlMappings セクションを示します。

<urlMappings enabled="true">
  <add url= "~/home.aspx"
    mappedUrl="~/default.aspx?parm1=1"/>
  <add url= "~/products.aspx"
    mappedUrl="~/default.aspx?parm1=2"/>
</urlMappings>

継承階層

System.Object
   System.Configuration.ConfigurationElement
    System.Web.Configuration.UrlMapping

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
UrlMapping メンバ
System.Web.Configuration 名前空間
UrlMappingsSection
UrlMappingCollection
その他の技術情報
urlMappings 要素 (ASP.NET 設定スキーマ)