При получении клиентского объекта получаются не все свойства

Дата последнего изменения: 9 февраля 2010 г.

Применимо к: SharePoint Foundation 2010

Доступно на сайте SharePoint Online

В серверной объектной модели при возвращении объекта SPWeb все его свойства становятся доступными для использования в коде. Но для улучшения производительности в клиентской объектной модели при возвращении объекта Web (JavaScript: Web) определенные свойства недоступны, их нужно получать явно. Например, класс Web (JavaScript: Web) наследует свойство HasUniqueRoleAssignments (JavaScript: hasUniqueRoleAssignments) от класса SecurableObject (JavaScript: SecurableObject), но при возвращении объекта Web (JavaScript: Web) это свойство по умолчанию не извлекается. Дополнительные сведения о свойствах, которые не возвращаются по умолчанию при извлечении объекта, см. в статье Обзор извлечения данных.

Следующий пример, который предназначен для отображения заголовка веб-сайта, использует уникальные назначения ролей и возвращает исключение PropertyOrFieldNotInitializedException при втором вызове для записи в консоль, так как свойство HasUniqueRoleAssignments (JavaScript: hasUniqueRoleAssignments) не было получено явно.

Недопустимый код

using System;
using Microsoft.SharePoint.Client;

namespace Microsoft.SDK.SharePointServices.Samples
{
    class RetrieveProperties
    {
        static void Main()
        {
            ClientContext clientContext = new ClientContext("http://MyServer/sites/MySiteCollection");
            Web oWebsite = clientContext.Web;

            clientContext.Load(oWebsite);

            clientContext.ExecuteQuery();

            Console.WriteLine(oWebsite.Title);
            Console.WriteLine(oWebsite.HasUniqueRoleAssignments);
        }
    }
}

В следующем варианте предыдущего примера свойство HasUniqueRoleAssignments извлекается явно (JavaScript: hasUniqueRoleAssignments), как и свойство Title (JavaScript: title).

Допустимый код

using System;
using Microsoft.SharePoint.Client;

namespace Microsoft.SDK.SharePointServices.Samples
{
    class RetrieveProperties
    {
        static void Main()
        {
            ClientContext clientContext = new ClientContext("http://MyServer/sites/MySiteCollection");
            Web oWebsite = clientContext.Web;

           clientContext.Load(
               oWebsite,
               website => website.Title,
               website => website.HasUniqueRoleAssignments);

            clientContext.ExecuteQuery();

            Console.WriteLine("Title: " + oWebsite.Title + 
                "Unique role assignments: " + oWebsite.HasUniqueRoleAssignments);
        }
    }
}

Imports System
Imports Microsoft.SharePoint.Client

Namespace Microsoft.SDK.SharePointServices.Samples
    Class RetrieveProperties

        Shared Sub Main()
            Dim clientContext As New ClientContext("http://MyServer/sites/MySiteCollection")
            Dim oWebsite As Web = clientContext.Web

            clientContext.Load(oWebsite, _
                Function(website) website.Title, _
                Function(website) website.HasUniqueRoleAssignments)

            clientContext.ExecuteQuery()

            Console.WriteLine("Title: " & oWebsite.Title & ControlChars.Lf & _
                               "Unique role assignments: " & oWebsite.HasUniqueRoleAssignments)

        End Sub
    End Class
End Namespace

function retrieveProperties () {

    var clientContext = new SP.ClientContext('/sites/TestWebs/TestWeb1');
    this.oWebsite = clientContext.get_web();

    clientContext.load(oWebsite, 'Title', 'HasUniqueRoleAssignments');
        
    clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed));
}

function onQuerySucceeded() {
    alert('Title: ' + oWebsite.get_title() + 
    '\nUnique role assignments: ' + oWebsite.get_hasUniqueRoleAssignments());
}

function onQueryFailed(sender, args) {
    alert('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace());
}

См. также

Концепции

Обзор извлечения данных

Получение элементов списка

Вызов Load и ExecuteQuery перед доступом к свойствам значения

Объекты значения не могут быть использованы в методах запроса

Клиентские объекты можно использовать в методах запроса

Получение групповых данных из одного объекта