LimitedWebPartManager.AddWebPart método

Artigo
05/11/2016

Adiciona uma Web Part a uma Página de Web Parts.

Namespace: Microsoft.SharePoint.Client.WebParts
Assemblies: Microsoft.SharePoint.Client.Silverlight (em Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (em Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (em Microsoft.SharePoint.Client.dll)

Sintaxe

'Declaração
Public Function AddWebPart ( _
    webPart As WebPart, _
    zoneId As String, _
    zoneIndex As Integer _
) As WebPartDefinition
'Uso
Dim instance As LimitedWebPartManager
Dim webPart As WebPart
Dim zoneId As String
Dim zoneIndex As Integer
Dim returnValue As WebPartDefinition

returnValue = instance.AddWebPart(webPart, _
    zoneId, zoneIndex)

public WebPartDefinition AddWebPart(
    WebPart webPart,
    string zoneId,
    int zoneIndex
)

Parâmetros

webPart
Tipo: Microsoft.SharePoint.Client.WebParts.WebPart

A Web Part para adicionar à página de Web Parts.

zoneId
Tipo: System.String

O nome da zona de Web Parts ao qual deseja adicionar a Web Part.

zoneIndex
Tipo: System.Int32

Um índice de zona de Web Part que especifica a posição em que a Web Part será inserida dentro da zona de Web Part.

Valor retornado

Tipo: Microsoft.SharePoint.Client.WebParts.WebPartDefinition
Retorna uma instância de WebPartDefinition que representa a posição em que a Web Part será inserida dentro da zona de Web Part.

Exceções

Exceção	Condição
[System.UnauthorizedAccessException]	O usuário atual tem permissões suficientes. Código de erro: -2147024891

Comentários

Quando o escopo for o usuário, o usuário atual deve ter permissões para adicionar e excluir Web Parts personalizadas. Quando o escopo for compartilhado, o usuário atual deve ter permissões para personalizar páginas. Consulte também: ImportWebPart, na seção a seguir. Use ImportWebPart para importar uma Web Part e, em seguida, use AddWebPart para adicioná-lo à página de Web Parts. Cada zona de Web Part deve ter um nome exclusivo. Ele não deve ser uma referência nula (Nothing no Visual Basic). Ele não deve ser vazio. Seu comprimento deve ser igual ou menor que 64.

A nova Web Part deve ser inserida diretamente antes na Web Part existente com o índice de zona de Web Part mais baixo maior que ou igual a zoneIndex. Se zoneIndex for maior que o índice de todas as Web Parts na zona ou não há nenhuma Web Parts na zona de Web Parts, a nova Web Part deve ser inserida no final da zona de Web Parts. Seu valor deve ser igual ou maior do que 0.

Ver também

Referência

LimitedWebPartManager classe

LimitedWebPartManager membros

Microsoft.SharePoint.Client.WebParts namespace

Partilhar via