UrlMapping Klas

Definitie

Naamruimte:: System.Web.Configuration

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt een URL toegewezen die wordt weergegeven aan gebruikers aan de URL van een pagina in uw webtoepassing. Deze klasse kan niet worden overgenomen.

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

Overname: Object

ConfigurationElement
UrlMapping

Voorbeelden

In het volgende voorbeeld wordt het UrlMappingsSection Web.config-bestand gebruikt om twee URL's toe te wijzen en wordt een toewijzing toegevoegd voor een extra URL. Wanneer u het Web.config-bestand wijzigt en opslaat, wordt de toepassing opnieuw opgestart.

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

Opmerkingen

Met de UrlMapping klasse kunt u een URL toewijzen die wordt weergegeven aan gebruikers aan een URL die in uw webtoepassing bestaat. Het toevoegen van een UrlMapping object aan een UrlMappingCollection is het programmatische equivalent aan het opnemen van een add element in de urlMappings sectie van een configuratiebestand.

Elk UrlMapping object bevat twee eigenschappen die een URL identificeren. Eén eigenschap geeft de URL aan die aan de gebruiker wordt weergegeven; de andere geeft een URL op in uw webtoepassing. Volgspaties worden genegeerd in zowel de als Url de MappedUrl eigenschappen.

Note

De UrlMapping eigenschap kan informatie naar de gerelateerde sectie van het configuratiebestand schrijven op basis van de beperkingen die zijn gedefinieerd door de sectie-eigenschap AllowDefinition waarvan de waarde is MachineToApplication. Elke poging om in een configuratiebestand te schrijven op een niveau dat niet is toegestaan in de hiërarchie, resulteert in een foutbericht dat door de parser wordt gegenereerd. U kunt deze klasse echter gebruiken om configuratiegegevens te lezen op elk niveau in de hiërarchie.

Constructors

Name	Description
UrlMapping(String, String)	Initialiseert een nieuw exemplaar van de UrlMapping klasse.

Eigenschappen

Name	Description
CurrentConfiguration	Hiermee wordt een verwijzing opgehaald naar het exemplaar op het hoogste niveau Configuration dat de configuratiehiërarchie vertegenwoordigt waartoe het huidige ConfigurationElement exemplaar behoort. (Overgenomen van ConfigurationElement)
ElementInformation	Hiermee haalt u een ElementInformation object op dat de niet-aanpasbare informatie en functionaliteit van het ConfigurationElement object bevat. (Overgenomen van ConfigurationElement)
ElementProperty	Hiermee haalt u het ConfigurationElementProperty object op dat het ConfigurationElement object zelf vertegenwoordigt. (Overgenomen van ConfigurationElement)
EvaluationContext	Hiermee haalt u het ContextInformation object voor het ConfigurationElement object op. (Overgenomen van ConfigurationElement)
HasContext	Hiermee wordt een waarde opgehaald die aangeeft of de CurrentConfiguration eigenschap is `null`. (Overgenomen van ConfigurationElement)
Item[ConfigurationProperty]	Hiermee wordt een eigenschap of kenmerk van dit configuratie-element opgehaald of ingesteld. (Overgenomen van ConfigurationElement)
Item[String]	Hiermee wordt een eigenschap, kenmerk of onderliggend element van dit configuratie-element opgehaald of ingesteld. (Overgenomen van ConfigurationElement)
LockAllAttributesExcept	Hiermee haalt u de verzameling vergrendelde kenmerken op. (Overgenomen van ConfigurationElement)
LockAllElementsExcept	Hiermee haalt u de verzameling vergrendelde elementen op. (Overgenomen van ConfigurationElement)
LockAttributes	Hiermee haalt u de verzameling vergrendelde kenmerken op. (Overgenomen van ConfigurationElement)
LockElements	Hiermee haalt u de verzameling vergrendelde elementen op. (Overgenomen van ConfigurationElement)
LockItem	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het element is vergrendeld. (Overgenomen van ConfigurationElement)
MappedUrl	Een URL in uw webtoepassing.
Properties	Hiermee haalt u de verzameling eigenschappen op. (Overgenomen van ConfigurationElement)
Url	Hiermee haalt u de URL op die wordt weergegeven aan de gebruiker.

Methoden

Name	Description
DeserializeElement(XmlReader, Boolean)	Leest XML uit het configuratiebestand. (Overgenomen van ConfigurationElement)
Equals(Object)	Vergelijkt het huidige ConfigurationElement exemplaar met het opgegeven object. (Overgenomen van ConfigurationElement)
GetHashCode()	Hiermee haalt u een unieke waarde op die het huidige ConfigurationElement exemplaar vertegenwoordigt. (Overgenomen van ConfigurationElement)
GetTransformedAssemblyString(String)	Retourneert de getransformeerde versie van de opgegeven assemblynaam. (Overgenomen van ConfigurationElement)
GetTransformedTypeString(String)	Retourneert de getransformeerde versie van de opgegeven typenaam. (Overgenomen van ConfigurationElement)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
Init()	Hiermee stelt u het object in op de ConfigurationElement oorspronkelijke status. (Overgenomen van ConfigurationElement)
InitializeDefault()	Wordt gebruikt om een standaardset waarden voor het ConfigurationElement object te initialiseren. (Overgenomen van ConfigurationElement)
IsModified()	Geeft aan of dit configuratie-element is gewijzigd sinds het voor het laatst is opgeslagen of geladen, wanneer dit is geïmplementeerd in een afgeleide klasse. (Overgenomen van ConfigurationElement)
IsReadOnly()	Hiermee wordt een waarde opgehaald die aangeeft of het ConfigurationElement object het kenmerk Alleen-lezen heeft. (Overgenomen van ConfigurationElement)
ListErrors(IList)	Voegt de fouten met ongeldige eigenschappen in dit ConfigurationElement object en in alle subelementen toe aan de doorgegeven lijst. (Overgenomen van ConfigurationElement)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnDeserializeUnrecognizedAttribute(String, String)	Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend kenmerk wordt aangetroffen tijdens deserialisatie. (Overgenomen van ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend element wordt aangetroffen tijdens deserialisatie. (Overgenomen van ConfigurationElement)
OnRequiredPropertyNotFound(String)	Genereert een uitzondering wanneer een vereiste eigenschap niet wordt gevonden. (Overgenomen van ConfigurationElement)
PostDeserialize()	Gebeld na ontserialisatie. (Overgenomen van ConfigurationElement)
PreSerialize(XmlWriter)	Aangeroepen vóór serialisatie. (Overgenomen van ConfigurationElement)
Reset(ConfigurationElement)	Hiermee stelt u de interne status van het ConfigurationElement object opnieuw in, inclusief de vergrendelingen en de eigenschappenverzamelingen. (Overgenomen van ConfigurationElement)
ResetModified()	Hiermee stelt u de waarde van de methode IsModified() opnieuw in wanneer deze `false` wordt geïmplementeerd in een afgeleide klasse. (Overgenomen van ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Schrijft de inhoud van dit configuratie-element naar het configuratiebestand wanneer deze wordt geïmplementeerd in een afgeleide klasse. (Overgenomen van ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Hiermee schrijft u de buitenste tags van dit configuratie-element naar het configuratiebestand wanneer het wordt geïmplementeerd in een afgeleide klasse. (Overgenomen van ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Hiermee stelt u een eigenschap in op de opgegeven waarde. (Overgenomen van ConfigurationElement)
SetReadOnly()	Hiermee stelt u de IsReadOnly() eigenschap voor het ConfigurationElement object en alle subelementen in. (Overgenomen van ConfigurationElement)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Hiermee wijzigt u het ConfigurationElement object om alle waarden te verwijderen die niet mogen worden opgeslagen. (Overgenomen van ConfigurationElement)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?