UrlMappingsSection Klasa
Definicja
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.
Zapewnia dostęp programowy do urlMappings sekcji konfiguracji. Klasa ta nie może być dziedziczona.
public ref class UrlMappingsSection sealed : System::Configuration::ConfigurationSectionpublic sealed class UrlMappingsSection : System.Configuration.ConfigurationSectiontype UrlMappingsSection = class
inherit ConfigurationSectionPublic NotInheritable Class UrlMappingsSection
Inherits ConfigurationSection- Dziedziczenie
Przykłady
Poniższy przykład kodu pokazuje, jak uzyskać UrlMappingsSection obiekt z pliku konfiguracji istniejącej aplikacji internetowej. Pokazano również fragment pliku konfiguracji.
// Get the Web application configuration.
System.Configuration.Configuration configuration =
WebConfigurationManager.OpenWebConfiguration(
"/aspnetTest");
// Get the <urlMapping> section.
UrlMappingsSection urlMappingSection =
(UrlMappingsSection)configuration.GetSection(
"system.web/urlMappings");
// Get the url mapping collection.
UrlMappingCollection urlMappings =
urlMappingSection.UrlMappings;
' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the <urlMapping> section.
Dim urlMappingSection _
As UrlMappingsSection = _
CType(configuration.GetSection( _
"system.web/urlMappings"), UrlMappingsSection)
' Get the url mapping collection.
Dim urlMappings _
As UrlMappingCollection = _
urlMappingSection.UrlMappings
<urlMappings enabled="true">
<add url= "~/home.aspx"
mappedUrl="~/default.aspx?parm1=1"/>
<add url= "~/products.aspx"
mappedUrl="~/default.aspx?parm1=2"/>
</urlMappings>
Uwagi
Klasa UrlMappingsSection umożliwia programowy dostęp i modyfikowanie urlMappings sekcji pliku konfiguracji.
Note
Sekcja urlMappings zawiera UrlMapping obiekty mapujące adresy URL wyświetlane użytkownikom na adresy URL istniejące w aplikacji internetowej. Element UrlMappingsSection 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
| Nazwa | Opis |
|---|---|
| UrlMappingsSection() |
Inicjuje nowe wystąpienie klasy UrlMappingsSection. |
Właściwości
| Nazwa | Opis |
|---|---|
| CurrentConfiguration |
Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration, które reprezentuje hierarchię konfiguracji, do którego należy bieżące wystąpienie ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| ElementInformation |
Pobiera obiekt ElementInformation zawierający informacje i funkcje obiektu ConfigurationElement, które nie można dostosowywać. (Odziedziczone po ConfigurationElement) |
| ElementProperty |
Pobiera obiekt ConfigurationElementProperty reprezentujący sam obiekt ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| EvaluationContext |
Pobiera obiekt ContextInformation dla obiektu ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| HasContext |
Pobiera wartość wskazującą, czy właściwość CurrentConfiguration jest |
| IsEnabled |
Pobiera lub ustawia wartość wskazującą, czy mapowanie jest włączone. |
| 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) |
| Properties |
Pobiera kolekcję właściwości. (Odziedziczone po ConfigurationElement) |
| SectionInformation |
Pobiera obiekt SectionInformation zawierający informacje i funkcje obiektu ConfigurationSection, które nie można dostosowywać. (Odziedziczone po ConfigurationSection) |
| UrlMappings |
Pobiera kolekcję UrlMapping obiektów. |
Metody
| Nazwa | Opis |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationElement) |
| DeserializeSection(XmlReader) |
Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationSection) |
| Equals(Object) |
Porównuje bieżące wystąpienie ConfigurationElement z określonym obiektem. (Odziedziczone po ConfigurationElement) |
| GetHashCode() |
Pobiera unikatową wartość reprezentującą bieżące wystąpienie ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| GetRuntimeObject() |
Zwraca obiekt niestandardowy podczas zastępowania w klasie pochodnej. (Odziedziczone po ConfigurationSection) |
| 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() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
| Init() |
Ustawia obiekt ConfigurationElement na stan początkowy. (Odziedziczone po ConfigurationElement) |
| InitializeDefault() |
Służy do inicjowania domyślnego zestawu wartości dla obiektu ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| IsModified() |
Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania, czy załadowany podczas implementacji w klasie pochodnej. (Odziedziczone po ConfigurationSection) |
| IsReadOnly() |
Pobiera wartość wskazującą, czy obiekt ConfigurationElement jest tylko do odczytu. (Odziedziczone po ConfigurationElement) |
| ListErrors(IList) |
Dodaje błędy nieprawidłowej właściwości w tym obiekcie ConfigurationElement i we wszystkich elementach podrzędnych do przekazanej listy. (Odziedziczone po ConfigurationElement) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (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 można odnaleźć wymaganej właściwości. (Odziedziczone po ConfigurationElement) |
| PostDeserialize() |
Wywoływana po deserializacji. (Odziedziczone po ConfigurationElement) |
| PreSerialize(XmlWriter) |
Wywoływana przed serializacji. (Odziedziczone po ConfigurationElement) |
| Reset(ConfigurationElement) |
Resetuje stan wewnętrzny obiektu ConfigurationElement, w tym blokady i kolekcje właściwości. (Odziedziczone po ConfigurationElement) |
| ResetModified() |
Resetuje wartość metody IsModified(), aby |
| SerializeElement(XmlWriter, Boolean) |
Zapisuje zawartość tego elementu konfiguracji w pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Tworzy ciąg XML zawierający niezaergowany widok obiektu ConfigurationSection jako pojedynczą sekcję do zapisu w pliku. (Odziedziczone po ConfigurationSection) |
| 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() |
Ustawia właściwość IsReadOnly() dla obiektu ConfigurationElement i wszystkich podelementów. (Odziedziczone po ConfigurationElement) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Wskazuje, czy określony element powinien być serializowany, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej platformy .NET. (Odziedziczone po ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Wskazuje, czy określona właściwość powinna być serializowana, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej programu .NET Framework. (Odziedziczone po ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Wskazuje, czy bieżące wystąpienie ConfigurationSection powinno być serializowane, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej programu .NET Framework. (Odziedziczone po ConfigurationSection) |
| 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) |
