StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет объект SiteMapNode в коллекции, которые поддерживаются поставщиком карты веб-узла, и устанавливает между объектами SiteMapNode связь типа "родители-потомки".
protected public:
override void AddNode(System::Web::SiteMapNode ^ node, System::Web::SiteMapNode ^ parentNode);protected internal override void AddNode (System.Web.SiteMapNode node, System.Web.SiteMapNode parentNode);override this.AddNode : System.Web.SiteMapNode * System.Web.SiteMapNode -> unitProtected Friend Overrides Sub AddNode (node As SiteMapNode, parentNode As SiteMapNode)Параметры
- node
- SiteMapNode
Объект SiteMapNode, добавляемый к поставщику карты веб-узла.
- parentNode
- SiteMapNode
Объект SiteMapNode, в который следует добавить параметр node.
Исключения
node имеет значение null.
Объект Url или Key уже зарегистрирован с объектом StaticSiteMapProvider. узел карты веб-узла должен быть создан из страниц с уникальными URL-адресами или ключами.
Комментарии
Узел карты сайта, определяемый параметром node , добавляется во внутреннюю коллекцию и между ним и узлом карты сайта, определяемым параметром parentNode , создается связь "родитель-потомок".
URL-адрес узла карты сайта может быть интерпретирован при его добавлении во внутренние коллекции. Относительные и относительные URL-адреса приложения расширяются до абсолютных виртуальных путей приложения, которые затем используются для внутреннего хранения и доступа к отдельным экземплярам SiteMapNode класса . Другие URL-адреса, такие как физические пути, пути с протоколами в них и UNC-пути, не интерпретируются.
Класс XmlSiteMapProvider , производный от StaticSiteMapProvider класса и являющийся поставщиком карты сайта по умолчанию для ASP.NET, по умолчанию использует Url свойство объекта в качестве ключа подстановки SiteMapNode во внутренних коллекциях. Url Если свойство объекта заданоSiteMapNode, оно должно быть уникальным в пределах области действия поставщика карты сайта. Метод FindSiteMapNode пытается получить узлы карты сайта на основе их Url свойства. В противном случае можно использовать Key свойство и соответствующий FindSiteMapNodeFromKey метод для получения узлов карты сайта. Если не Url указано или Key , поставщик карты сайта автоматически создает Key для отслеживания узлов карты сайта.
Примечания для тех, кто наследует этот метод
При переопределении AddNode(SiteMapNode, SiteMapNode) метода убедитесь, что свойству Key присвоено уникальное значение при добавлении узла карты сайта с помощью AddNode метода .
