Freigeben über


NavigationTerm.CatalogTargetUrl-Eigenschaft

Ruft die Ziel-URL, der beim Umschreiben von URLs für Katalog-freundliche URLs, die auf dieses Objekt NavigationTerm verwendet wird.

Namespace:  Microsoft.SharePoint.Publishing.Navigation
Assembly:  Microsoft.SharePoint.Publishing (in Microsoft.SharePoint.Publishing.dll)

Syntax

'Declaration
Public ReadOnly Property CatalogTargetUrl As CustomizableString
    Get
'Usage
Dim instance As NavigationTerm
Dim value As CustomizableString

value = instance.CatalogTargetUrl
public CustomizableString CatalogTargetUrl { get; }

Eigenschaftswert

Typ: Microsoft.SharePoint.Publishing.CustomizableString
Eine benutzerdefinierte Zeichenfolge, die den Ziel-URL darstellt, beim Umschreiben von URLs für Katalog-freundliche URLs, die auf dieses Objekt NavigationTerm ist.

Hinweise

Der Webserver führt in der Regel URL-Umschreibung zum Rendern der URL für einen NavigationTerm über die Seite, die durch die TargetUrl -Eigenschaft angegeben ist. Z. B. für den Begriff "Kameras", die URLs könnte folgendermaßen aussehen: Friendly URL: http://example.com/products/camerasTarget URL: /store/Pages/TopicTemplate.aspxjedoch ein Katalog-freundliche URL-Suffix angehängt, dann die CatalogTargetUrl -Eigenschaft wird stattdessen verwendet. Zur Fortsetzung des Beispiels im Zusammenhang mit dem Begriff "Kameras":Catalog Friendly URL: http://example.com/products/cameras/nice-pix-35mm/sku12345URL Suffix: nice-pix-35mm/sku12345 Catalog Target URL: /store/Pages/CatalogItemTemplate.aspx

Katalog-freundliche URLs dienen in der Regel für Produkte wie die hypothetischen "Nice Pix 35-mm-Kamera" im vorherigen Beispiel, die einen Navigation Begriff nicht haben, gehören jedoch zur Kategorie von dem Ausdruck dargestellt wird. Allerdings bleibt die Interpretation des Katalog-freundliche URL-Suffix für die Steuerelemente auf der Zielseite und andere Nutzungsszenarien möglich sind.Wenn der CatalogTargetUrl -Wert eine leere Zeichenfolge ist, URLs werden für die Laufzeit nicht ausgeführt werden, und die Katalog-freundliche URL kann einen HTTP 404-Fehler erzeugen. Die Ziel-URL enthalten Token wie ~site/ (für die serverrelative URL für das zugeordnete SPWeb -Objekt) oder ~sitecollection/ (für die serverrelative URL für das zugeordnete SPSite -Objekt). Diese Token werden von Methoden wie GetResolvedTargetUrl(String, [])erweitert.

Diese Eigenschaft wird nur verwendet, wenn die LinkTypeNavigationLinkType.FriendlyUrlist. Für andere Verbindungstypen zu ändern versucht, eine InvalidOperationException ausgelöst wird verursacht.

Diese Eigenschaft ist ein CustomizableString -Objekt. Der Standardwert wird aus der CatalogTargetUrlForChildTerms.Value -Eigenschaft der übergeordneten, NavigationTerm oder die NavigationTermSet geerbt, wenn keine übergeordneten Ausdruck vorhanden ist.

Siehe auch

Referenz

NavigationTerm Klasse

NavigationTerm-Member

Microsoft.SharePoint.Publishing.Navigation-Namespace