Partager via


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 .

Voir aussi

Référence

SummaryLink classe

SummaryLink - Membres

Microsoft.SharePoint.Publishing - Espace de noms

ImageUrlAltText