PageLayoutCollection.Add - Méthode (String, SPContentTypeId)

Article
03/15/2016

Crée et ajoute un nouvel objet PageLayout .

Espace de noms : Microsoft.SharePoint.Publishing
Assembly : Microsoft.SharePoint.Publishing (dans Microsoft.SharePoint.Publishing.dll)

Syntaxe

'Déclaration
Public Function Add ( _
    pageLayoutName As String, _
    associatedContentTypeId As SPContentTypeId _
) As PageLayout
'Utilisation
Dim instance As PageLayoutCollection
Dim pageLayoutName As String
Dim associatedContentTypeId As SPContentTypeId
Dim returnValue As PageLayout

returnValue = instance.Add(pageLayoutName, _
    associatedContentTypeId)

public PageLayout Add(
    string pageLayoutName,
    SPContentTypeId associatedContentTypeId
)

Paramètres

pageLayoutName
Type : System.String

Nom de PageLayout.

associatedContentTypeId
Type : Microsoft.SharePoint.SPContentTypeId

Identificateur (ID) de l' SPContentType que ce PageLayout sera associé.

Valeur renvoyée

Type : Microsoft.SharePoint.Publishing.PageLayout
Le nouveau PageLayout.

Exceptions

Exception	Condition
SPException	AssociatedContentTypeId doit identifier un valide SPContentType sur le site SPSite.RootWeb .
PathTooLongException	Le nom de fichier ou le dossier spécifié est trop long. Le chemin d'accès de l'URL pour tous les fichiers et dossiers doit contenir 260 caractères au maximum (et pas plus de 128 caractères pour n'importe quel fichier unique ou le nom du dossier dans l'URL). Veuillez taper un nom de fichier ou de dossier plus court.
SPException	Le fichier portant le nom « %1 » existe déjà. Dernière modification par "%2" sur « %3 ».
SPException	Le nom de fichier ou le dossier « %1 » contient des caractères qui ne sont pas autorisés. Veuillez utiliser un nom différent.
ArgumentNullException	Indique que l'un des paramètres d'entrée est une référence Null (Rien dans Visual Basic).
UnauthorizedAccessException	L'utilisateur actuel ne dispose pas des autorisations suffisantes pour effectuer cette action.
FileLoadException	Indique qu'un autre fichier portant le même nom existe déjà.
DirectoryNotFoundException	Indique un problème avec le paramètre pageLayoutName .

Remarques

Le paramètre pageLayoutName peut avoir aucune extension de nom de fichier ou d'une extension .aspx. La valeur de pageLayoutName ne doit pas être vide et ne doit pas dépasser 128 caractères. Le nom doit également être unique au sein de la galerie de pages maîtres du site SPSite.RootWeb . La valeur de pageLayoutName ne peut contenir aucun des caractères suivants non valides :, ", #, %, *, :, <, >, ?, \, /, {, |, } ou un signe ou ASCII caractère 0x7f. La valeur de associatedContentTypeId doit identifier un SPContentType valide sur le site SPSite.RootWeb.