Свойство PageLayout.ListItem

Получает объект SPListItem , на котором основан этот класс PageLayout .

Пространство имен:  Microsoft.SharePoint.Publishing
Сборка:  Microsoft.SharePoint.Publishing (в Microsoft.SharePoint.Publishing.dll)

Синтаксис

'Декларация
Public ReadOnly Property ListItem As SPListItem
    Get
'Применение
Dim instance As PageLayout
Dim value As SPListItem

value = instance.ListItem

public SPListItem ListItem { get; }

Значение свойства

Тип: Microsoft.SharePoint.SPListItem
Основной объект SPListItem , на котором основан этот класс.

Замечания

Значение ListItem инициализируется при создании экземпляра PageLayout и не может быть изменен.

Примечание

Пользователь должен иметь разрешение на просмотр элементов списка в этом списке изначально получить список и получить значения его свойств.

Это свойство можно использовать для получения дополнительных свойств SPListItem и SPListItem.File и методы, которые не были разбиты с помощью класса PageLayout .

Примеры

До компиляции и запуска этого примера, убедитесь, что объект SPListItem элемент списка для макета страницы, хранится в коллекции главных страниц на сайте верхнего уровня.

В этом примере предполагается, что коллекции главных страниц, содержащий объект SPListItem требуется утверждение контента.

Не используйте это свойство для доступа к произвольным полям SPListItem. ListItem применяется только следующие поля:

• AnonymousCacheProfile()

• AuthenticatedCacheProfile()

• Author()

• ContentTypeId()

• Created()

• FSObjType()

• FileDirRef()

• FileLeafRef()

• FileRef()

• Id()

• MasterPageDescription()

• PublishingAssociatedContentType()

• PublishingAssociatedVariations()

• PublishingPreviewImage()

• ScopeId()

• Title()

Если нет необходимости доступа к другим полям, используйте SPQuery для создания нового экземпляра SPListItem для использования с другими полями.

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

См. также

Справочные материалы

PageLayout класс

Элементы PageLayout

Пространство имен Microsoft.SharePoint.Publishing

PageLayout