SummaryLink.ImageUrl - Propriété
Obtient ou définit l'URL de l'image associée à cet objet SummaryLink .
Espace de noms : Microsoft.SharePoint.Publishing
Assembly : Microsoft.SharePoint.Publishing (dans Microsoft.SharePoint.Publishing.dll)
Syntaxe
'Déclaration
Public Property ImageUrl As String
Get
Set
'Utilisation
Dim instance As SummaryLink
Dim value As String
value = instance.ImageUrl
instance.ImageUrl = value
public string ImageUrl { get; set; }
Valeur de propriété
Type : System.String
URL de l'image associée à ce 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é ImageUrl ne peut être vide. Si la propriété ImageUrl 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é ImageUrl 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ées. Cette valeur est disponible lors du rendu de XSL via le paramètre @ImageUrl .
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 .