Метод LimitedWebPartManager.AddWebPart

Статья
05/11/2016

Получает значение, задающее идентификатор веб-части.

Пространство имен: Microsoft.SharePoint.Client.WebParts
Сборки: Microsoft.SharePoint.Client.Silverlight (в Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (в Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (в Microsoft.SharePoint.Client.dll)

Синтаксис

'Декларация
Public Function AddWebPart ( _
    webPart As WebPart, _
    zoneId As String, _
    zoneIndex As Integer _
) As WebPartDefinition
'Применение
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
)

Параметры

webPart
Тип: Microsoft.SharePoint.Client.WebParts.WebPart

Веб-часть для добавления на страницу веб-частей.

zoneId
Тип: System.String

Имя зоны веб-частей, в которое нужно добавить веб-части.

zoneIndex
Тип: System.Int32

Указатель зон веб-часть, которая определяет положение которого будет вставлен в веб-части в зоне веб-частей.

Возвращаемое значение

Тип: Microsoft.SharePoint.Client.WebParts.WebPartDefinition
Возвращает экземпляр WebPartDefinition , представляющее положение которого будет вставлен в веб-части в зоне веб-частей.

Исключения

Исключение	Условие
[System.UnauthorizedAccessException]	Текущий пользователь имеет недостаточных прав. Код ошибки: -2147024891

Замечания

Если область действия — пользователя, текущий пользователь должен иметь разрешения на добавление и удаление личных веб-частей. Если область действия общий доступ, текущий пользователь должен иметь разрешения на настройку страниц. Смотрите также: ImportWebPart в следующем разделе. Импорт веб-части с помощью ImportWebPart и затем с помощью AddWebPart добавить страницу веб-частей. Каждой зоны веб-части должны иметь уникальные имена. Не должно быть пустая ссылка (Nothing в Visual Basic). Не должно быть пустым. Его длина должна быть меньше 64 или.

Новые веб-части должен быть вставлен непосредственно перед существующего веб-части с наименьшим индексом зоны веб-части больше или равно zoneIndex. Если zoneIndex больше, чем индекс все веб-части в зоне или нет нет веб-частей в зоне веб-частей, в новый веб-часть должен быть вставлен в конце зоне веб-частей. Его значение должно быть больше нуля или равно.

См. также

Справочные материалы

LimitedWebPartManager класс

Элементы LimitedWebPartManager

Пространство имен Microsoft.SharePoint.Client.WebParts

Поделиться через