SummaryLink.LinkUrl propriedade

Artigo
03/15/2016

Obtém ou define a URL do item de link ao qual este vínculos de objeto de SummaryLink .

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

Sintaxe

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

value = instance.LinkUrl

instance.LinkUrl = value

public string LinkUrl { get; set; }

Valor de propriedade

Tipo: System.String
URL do item ao qual o link vínculos de objeto de 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 LinkUrl pode estar vazia. Se a propriedade LinkUrl 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 LinkUrl 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 ao servidor antes de serem aplicadas. Esse valor está disponível no processamento XSL através do parâmetro @LinkUrl .

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 .