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

Crée et ajoute un nouvel objet PageLayout .

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

public PageLayout Add(
	string pageLayoutName,
	SPContentTypeId associatedContentTypeId,
	string pageMarkup
)

Paramètres

pageLayoutName
Type : System.String

Nom de PageLayout.

associatedContentTypeId
Type : Microsoft.SharePoint.SPContentTypeId

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

pageMarkup
Type : System.String

Le balisage ASPX pour la mise en page, ou une référence Null (Rien dans Visual Basic) pour indiquer que le marquage de la mise en page de modèle doit être utilisé.

Valeur renvoyée

Type : Microsoft.SharePoint.Publishing.PageLayout
L'objet nouvellement créé PageLayout .

ExceptionCondition
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

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 .

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 . Le 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 valide SPContentType sur le site SPSite.RootWeb .

Afficher: