(String, SPContentTypeId, String) del método PageLayoutCollection.Add

Artículo
03/15/2016

Crea y agrega un nuevo objeto PageLayout .

Espacio de nombres: Microsoft.SharePoint.Publishing
Ensamblado: Microsoft.SharePoint.Publishing (en Microsoft.SharePoint.Publishing.dll)

Sintaxis

'Declaración
Public Function Add ( _
    pageLayoutName As String, _
    associatedContentTypeId As SPContentTypeId, _
    pageMarkup As String _
) As PageLayout
'Uso
Dim instance As PageLayoutCollection
Dim pageLayoutName As String
Dim associatedContentTypeId As SPContentTypeId
Dim pageMarkup As String
Dim returnValue As PageLayout

returnValue = instance.Add(pageLayoutName, _
    associatedContentTypeId, pageMarkup)

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

Parámetros

pageLayoutName
Tipo: System.String

Nombre de PageLayout.

associatedContentTypeId
Tipo: Microsoft.SharePoint.SPContentTypeId

El identificador (ID) de la SPContentType que se asociará este PageLayout .

pageMarkup
Tipo: System.String

Debe utilizarse el marcado ASPX para el diseño de página, o una referencia null (Nothing en Visual Basic) para indicar que el formato del diseño de página de plantilla.

Valor devuelto

Tipo: Microsoft.SharePoint.Publishing.PageLayout
El objeto recién creado PageLayout .

Excepciones

Excepción	Condición
SPException	AssociatedContentTypeId debe identificar un válido SPContentType en el sitio SPSite.RootWeb .
PathTooLongException	El nombre de archivo o carpeta especificado es demasiado largo. La dirección URL de todos los archivos y carpetas debe tener 260 caracteres como máximo (y nunca más de 128 caracteres para el nombre de la carpeta en la dirección URL o archivo). Escriba un nombre de archivo o carpeta más corto.
SPException	Ya existe el archivo con el nombre "%1". Se modificó por última "%2" en "%3".
SPException	El nombre de archivo o la carpeta "%1" contiene caracteres que no están permitidos. Utilice un nombre diferente.
ArgumentNullException	Indica que uno de los parámetros de entrada es una referencia null (Nothing en Visual Basic).
UnauthorizedAccessException	El usuario actual no tiene permisos suficientes para realizar esta acción.
FileLoadException	Indica que ya existe otro archivo con el mismo nombre.
DirectoryNotFoundException	Indica un problema con el parámetro pageLayoutName .

Comentarios

El parámetro pageLayoutName puede tener ninguna extensión de nombre de archivo o la extensión .aspx. El valor de pageLayoutName no debe estar vacío y no puede exceder de 128 caracteres. Además, el nombre debe ser único dentro de la Galería de páginas maestras del sitio SPSite.RootWeb . El pageLayoutName no puede contener ninguno de los siguientes caracteres no válidos: ", #, %, *, :, <, >, ?, \, /, {, |, } o un símbolo de unión o ASCII de carácter 0x7f. El valor de associatedContentTypeId debe identificar un válido SPContentType en el sitio SPSite.RootWeb .