StaticSiteMapProvider.FindSiteMapNode(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает SiteMapNode объект, представляющий страницу по указанному URL-адресу.
public:
override System::Web::SiteMapNode ^ FindSiteMapNode(System::String ^ rawUrl);public override System.Web.SiteMapNode FindSiteMapNode(string rawUrl);override this.FindSiteMapNode : string -> System.Web.SiteMapNodePublic Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNodeПараметры
- rawUrl
- String
URL-адрес, определяющий страницу, для которой требуется получить SiteMapNode.
Возвращаемое значение
Значение SiteMapNode , представляющее страницу, определяемую rawURL; в противном случае , nullесли соответствующий узел карты сайта не найден.
Исключения
rawURL равно null.
Комментарии
Указанный URL-адрес обычно является виртуальным или абсолютным URL-адресом. Это также может быть URL-адрес, использующий синтаксис ASP.NET относительного приложения, например "~/apprelativedirectory". Класс StaticSiteMapProvider автоматически нормализует необработанные URL-адреса относительно приложений абсолютным виртуальным путем.
Объект XmlSiteMapProvider , производный от StaticSiteMapProvider и являющийся поставщиком карты сайта по умолчанию для ASP.NET, использует Url свойство SiteMapNode объекта в качестве ключа подстановки во внутренних коллекциях по умолчанию. Url Если свойство SiteMapNode задано, оно должно быть уникальным в пределах области поставщика карты сайта. Метод FindSiteMapNode пытается получить узлы карты сайта на основе их Url. В противном случае можно использовать Key свойство и соответствующий FindSiteMapNodeFromKey метод для получения узлов карты сайта. Если нет или Url не Key указано, поставщик карты сайта автоматически создает Key свойство для отслеживания узлов карты сайта.
Примечания для тех, кто наследует этот метод
При переопределении FindSiteMapNode(String) метода в производном классе обязательно нормализуйте URL-адреса SiteMapNode объектов, добавляемых поставщику карты сайта, чтобы FindSiteMapNode(String) метод смог получить узел карты сайта независимо от того, предоставляется ли URL-адрес узла карты сайта как абсолютный виртуальный путь или относительный путь приложения.
Поведение обрезки безопасности включается в SiteMapProvider реализации и StaticSiteMapProvider реализации класса. Однако для обрезки безопасности для функции в производных классах необходимо задать Roles свойство всех SiteMapNode объектов, создаваемых при создании поставщика карты сайта при переопределении BuildSiteMap() метода.
