Объект SharedWorkspace (Office)

  • Статья

Свойство SharedWorkspace объекта Document в Microsoft Word, объекта Workbook в Microsoft Excel и объекта Presentation в Microsoft PowerPoint возвращает объект SharedWorkspace , который позволяет разработчику добавлять активный документ на сайт SharePoint и управлять другими объектами на сайте общей рабочей области.

Примечание.

Начиная с Microsoft Office 2010 этот объект или элемент не рекомендуется использовать.

Замечания

Используйте объект SharedWorkspace , чтобы добавить активный документ Word, Excel или PowerPoint на сайт рабочей области sharePoint на сервере, чтобы воспользоваться преимуществами функций совместной работы рабочей области, а также отключить или удалить документ с сайта рабочей области. Используйте коллекции объекта SharedWorkspace для управления файлами, папками, ссылками, элементами и задачами, связанными с общим документом.

Объектная модель SharedWorkspace доступна независимо от того, хранится ли документ в рабочей области. Свойство SharedWorkspace объектов Document, Workbook и Presentation не возвращает Значение Nothing , если документ не предоставлен. Используйте свойство Connected объекта SharedWorkspace , чтобы определить, сохранен ли активный документ в общей рабочей области и подключен к нему.

Пользователям требуются соответствующие разрешения для использования объектов, свойств и методов в иерархии объектов SharedWorkspace .

Используйте коллекцию SharedWorkspaceFiles , доступ к которой осуществляется через свойство Files объекта SharedWorkspace , для управления документами и файлами, сохраненными в общей рабочей области.

Используйте коллекцию SharedWorkspaceFolders , доступ к которой осуществляется через свойство Folder объекта SharedWorkspace , чтобы управлять вложенными папками в основной папке библиотеки документов общей рабочей области.

Используйте коллекцию SharedWorkspaceLinks , доступ к которой осуществляется через свойство Links объекта SharedWorkspace , чтобы управлять ссылками на дополнительные документы и сведения, интересующие участников, которые совместно работают над документами в общей рабочей области.

Используйте коллекцию SharedWorkspaceMembers , доступ к которой осуществляется через свойство Members объекта SharedWorkspace , чтобы управлять пользователями, имеющими права на участие в общей рабочей области и совместную работу над общими документами, сохраненными в рабочей области.

Используйте коллекцию SharedWorkspaceTasks , доступ к которой осуществляется через свойство Tasks объекта SharedWorkspace , чтобы управлять задачами, назначенными участникам, которые совместно работают над документами в общей рабочей области.

Используйте метод CreateNew , чтобы создать рабочую область документа и добавить активный документ в рабочую область. Используйте свойства Имя и URL-адрес , чтобы вернуть сведения о рабочей области.

Объект SharedWorkspace использует локальный кэш объектов и свойств с сервера. Разработчику может потребоваться обновить этот кэш перед выполнением определенных операций или сохранить кэшированные изменения свойств обратно на сервер. Используйте метод Refresh объекта SharedWorkspace , чтобы обновить локальный кэш с сервера, и свойство LastRefreshed , чтобы определить, когда операция обновления была выполнена в последний раз. Используйте метод Save объектов SharedWorkspaceLink и SharedWorkspaceTask после изменения их свойств локально, чтобы передать изменения на сервер.

Используйте метод Disconnect , чтобы отключить локальную копию активного документа от общей рабочей области, оставив общую копию нетронутой в рабочей области. Используйте метод RemoveDocument , чтобы полностью удалить общий документ из общей рабочей области.

Пользователям требуются соответствующие разрешения для использования объектов, свойств и методов в иерархии объектов SharedWorkspace . Используйте аргумент Role при добавлении членов в коллекцию SharedWorkspaceMembers , чтобы указать набор разрешений, характерных для каждого члена рабочей области.

При использовании объектной модели SharedWorkspace можно создать условия, в которых кэш объектов SharedWorkspace не синхронизируется с пользовательским интерфейсом, отображаемым в области общей рабочей области активного документа. Например, если метод CreateNew программным способом добавляет активный документ в новую рабочую область, пока открыта область Общая рабочая область , на панели Общая рабочая область по-прежнему отображается кнопка Создать . В таких случаях, если пользователь делает выбор в области общей рабочей области , который больше не действителен, возникает ошибка и выполняется операция обновления для синхронизации отображения с текущим состоянием документа и данными общей рабочей области.

Объекты Document, Workbook и Presentation также имеют свойство Sync , которое возвращает объект Sync . Используйте объект Sync и его свойства и методы для управления синхронизацией локальной и серверной копий общего документа.

Пример

В следующем примере показаны свойства общей рабочей области, к которой подключен активный документ.

    Dim swsWorkspace As Office.SharedWorkspace 
    Dim strSWSInfo As String 
    Set swsWorkspace = ActiveWorkbook.SharedWorkspace 
    strSWSInfo = swsWorkspace.Name & vbCrLf & _ 
        " - URL: " & swsWorkspace.URL & vbCrLf & _ 
        "The shared workspace contains " & vbCrLf & _ 
        " - Files: " & swsWorkspace.Files.Count & vbCrLf & _ 
        " - Folders: " & swsWorkspace.Folders.Count & vbCrLf & _ 
        " - Links: " & swsWorkspace.Links.Count & vbCrLf & _ 
        " - Members: " & swsWorkspace.Members.Count & vbCrLf & _ 
        " - Tasks: " & swsWorkspace.Tasks.Count & vbCrLf 
    MsgBox strSWSInfo, vbInformation + vbOKOnly, _ 
        "Shared Workspace Information" 
    Set swsWorkspace = Nothing

См. также

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.