UrlMapping Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Configuration

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Mapy adres URL wyświetlany użytkownikom na adres URL strony w aplikacji internetowej. Klasa ta nie może być dziedziczona.

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

Dziedziczenie: Object

ConfigurationElement
UrlMapping

Przykłady

W poniższym przykładzie użyto UrlMappingsSection pliku Web.config do mapowania dwóch adresów URL i dodania mapowania dodatkowego adresu URL. Podczas modyfikowania i zapisywania pliku Web.config aplikacja zostanie ponownie uruchomiona.

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

Uwagi

Klasa UrlMapping umożliwia mapowania adresu URL wyświetlanego użytkownikom na adres URL, który istnieje w aplikacji internetowej. UrlMapping Dodanie obiektu do obiektu UrlMappingCollection jest programowym odpowiednikiem dołączania add elementu w urlMappings sekcji pliku konfiguracji.

Każdy UrlMapping obiekt zawiera dwie właściwości identyfikujące adres URL. Jedna właściwość określa adres URL wyświetlany użytkownikowi; drugi określa adres URL w aplikacji internetowej. Końcowe znaki odstępu są ignorowane zarówno we właściwościach , jak Url i MappedUrl .

Uwaga

Właściwość UrlMapping może zapisywać informacje w powiązanej sekcji pliku konfiguracji zgodnie z ograniczeniami zdefiniowanymi przez właściwość AllowDefinition sekcji, której wartość to MachineToApplication. Każda próba zapisania w pliku konfiguracji na poziomie niedozwolonym w hierarchii spowoduje wyświetlenie komunikatu o błędzie wygenerowanego przez analizator. Można jednak użyć tej klasy do odczytywania informacji o konfiguracji na dowolnym poziomie w hierarchii.

Konstruktory

UrlMapping(String, String)

Inicjuje nowe wystąpienie klasy UrlMapping.

Właściwości

CurrentConfiguration	Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration , które reprezentuje hierarchię konfiguracji, do którego należy bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement)
ElementInformation	ElementInformation Pobiera obiekt, który zawiera niezstosowalne informacje i funkcje ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement)
ElementProperty	ConfigurationElementProperty Pobiera obiekt reprezentujący ConfigurationElement sam obiekt. (Odziedziczone po ConfigurationElement)
EvaluationContext	ContextInformation Pobiera obiekt dla ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement)
HasContext	Pobiera wartość wskazującą, czy CurrentConfiguration właściwość to `null`. (Odziedziczone po ConfigurationElement)
Item[ConfigurationProperty]	Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji. (Odziedziczone po ConfigurationElement)
Item[String]	Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji. (Odziedziczone po ConfigurationElement)
LockAllAttributesExcept	Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement)
LockAllElementsExcept	Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement)
LockAttributes	Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement)
LockElements	Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement)
LockItem	Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany. (Odziedziczone po ConfigurationElement)
MappedUrl	Adres URL w aplikacji internetowej.
Properties	Pobiera kolekcję właściwości. (Odziedziczone po ConfigurationElement)
Url	Pobiera adres URL wyświetlany użytkownikowi.

Metody

DeserializeElement(XmlReader, Boolean)	Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationElement)
Equals(Object)	Porównuje bieżące ConfigurationElement wystąpienie z określonym obiektem. (Odziedziczone po ConfigurationElement)
GetHashCode()	Pobiera unikatową wartość reprezentującą bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement)
GetTransformedAssemblyString(String)	Zwraca przekształconą wersję określonej nazwy zestawu. (Odziedziczone po ConfigurationElement)
GetTransformedTypeString(String)	Zwraca przekształconą wersję określonej nazwy typu. (Odziedziczone po ConfigurationElement)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
Init()	ConfigurationElement Ustawia obiekt na stan początkowy. (Odziedziczone po ConfigurationElement)
InitializeDefault()	Służy do inicjowania domyślnego zestawu wartości dla ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement)
IsModified()	Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania lub załadowania, gdy został zaimplementowany w klasie pochodnej. (Odziedziczone po ConfigurationElement)
IsReadOnly()	Pobiera wartość wskazującą, czy ConfigurationElement obiekt jest tylko do odczytu. (Odziedziczone po ConfigurationElement)
ListErrors(IList)	Dodaje błędy nieprawidłowej właściwości w tym ConfigurationElement obiekcie i we wszystkich podelementach do przekazanej listy. (Odziedziczone po ConfigurationElement)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnDeserializeUnrecognizedAttribute(String, String)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut. (Odziedziczone po ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany element. (Odziedziczone po ConfigurationElement)
OnRequiredPropertyNotFound(String)	Zgłasza wyjątek, gdy nie znaleziono wymaganej właściwości. (Odziedziczone po ConfigurationElement)
PostDeserialize()	Wywoływana po deserializacji. (Odziedziczone po ConfigurationElement)
PreSerialize(XmlWriter)	Wywoływane przed serializacji. (Odziedziczone po ConfigurationElement)
Reset(ConfigurationElement)	Resetuje stan ConfigurationElement wewnętrzny obiektu, w tym blokady i kolekcje właściwości. (Odziedziczone po ConfigurationElement)
ResetModified()	Resetuje wartość IsModified() metody w `false` przypadku implementacji w klasie pochodnej. (Odziedziczone po ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Zapisuje zawartość tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Zapisuje zewnętrzne tagi tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Ustawia właściwość na określoną wartość. (Odziedziczone po ConfigurationElement)
SetReadOnly()	IsReadOnly() Ustawia właściwość obiektu ConfigurationElement i wszystkich podelementów. (Odziedziczone po ConfigurationElement)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modyfikuje obiekt, ConfigurationElement aby usunąć wszystkie wartości, które nie powinny być zapisywane. (Odziedziczone po ConfigurationElement)

Dotyczy