Per Mausklick bewerten und Feedback geben
MSDN
MSDN Library
.NET Entwicklung
UrlMapping-Klasse
Diese Seite ist spezifisch für
Microsoft Visual Studio 2005/.NET Framework 2.0

Andere Versionen stehen ebenfalls zur Verfügung für:
.NET Framework-Klassenbibliothek
UrlMapping-Klasse

Hinweis: Diese Klasse ist neu in .NET Framework, Version 2.0.

Ordnet dem URL einer Seite in der Webanwendung einen URL zu, der den Benutzern angezeigt wird. Diese Klasse kann nicht geerbt werden.

Namespace: System.Web.Configuration
Assembly: System.Web (in system.web.dll)

Visual Basic (Deklaration)
Public NotInheritable Class UrlMapping
    Inherits ConfigurationElement
Visual Basic (Verwendung)
Dim instance As UrlMapping
C#
public sealed class UrlMapping : ConfigurationElement
C++
public ref class UrlMapping sealed : public ConfigurationElement
J#
public final class UrlMapping extends ConfigurationElement
JScript
public final class UrlMapping extends ConfigurationElement

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.

HinweisHinweis

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.

Visual Basic
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

C#
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>
System.Object
   System.Configuration.ConfigurationElement
    System.Web.Configuration.UrlMapping
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

Unterstützt in: 2.0
© 2009 Microsoft Corporation. Alle Rechte vorbehalten. Nutzungsbedingungen  |  Markenzeichen  |  Informationen zur Datensicherheit
Page view tracker