Die UrlMapping-Klasse ermöglicht es Ihnen, dem URL einer Seite in der Webanwendung einen URL zuzuordnen, der den Benutzern angezeigt wird. Das Hinzufügen eines UrlMapping-Objekts zu einer UrlMappingCollection stellt die programmgesteuerte Entsprechung für das Einbeziehen eines add-Elements in den urlMappings-Abschnitt einer Konfigurationsdatei dar.

Jedes UrlMapping-Objekt enthält zwei Eigenschaften, die einen URL identifizieren. Eine Eigenschaft gibt den URL an, der dem Benutzer angezeigt wird, die andere den URL in der Webanwendung.

Hinweis

UrlMapping kann Informationen in den entsprechenden Abschnitt der Konfigurationsdatei schreiben, wobei die durch die Abschnittseigenschaft AllowDefinition mit dem Wert MachineToApplication definierten Einschränkungen berücksichtigt werden. Beim Versuch, auf einer Ebene, die in der Hierarchie nicht zulässig ist, in eine Konfigurationsdatei zu schreiben, wird vom Parser eine Fehlermeldung generiert. Sie können diese Klasse jedoch zum Lesen von Konfigurationsinformationen auf einer beliebigen Hierarchieebene verwenden.

Im folgenden Codebeispiel wird veranschaulicht, wie auf alle in der Konfigurationsdatei einer vorhandenen Webanwendung angegebenen UrlMapping-Objekte zugegriffen werden kann.

Dim allUrlMappings As New StringBuilder()

Dim url_Mapping As UrlMapping
For Each url_Mapping In urlMappings

    shownUrl = url_Mapping.Url

    mappedUrl = url_Mapping.MappedUrl

    msg = String.Format( _
    "Shown URL:  {0}" + ControlChars.Lf + _
    "Mapped URL: {1}" + ControlChars.Lf, _
    shownUrl, mappedUrl)

    allUrlMappings.AppendLine(msg)
Next url_Mapping

StringBuilder allUrlMappings = new StringBuilder();

foreach (UrlMapping url_Mapping in urlMappings)
{

  shownUrl = url_Mapping.Url;

  mappedUrl = url_Mapping.MappedUrl;

  msg = String.Format(
        "Shown URL:  {0}\nMapped URL: {1}\n",
        shownUrl, mappedUrl);

  allUrlMappings.AppendLine(msg);
}

Im folgenden Auszug aus einer Konfigurationsdatei wird der urlMappings-Abschnitt veranschaulicht.

<urlMappings enabled="true">
  <add url= "~/home.aspx"
    mappedUrl="~/default.aspx?parm1=1"/>
  <add url= "~/products.aspx"
    mappedUrl="~/default.aspx?parm1=2"/>
</urlMappings>

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework