de la propiedad PageLayout.Title

Obtiene o establece el título de la presentación para este objeto PageLayout .

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

Sintaxis

'Declaración
Public Property Title As String
    Get
    Set
'Uso
Dim instance As PageLayout
Dim value As String

value = instance.Title

instance.Title = value

public string Title { get; set; }

Valor de propiedad

Tipo: System.String
El título que se mostrará para este objeto PageLayout .
Title puede establecerse en una cadena vacía. Un valor de una referencia null (Nothing en Visual Basic) se guarda como una cadena vacía.

Excepciones

Excepción	Condición
ArgumentNullException	.
UnauthorizedAccessException	El usuario actual no tiene permisos suficientes para realizar esta acción.

Comentarios

Title no puede superar los 255 caracteres. Los caracteres excedentes causan un SPException se produce cuando se llama a Update .

Para guardar los cambios, debe llamarse al método PageLayout.Update después de establecer esta propiedad.

El usuario debe tener permisos de edición en el objeto PageLayout para establecer este valor. El usuario debe tener permisos de vista en el objeto PageLayout para recuperar inicialmente y obtener cualquiera de sus valores de propiedad.

Si el valor de esta propiedad se utiliza en el código HTML que se representa en un explorador Web, se debe codificar el valor de la propiedad para evitar la posibilidad de ataques de secuencias de comandos.

Ejemplos

Antes de compilar y ejecutar este ejemplo, compruebe que el objeto SPListItem es un elemento de lista de un diseño de página que se encuentra en la Galería de páginas maestras en el sitio Web de nivel superior.

En este ejemplo se supone que la Galería de páginas maestras que contiene el objeto SPListItem requiere aprobación de contenido.

using PageLayout = Microsoft.SharePoint.Publishing.PageLayout;
using SPListItem = Microsoft.SharePoint.SPListItem;
using SPFile = Microsoft.SharePoint.SPFile;

namespace Microsoft.SDK.SharePointServer.Samples
{
    public static class PageLayoutCodeSamples
    {
        // This method sets some properties on a PageLayout object,
        // saves the new values, and publishes the PageLayout.
        public static void SetPageLayoutPropertiesAndApprove(SPListItem layoutListItem)
        {
            // Replace these variable values and input
            // parameters with your own values.
            // New PageLayout.Title value
            string newTitle = "your Title";
            // New PageLayout.Description value
            string newDescription = "your Description";
            // The comment to set when the layout is checked in,
            // published, and approved.
            string checkInComment = "your comments";
            // Validate the input parameters.
            if (null == layoutListItem)
            {
                throw new System.ArgumentNullException("layoutListItem");
            }

            // Get the PageLayout wrapper for the SPListItem
            // that is passed in.
            PageLayout pageLayout = new PageLayout(layoutListItem);

            // Check out the PageLayout if it is not checked out yet.
            if (pageLayout.ListItem.File.CheckOutStatus == 
              SPFile.SPCheckOutStatus.None)
            {
                pageLayout.ListItem.File.CheckOut();
            }

            // Set and save some properties on the PageLayout.
            pageLayout.Title = newTitle;
            pageLayout.Description = newDescription;
            pageLayout.Update();

            // Publish the PageLayout and Approve it so that the
            // updated values are available on the published Web site.
            pageLayout.ListItem.File.CheckIn(checkInComment);
            SPFile layoutFile = pageLayout.ListItem.File;
            layoutFile.Publish(checkInComment);
            layoutFile.Approve(checkInComment);

        }
    }
}

Imports PageLayout = Microsoft.SharePoint.Publishing.PageLayout
Imports SPListItem = Microsoft.SharePoint.SPListItem
Imports SPFile = Microsoft.SharePoint.SPFile

Namespace Microsoft.SDK.SharePointServer.Samples
    Public NotInheritable Class PageLayoutCodeSamples
        ' This method sets some properties on a PageLayout object,
        ' saves the new values, and publishes the PageLayout.
        Private Sub New()
        End Sub
        Public Shared Sub SetPageLayoutPropertiesAndApprove(ByVal layoutListItem As SPListItem)
            ' Replace these variable values and input
            ' parameters with your own values.
            ' New PageLayout.Title value
            Dim newTitle As String = "your Title"
            ' New PageLayout.Description value
            Dim newDescription As String = "your Description"
            ' The comment to set when the layout is checked in,
            ' published, and approved.
            Dim checkInComment As String = "your comments"
            ' Validate the input parameters.
            If Nothing Is layoutListItem Then
                Throw New System.ArgumentNullException("layoutListItem")
            End If

            ' Get the PageLayout wrapper for the SPListItem
            ' that is passed in.
            Dim pageLayout As New PageLayout(layoutListItem)

            ' Check out the PageLayout if it is not checked out yet.
            If pageLayout.ListItem.File.CheckOutStatus = SPFile.SPCheckOutStatus.None Then
                pageLayout.ListItem.File.CheckOut()
            End If

            ' Set and save some properties on the PageLayout.
            pageLayout.Title = newTitle
            pageLayout.Description = newDescription
            pageLayout.Update()

            ' Publish the PageLayout and Approve it so that the
            ' updated values are available on the published Web site.
            pageLayout.ListItem.File.CheckIn(checkInComment)
            Dim layoutFile As SPFile = pageLayout.ListItem.File
            layoutFile.Publish(checkInComment)
            layoutFile.Approve(checkInComment)

        End Sub
    End Class
End Namespace

Vea también

Referencia

clase PageLayout

Miembros PageLayout

Espacio de nombres Microsoft.SharePoint.Publishing