LimitedWebPartManager.AddWebPart - Méthode

Article
05/05/2016

Obtient une valeur qui spécifie l’identificateur du composant WebPart.

Espace de noms : Microsoft.SharePoint.Client.WebParts
Assemblys : Microsoft.SharePoint.Client.Silverlight (dans Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (dans Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (dans Microsoft.SharePoint.Client.dll)

Syntaxe

'Déclaration
Public Function AddWebPart ( _
    webPart As WebPart, _
    zoneId As String, _
    zoneIndex As Integer _
) As WebPartDefinition
'Utilisation
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
)

Paramètres

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

Le composant WebPart à ajouter à la Page de composants WebPart.

zoneId
Type : System.String

Le nom de la zone de composants WebPart auquel vous voulez ajouter le composant WebPart.

zoneIndex
Type : System.Int32

Un index de zone de composant WebPart qui spécifie la position à laquelle le composant WebPart est inséré dans la zone de composants WebPart.

Valeur renvoyée

Type : Microsoft.SharePoint.Client.WebParts.WebPartDefinition
Retourne une instance de WebPartDefinition qui représente la position à laquelle le composant WebPart est inséré dans la zone de composants WebPart.

Exceptions

Exception	Condition
[System.UnauthorizedAccessException]	L'utilisateur actuel dispose des autorisations suffisantes. Code d'erreur : -2147024891

Remarques

Lorsque l'étendue est utilisateur, l'utilisateur actuel doit disposer des autorisations à ajouter et supprimer des composants WebPart personnalisés. Quand l'étendue est partagé, l'utilisateur actuel doit disposer des autorisations pour personnaliser des pages. Voir aussi : ImportWebPart, dans la section suivante. ImportWebPart permet d'importer un composant WebPart, puis utilisez AddWebPart pour l'ajouter à la Page de composants WebPart. Chaque zone de composants WebPart doit avoir un nom unique. une référence Null (Rien dans Visual Basic)ne doit pas être. Il ne doit pas être vide. Sa longueur doit être égale ou inférieure à 64.

Le composant WebPart doit être inséré directement avant le composant WebPart existant avec l'index de zone de composant WebPart les plus faibles supérieur ou égal à zoneIndex. Si zoneIndex est supérieur à l'index de tous les composants WebPart dans la zone ou il n'y a aucun composant WebPart dans la zone de composants WebPart, le composant WebPart doit être inséré à la fin de la zone de composants WebPart. Sa valeur doit être égale ou supérieure à 0.

Voir aussi

Référence

LimitedWebPartManager classe

LimitedWebPartManager - Membres

Microsoft.SharePoint.Client.WebParts - Espace de noms

Partager via