UrlMapping Klass

Definition

Namnområde:: System.Web.Configuration

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Mappar en URL som visas för användare till URL:en för en sida i webbprogrammet. Det går inte att ärva den här klassen.

public ref class UrlMapping sealed : System::Configuration::ConfigurationElement

public sealed class UrlMapping : System.Configuration.ConfigurationElement

type UrlMapping = class
    inherit ConfigurationElement

Public NotInheritable Class UrlMapping
Inherits ConfigurationElement

Arv: Object

ConfigurationElement
UrlMapping

Exempel

I följande exempel används UrlMappingsSection filen Web.config för att mappa två URL:er och lägger till en mappning för ytterligare en URL. När du ändrar och sparar Web.config-filen startas programmet om.

<%@ 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>

Kommentarer

Med UrlMapping klassen kan du mappa en URL som visas för användare till en URL som finns i webbprogrammet. Att lägga till ett UrlMapping objekt i en UrlMappingCollection är den programmatiska motsvarigheten till att inkludera ett add element i avsnittet i urlMappings en konfigurationsfil.

Varje UrlMapping objekt innehåller två egenskaper som identifierar en URL. En egenskap anger den URL som visas för användaren. den andra anger en URL i webbprogrammet. Avslutande blankstegstecken ignoreras i både Url egenskaperna och MappedUrl .

Note

Egenskapen UrlMapping kan skriva information till det relaterade avsnittet i konfigurationsfilen enligt de begränsningar som definieras av avsnittsegenskapen AllowDefinition vars värde är MachineToApplication. Försök att skriva i en konfigurationsfil på en nivå som inte tillåts i hierarkin resulterar i ett felmeddelande som genereras av parsern. Du kan dock använda den här klassen för att läsa konfigurationsinformation på valfri nivå i hierarkin.

Konstruktorer

Name	Description
UrlMapping(String, String)	Initierar en ny instans av UrlMapping klassen.

Egenskaper

Name	Description
CurrentConfiguration	Hämtar en referens till den översta instansen Configuration som representerar konfigurationshierarkin som den aktuella ConfigurationElement instansen tillhör. (Ärvd från ConfigurationElement)
ElementInformation	Hämtar ett ElementInformation objekt som innehåller den icke-anpassningsbara informationen och funktionerna i ConfigurationElement objektet. (Ärvd från ConfigurationElement)
ElementProperty	Hämtar objektet ConfigurationElementProperty som representerar ConfigurationElement själva objektet. (Ärvd från ConfigurationElement)
EvaluationContext	Hämtar ContextInformation-objektet för ConfigurationElement-objektet. (Ärvd från ConfigurationElement)
HasContext	Hämtar ett värde som anger om egenskapen CurrentConfiguration är `null`. (Ärvd från ConfigurationElement)
Item[ConfigurationProperty]	Hämtar eller anger en egenskap eller ett attribut för det här konfigurationselementet. (Ärvd från ConfigurationElement)
Item[String]	Hämtar eller anger en egenskap, ett attribut eller ett underordnat element i det här konfigurationselementet. (Ärvd från ConfigurationElement)
LockAllAttributesExcept	Hämtar samlingen med låsta attribut. (Ärvd från ConfigurationElement)
LockAllElementsExcept	Hämtar samlingen med låsta element. (Ärvd från ConfigurationElement)
LockAttributes	Hämtar samlingen med låsta attribut. (Ärvd från ConfigurationElement)
LockElements	Hämtar samlingen med låsta element. (Ärvd från ConfigurationElement)
LockItem	Hämtar eller anger ett värde som anger om elementet är låst. (Ärvd från ConfigurationElement)
MappedUrl	En URL i webbappen.
Properties	Hämtar samlingen med egenskaper. (Ärvd från ConfigurationElement)
Url	Hämtar den URL som visas för användaren.

Metoder

Name	Description
DeserializeElement(XmlReader, Boolean)	Läser XML från konfigurationsfilen. (Ärvd från ConfigurationElement)
Equals(Object)	Jämför den aktuella ConfigurationElement instansen med det angivna objektet. (Ärvd från ConfigurationElement)
GetHashCode()	Hämtar ett unikt värde som representerar den aktuella ConfigurationElement instansen. (Ärvd från ConfigurationElement)
GetTransformedAssemblyString(String)	Returnerar den transformerade versionen av det angivna sammansättningsnamnet. (Ärvd från ConfigurationElement)
GetTransformedTypeString(String)	Returnerar den transformerade versionen av det angivna typnamnet. (Ärvd från ConfigurationElement)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
Init()	Anger objektets ConfigurationElement ursprungliga tillstånd. (Ärvd från ConfigurationElement)
InitializeDefault()	Används för att initiera en standarduppsättning med värden för ConfigurationElement objektet. (Ärvd från ConfigurationElement)
IsModified()	Anger om det här konfigurationselementet har ändrats sedan det senast sparades eller lästes in när det implementerades i en härledd klass. (Ärvd från ConfigurationElement)
IsReadOnly()	Hämtar ett värde som anger om objektet ConfigurationElement är skrivskyddat. (Ärvd från ConfigurationElement)
ListErrors(IList)	Lägger till felen invalid-property i det här ConfigurationElement objektet, och i alla underelement, i den överförda listan. (Ärvd från ConfigurationElement)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnDeserializeUnrecognizedAttribute(String, String)	Hämtar ett värde som anger om ett okänt attribut påträffas under deserialiseringen. (Ärvd från ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Hämtar ett värde som anger om ett okänt element påträffas under deserialiseringen. (Ärvd från ConfigurationElement)
OnRequiredPropertyNotFound(String)	Utlöser ett undantag när en obligatorisk egenskap inte hittas. (Ärvd från ConfigurationElement)
PostDeserialize()	Anropas efter deserialisering. (Ärvd från ConfigurationElement)
PreSerialize(XmlWriter)	Anropas före serialisering. (Ärvd från ConfigurationElement)
Reset(ConfigurationElement)	Återställer objektets interna tillstånd ConfigurationElement , inklusive låsen och egenskapssamlingarna. (Ärvd från ConfigurationElement)
ResetModified()	Återställer värdet för metoden till IsModified() när den `false` implementeras i en härledd klass. (Ärvd från ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Skriver innehållet i det här konfigurationselementet till konfigurationsfilen när det implementeras i en härledd klass. (Ärvd från ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Skriver de yttre taggarna för det här konfigurationselementet till konfigurationsfilen när det implementeras i en härledd klass. (Ärvd från ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Anger en egenskap till det angivna värdet. (Ärvd från ConfigurationElement)
SetReadOnly()	Anger egenskapen IsReadOnly() för ConfigurationElement objektet och alla underelement. (Ärvd från ConfigurationElement)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Ändrar objektet ConfigurationElement för att ta bort alla värden som inte ska sparas. (Ärvd från ConfigurationElement)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?