Freigeben über

URLs und Tokens in SharePoint

  • Artikel

Erfahren Sie, wie Sie URLs bilden und URL-Token in SharePoint verwenden.

Typen von URLs in SharePoint

SharePoint analysiert URL-Zeichenfolgen, um die Form der URL basierend auf einem angegebenen Protokoll (z. B. http:) oder der Platzierung eines Schrägstrichs (/) innerhalb der Zeichenfolge zu bestimmen. In Abhängigkeit von dem bestimmten Element können Sie die folgenden URL-Formen verwenden:

  • Eine absolute URL gibt einen vollständigen Pfad an und beginnt mit einem Protokoll. Beispielhttp://: domain_or_server/[ sites/] Web_Site/ Lists/ List_Title/ AllItems.aspx.

  • Eine domänenbezogene URL basiert auf der Domänenadresse (die aus dem Namen eines Servers bestehen kann) und beginnt immer mit einem Schrägstrich. Sie gibt einen vollständigen Pfad von der Website auf höchster Ebene bis zum Dateinamen an. Beispiel: /[ sites/] Website/ Lists/ Listentitel/ AllItems.aspx.

  • Eine websitebezogene URL basiert auf der Adresse eines Websiteobjekts ( SPWeb ). Sie beginnt nicht mit einem Schrägstrich und gibt einen vollständigen Pfad von der Websiteadresse bis zum Dateinamen an. Beispiel: Lists/List_Title/ AllItems.aspx.

  • Eine auf eine Datei oder einen Ordner bezogene URL basiert auf dem Ordner, der die Datei enthält. Sie enthält keine Schrägstriche. Sie gibt einfach den Namen der Datei an. Beispiel: AllItems.aspx.

Hinweis

Es gibt kein Konzept einer auf Websitesammlungen bezogenen URL. Die Übergabe einer derartigen URL kann zu einem Codefehler führen.

Bewährte Methoden für Bild-URLs

Wenn Sie eine URL zu einer Bilddatei erstellen, die sich im Verzeichnis %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\1033\IMAGES befindet, geben Sie einen Pfad an, der die Stammwebsite der Websitesammlung verwendet, aber keine Unterwebsite im Pfad enthält. Verwenden Sie z. B. "/_layouts/images/MyImage.gif" für eine Bilddatei, nicht "/MySubsite/_layouts/images/MyImage.gif". Der Grund hierfür ist, dass die URLs der untergeordneten Website in Abhängigkeit davon, wo sie verwendet werden, auf andere Weise aufgelöst werden. Sie können diese Variationen ignorieren, wenn Sie immer die relative URL der Stammwebsite verwenden.

URL-Token in SharePoint

SharePoint unterstützt die in den folgenden Tabellen aufgeführten Token für SharePoint-Add-Ins oder Farmlösungen. Zudem können einige Token nur in Apps verwendet werden. Weitere Informationen dazu finden Sie unter URL-Zeichenfolgen und Token in SharePoint-Add-Ins.

Die Token in den Tabellen dieses Abschnitts können in URLs in einer Vielzahl von Situationen in der SharePoint-Entwicklung verwendet werden, z. B. in benutzerdefinierten Aktionen und in Links auf benutzerdefinierten Seiten. In bestimmten Kontexten können diese Token nicht verwendet werden. Drei der wichtigsten Stellen, an denen nur eine eingeschränkte Liste von Token verwendet werden kann, sind die Startseite einer App, eine benutzerdefinierte Aktion im Hostweb und die Src-Eigenschaft eines App-Parts. Diese werden in separaten Spalten genannt, aber diese drei sind keine vollständige Liste der Orte, an denen Token verwendet werden können.

Die Spalte StartPage gibt an, ob das Token im StartPage-Element eines App-Manifests verwendet werden kann. Die Spalte Benutzerdefinierte Aktion gibt an, ob das Token in der URL einer benutzerdefinierten Aktion in einem Hostweb verwendet werden kann. Die Spalte App-Webpart gibt an, ob das Token in der Src -Eigenschaft des App-Webparts verwendet werden kann.

Token, die am Anfang einer URL verwendet werden können

Token Wird aufgelöst zu StartPage Benutzerdefinierte Aktion App-Webpart Bemerkungen
~controlTemplates
 Die URL des virtuellen Ordners ControlTemplates der aktuellen Website
Nein
 Nein
 Nein
~layouts
 Die URL des virtuellen Ordners Layouts für die aktuelle Website
Nein
 Nein
 Nein
~site
 Die URL der aktuellen Website.
Nein
 Nein
 Ja
~sitecollection
 Die URL der übergeordneten Websitesammlung der aktuellen Website.
Nein
 Nein
 Ja

Sofern nicht anders angegeben, kann keines dieser Token in der nächsten Tabelle im Pfadteil des Src-Eigenschaftswerts des App-Teils verwendet werden. Die Spalte App-Webpart bezieht sich auf deren Verwendung im Abfragezeichenfolge-Teil des Werts.

Token, die innerhalb einer URL verwendet werden können

Token Wird aufgelöst zu StartPage Benutzerdefinierte Aktion App-Webpart Bemerkungen
{ControlTemplates}
 Die URL des virtuellen Ordners ControlTemplates der aktuellen Website
Nein
 Nein
 Nein
{ItemId}
 Die ID eines Elements in einer Liste oder Bibliothek (eine ganze Zahl)
Nein
 Ja
 Nein
{ItemUrl}
 Die URL des Elements, an dem eine Aktion ausgeführt wird.
Nein
 Ja
 Nein
{Layouts}
 Die URL des virtuellen Ordners Layouts für die aktuelle Website
Nein
 Nein
 Nein
{ListId}
 Die ID der aktuellen Liste (eine GUID).
Nein
 Ja
 Nein
{RecurrenceId}
 Der Wiederholungsindex eines sich wiederholenden Ereignisses.
Nein
 Ja
 Nein
 In Kontextmenüs von Listenelementen wird die Verwendung dieses Tokens nicht unterstützt.
{Site}
 Die URL der aktuellen Website.
Nein
 Ja
 Ja
{SiteCollection}
 Die URL der übergeordneten Website der aktuellen Website.
Nein
 Ja
 Ja
{SiteUrl}
 Die URL der aktuellen Website.
Nein
 Ja
 Nein
{Source}
 Die URL der HTTP-Anforderung
Nein
 Ja
 Nein

Siehe auch