SummaryLink.ImageUrl propriedade

Artigo
03/15/2016

Obtém ou define o URL para a imagem associada a este objeto de SummaryLink .

Namespace: Microsoft.SharePoint.Publishing
Assembly: Microsoft.SharePoint.Publishing (em Microsoft.SharePoint.Publishing.dll)

Sintaxe

'Declaração
Public Property ImageUrl As String
    Get
    Set
'Uso
Dim instance As SummaryLink
Dim value As String

value = instance.ImageUrl

instance.ImageUrl = value

public string ImageUrl { get; set; }

Valor de propriedade

Tipo: System.String
A URL para a imagem associada a esta SummaryLink.

Exceções

Exceção	Condição
ArgumentException	Valor de propriedade inválido. O valor não pode exceder 2047 caracteres.
ArgumentException	URL não é válido.

Comentários

A propriedade ImageUrl pode estar vazia. Se a propriedade ImageUrl contém uma seqüência de caracteres que não esteja vazia, a seqüência deve ser uma URL relativa ao servidor ou totalmente qualificadas. URLs relativas do servidor começam com um caractere de barra invertida. Um ImageUrl de totalmente qualificado deve ter um dos seguintes protocolos de permissão:

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

Se a URL começa com "/ /" ou "\ \" é considerado como um protocolo de file: e as duas barras de início são substituídos por file://. Ao definir o valor, a entrada será removida primeiro de espaço em branco à direita e à esquerda antes de serem aplicadas. Se o URL absoluto refere-se a um item no conjunto de sites atual, ela é transformada em uma URL relativa do servidor antes de serem aplicadas. Esse valor está disponível no processamento XSL através do parâmetro @ImageUrl .

Exemplos

// 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

Dica

Este exemplo de código é parte de um exemplo maior de código no tópico SummaryLink .