UrlMappingsSection クラス

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

UrlMappingsSection クラス

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

urlMappings 構成セクションにプログラムからアクセスできるようにします。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 UrlMappingsSection
    Inherits ConfigurationSection

Visual Basic (使用法)

Dim instance As UrlMappingsSection

C#

public sealed class UrlMappingsSection : ConfigurationSection

C++

public ref class UrlMappingsSection sealed
 : public ConfigurationSection

J#

public final class UrlMappingsSection extends
 ConfigurationSection

JScript

public final class UrlMappingsSection extends
 ConfigurationSection

解説

UrlMappingsSection クラスを使用すると、構成ファイルの urlMappings セクションにプログラムからアクセスして変更できます。

メモ
urlMappings セクションには、ユーザーに表示される URL を Web アプリケーションに存在する URL に割り当てる UrlMapping オブジェクトが格納されます。UrlMappingsSection は、値が MachineToApplication のセクション プロパティ AllowDefinition で定義される制限に従って、構成ファイルの関連するセクションに情報を書き込むことができます。階層構造の許可されていないレベルで構成ファイルに書き込みを行おうとした場合、パーサーによってエラー メッセージが生成されます。ただし、このクラスを使用して、階層構造の任意のレベルに構成情報を読み込むことができます。

使用例

既存の Web アプリケーションの構成ファイルから UrlMappingsSection オブジェクトを取得する方法を次のコード例に示します。構成ファイルからの抜粋も示します。

Visual Basic

' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")

' Get the <urlMapping> section.
Dim urlMappingSection _
As UrlMappingsSection = _
CType(configuration.GetSection( _
"system.web/urlMappings"), UrlMappingsSection)

' Get the url mapping collection.
Dim urlMappings _
As UrlMappingCollection = _
urlMappingSection.UrlMappings

C#

// Get the Web application configuration.
System.Configuration.Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration(
    "/aspnetTest");

// Get the <urlMapping> section.
UrlMappingsSection urlMappingSection =
  (UrlMappingsSection)configuration.GetSection(
  "system.web/urlMappings");


// Get the url mapping collection.
UrlMappingCollection urlMappings =
  urlMappingSection.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.Configuration.ConfigurationSection
      System.Web.Configuration.UrlMappingsSection

スレッド セーフ

この型の 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

参照

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