SummaryLink.LinkUrl - Propriété

Article
03/15/2016

Obtient ou définit l'URL de l'élément de lien auquel ce liaisons de l'objet SummaryLink .

Espace de noms : Microsoft.SharePoint.Publishing
Assembly : Microsoft.SharePoint.Publishing (dans Microsoft.SharePoint.Publishing.dll)

Syntaxe

'Déclaration
Public Property LinkUrl As String
    Get
    Set
'Utilisation
Dim instance As SummaryLink
Dim value As String

value = instance.LinkUrl

instance.LinkUrl = value

public string LinkUrl { get; set; }

Valeur de propriété

Type : System.String
URL de l'élément de lien auquel ce liaisons de l'objet SummaryLink .

Exceptions

Exception	Condition
ArgumentException	Valeur de propriété non valide. La valeur ne peut pas excéder 2 047 caractères.
ArgumentException	URL n'est pas valide.

Remarques

La propriété LinkUrl ne peut être vide. Si la propriété LinkUrl contient une chaîne qui n'est pas vide, la chaîne doit être une URL relative de serveur ou complet. URL relatives de serveur commencent par une barre oblique inverse. Un qualifié LinkUrl doit avoir l'un des protocoles autorisés suivants :

http:
https:
file:
ftp:
mailto:
msn:
news:
nntp:
pnm:
mms:
outlook:

Si l'URL commence par "/ /" ou « \\ », il est considéré comme un protocole de file: et les deux barres obliques début sont remplacés par des file://. Lors de la définition de la valeur, l'entrée est tout d'abord retirée des espaces blancs de début et de fin avant d'être appliquées. Si l'URL absolue fait référence à un élément dans la collection de sites actuelle, elle est transformée en une URL relative de serveur avant d'être appliqué. Cette valeur est disponible lors du rendu de XSL via le paramètre @LinkUrl .

Exemples

// Add Groups and links.
            // The link style set here must correspond to one of the template names in the XSL Item style
            // This is not verified by the OM, but an incorrect template name results in the
            // link not rendering.
            
            // GroupA

            summaryLink = summaryLinks.Add("GroupA");
            summaryLink.IsGroupHeader = true;

            summaryLink = summaryLinks.Add("Link1");
            summaryLink.Description = "Description1";
            summaryLink.Style = "Default";
            summaryLink.ImageUrl = "http://www.live.com/live/1.100.7.337/img/wl_jewel.gif";
            summaryLink.LinkUrl = "http://www.example.com/link1";

            summaryLink = summaryLinks.Add("Link2");
            summaryLink.Description = "Description2";
            summaryLink.Style = "Default";
            summaryLink.ImageUrl = "http://www.live.com/live/1.100.7.337/img/wl_jewel.gif";
            summaryLink.LinkUrl = "http://www.example.com/link2";

            // GroupB

            summaryLink = summaryLinks.Add("GroupB");
            summaryLink.IsGroupHeader = true;

            summaryLink = summaryLinks.Add("Link3");
            summaryLink.Description = "Description3";
            summaryLink.Style = "Default";
            summaryLink.ImageUrl = "http://www.live.com/live/1.100.7.337/img/wl_jewel.gif";
            summaryLink.LinkUrl = "http://www.example.com/link3";
            summaryLink.LinkToolTip = "Tooltip for link3";

            return summaryLinkValue;

' Add Groups and links.
' The link style set here must correspond to one of the template names in the XSL Item style
' This is not verified by the OM, but an incorrect template name results in the
' link not rendering.

' GroupA

summaryLink = summaryLinks.Add("GroupA")
summaryLink.IsGroupHeader = True

summaryLink = summaryLinks.Add("Link1")
summaryLink.Description = "Description1"
summaryLink.Style = "Default"
summaryLink.ImageUrl = "http://www.live.com/live/1.100.7.337/img/wl_jewel.gif"
summaryLink.LinkUrl = "http://www.example.com/link1"

summaryLink = summaryLinks.Add("Link2")
summaryLink.Description = "Description2"
summaryLink.Style = "Default"
summaryLink.ImageUrl = "http://www.live.com/live/1.100.7.337/img/wl_jewel.gif"
summaryLink.LinkUrl = "http://www.example.com/link2"

' GroupB

summaryLink = summaryLinks.Add("GroupB")
summaryLink.IsGroupHeader = True

summaryLink = summaryLinks.Add("Link3")
summaryLink.Description = "Description3"
summaryLink.Style = "Default"
summaryLink.ImageUrl = "http://www.live.com/live/1.100.7.337/img/wl_jewel.gif"
summaryLink.LinkUrl = "http://www.example.com/link3"
summaryLink.LinkToolTip = "Tooltip for link3"

Return summaryLinkValue

Notes

Cet exemple de code fait partie d'un exemple plus développé de la rubrique SummaryLink .