UrlMapping 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将显示给用户的 URL 映射到 Web 应用程序中某个页面的 URL。 此类不能被继承。
public ref class UrlMapping sealed : System::Configuration::ConfigurationElementpublic sealed class UrlMapping : System.Configuration.ConfigurationElementtype UrlMapping = class
inherit ConfigurationElementPublic NotInheritable Class UrlMapping
Inherits ConfigurationElement- 继承
示例
以下示例使用 UrlMappingsSection Web.config 文件映射两个 URL，并为其他 URL 添加映射。 修改并保存Web.config文件时，应用程序将重启。
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Configuration" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
int showVal = 0;
protected void Page_Load(object sender, EventArgs e)
{
// Get the parameter value from the QueryString
if (Request.Params["show"] != null)
showVal = Int32.Parse(Request.Params["show"]);
// Show a page depending on the parameter value
NoShowPanel.Visible = (showVal == 0);
ShowHomePage.Visible = (showVal == 1);
ShowProductsPage.Visible = (showVal == 2);
ShowEventsPage.Visible = (showVal == 3);
// <Snippet2>
UrlMapping urlMap = null;
// Open Web.config
Configuration config =
WebConfigurationManager.OpenWebConfiguration("~");
// Get the UrlMappings section
UrlMappingsSection urlMapSection =
(UrlMappingsSection)config.GetSection(
"system.web/urlMappings");
// Modify UrlMapping in Web.config first time through
if (!Page.IsPostBack)
{
// If not already added, add a UrlMapping to the section
if (urlMapSection.UrlMappings.Count == 2)
{
urlMap = new UrlMapping("~/events.aspx",
"~/default.aspx?show=3");
urlMapSection.UrlMappings.Add(urlMap);
// This line assumes permission to write to disk
config.Save();
}
}
if (showVal > 0)
{
// <Snippet4>
urlMap = (UrlMapping)urlMapSection.UrlMappings[showVal - 1];
realURL.Text = urlMap.MappedUrl;
// </Snippet4>
}
// </Snippet2>
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>UrlMapping Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Panel ID="NoShowPanel" runat="server" Visible="true">
<h2>Show no page</h2>
<p><a href="home.aspx">Home.aspx</a></p>
<p><a href="products.aspx">Products.aspx</a></p>
<p><a href="events.aspx">Events.aspx</a></p>
</asp:Panel>
<asp:Panel ID="ShowHomePage" runat="server" Visible="false">
<h2>Home Page</h2>
<p><a href="products.aspx">Products.aspx</a></p>
<p><a href="events.aspx">Events.aspx</a></p>
</asp:Panel>
<asp:Panel ID="ShowProductsPage" runat="server" Visible="false">
<h2>Products Page</h2>
<p><a href="home.aspx">Home.aspx</a></p>
<p><a href="events.aspx">Events.aspx</a></p>
</asp:Panel>
<asp:Panel ID="ShowEventsPage" runat="server" Visible="false">
<h2>Events Page</h2>
<p><a href="home.aspx">Home.aspx</a></p>
<p><a href="products.aspx">Products.aspx</a></p>
</asp:Panel>
<p>The real URL for this page is
<asp:Label ID="realURL" runat="server">[None]</asp:Label></p>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Configuration" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Dim showVal As Integer
Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Get the parameter value from the QueryString
If Not IsNothing(Request.Params("show")) Then
showVal = Int32.Parse(Request.Params("show"))
Else
showVal = 0
End If
' Show a page depending on the parameter value
NoShowPanel.Visible = (showVal = 0)
ShowHomePage.Visible = (showVal = 1)
ShowProductsPage.Visible = (showVal = 2)
ShowEventsPage.Visible = (showVal = 3)
' <Snippet2>
dim urlMap as UrlMapping
Dim config As Configuration
' Open Web.config
config = _
WebConfigurationManager.OpenWebConfiguration("~")
' Get the UrlMappings section
Dim urlMapSection As UrlMappingsSection
urlMapSection = _
CType(config.GetSection( _
"system.web/urlMappings"), UrlMappingsSection)
' Modify UrlMapping in Web.config first time through
If (Not Page.IsPostBack) Then
' If not already added, add a UrlMapping to the section
If urlMapSection.UrlMappings.Count = 2 Then
urlMap = New UrlMapping("~/events.aspx", _
"~/default.aspx?show=3")
urlMapSection.UrlMappings.Add(urlMap)
' This line assumes permission to write to disk
config.Save()
End If
End If
If showVal > 0 Then
'<Snippet4>
urlMap = CType(urlMapSection.UrlMappings(showVal - 1), UrlMapping)
realURL.Text = urlMap.MappedUrl
'</Snippet4>
End If
' </Snippet2>
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>UrlMapping Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Panel ID="NoShowPanel" runat="server" Visible="true">
<h2>Show no page</h2>
<p><a href="home.aspx">Home.aspx</a></p>
<p><a href="products.aspx">Products.aspx</a></p>
<p><a href="events.aspx">Events.aspx</a></p>
</asp:Panel>
<asp:Panel ID="ShowHomePage" runat="server" Visible="false">
<h2>Home Page</h2>
<p><a href="products.aspx">Products.aspx</a></p>
<p><a href="events.aspx">Events.aspx</a></p>
</asp:Panel>
<asp:Panel ID="ShowProductsPage" runat="server" Visible="false">
<h2>Products Page</h2>
<p><a href="home.aspx">Home.aspx</a></p>
<p><a href="events.aspx">Events.aspx</a></p>
</asp:Panel>
<asp:Panel ID="ShowEventsPage" runat="server" Visible="false">
<h2>Events Page</h2>
<p><a href="home.aspx">Home.aspx</a></p>
<p><a href="products.aspx">Products.aspx</a></p>
</asp:Panel>
<p>The real URL for this page is
<asp:Label ID="realURL" runat="server">default.aspx</asp:Label></p>
</div>
</form>
</body>
</html>
注解
该 UrlMapping 类允许将显示的 URL 映射到 Web 应用程序中存在的 URL。 UrlMapping将对象添加到某个UrlMappingCollection对象与在add配置文件节中包含urlMappings元素是编程等效的。
每个 UrlMapping 对象都包含标识 URL 的两个属性。 一个属性指定向用户显示的 URL;另一个指定 Web 应用程序中的 URL。 尾随空格字符在属性MappedUrl中Url将被忽略。
备注
该UrlMapping属性可以根据其值为MachineToApplication的 section 属性AllowDefinition定义的限制，将信息写入配置文件的相关部分。 在层次结构中不允许的级别写入配置文件的任何尝试都将导致分析器生成的错误消息。 但是，可以使用此类在层次结构中的任何级别读取配置信息。
构造函数
| UrlMapping(String, String) |
初始化 UrlMapping 类的新实例。 |