Compartilhar via


Objeto SharedWorkspace (Office)

A propriedade SharedWorkspace de um objeto Document no Microsoft Word, um objeto Workbook no Microsoft Excel e um objeto Presentation no Microsoft PowerPoint retorna um objeto SharedWorkspace que permite que o desenvolvedor adicione o documento ativo a um site do SharePoint e gerencie outros objetos no site de workspace compartilhado.

Observação

A partir do Microsoft Office 2010, este objeto ou membro foi preterido e não deve ser usado.

Comentários

Use o objeto SharedWorkspace para adicionar o documento ativo Word, Excel ou PowerPoint a um site de workspace de documentos do SharePoint no servidor para aproveitar os recursos de colaboração do workspace ou desconectar ou remover o documento do site do workspace. Use as coleções do objeto SharedWorkspace para gerenciar arquivos, pastas, links, membros e tarefas associadas ao documento compartilhado.

O modelo de objeto SharedWorkspace está disponível ou não um documento é armazenado em um espaço de trabalho. A propriedade SharedWorkspace dos objetos de documento, pasta de trabalho e a apresentação não retorna nada quando o documento não é compartilhado. Use a propriedade Connected do objeto SharedWorkspace para determinar se o documento ativo na verdade é salvo no e conectado a um espaço de trabalho compartilhado.

Os usuários precisam de permissões adequadas para usar os objetos, propriedades e métodos na hierarquia do objeto SharedWorkspace.

Use a coleção SharedWorkspaceFiles, acessada por meio da propriedade Files do objeto SharedWorkspace, para gerenciar documentos e arquivos salvos em um espaço de trabalho compartilhado.

Use a coleção SharedWorkspaceFolders, acessada por meio da propriedade Folders do objeto SharedWorkspace, para gerenciar subpastas dentro da pasta da biblioteca de documento principal de um espaço de trabalho compartilhado.

Use a coleção SharedWorkspaceLinks, acessada por meio da propriedade Links do objeto SharedWorkspace, para gerenciar links para documentos adicionais e informações de interesse para os membros que estão colaborando em documentos no espaço de trabalho compartilhado.

Use a coleção SharedWorkspaceMembers, acessada por meio da propriedade membros do objeto SharedWorkspace, para gerenciar usuários que têm direitos para participar de um espaço de trabalho compartilhado e colaborar em documentos compartilhados salvos no espaço de trabalho.

Use a coleção SharedWorkspaceTasks, acessada por meio da propriedadetasks do objeto SharedWorkspace, para gerenciar tarefas atribuídas aos membros que estão colaborando em documentos no espaço de trabalho compartilhado.

Use o método CreateNew para criar um novo espaço de trabalho de documento e adicionar o documento ativo ao espaço de trabalho. Use as propriedades Name e URL para retornar informações sobre o espaço de trabalho.

Objeto SharedWorkspace usa um cache local de objetos e propriedades do servidor. O desenvolvedor pode precisar atualizar este cache antes de executar determinadas operações ou para salvar alterações na propriedade armazenado em cache no servidor. Use o método Refresh do objeto SharedWorkspace para atualizar o cache local do servidor e a propriedade LastRefreshed para determinar quando a operação de atualização última foi realizada. Use o método Save dos objetos SharedWorkspaceLink e SharedWorkspaceTask depois de modificar suas propriedades localmente, para carregar as alterações no servidor.

Use o método Disconnect para desconectar a cópia local do documento ativo do espaço de trabalho compartilhado, deixando a cópia compartilhada intacta no espaço de trabalho. Use o método RemoveDocument para remover o documento compartilhado do espaço de trabalho compartilhado inteiramente.

Os usuários precisam de permissões adequadas para usar os objetos, propriedades e métodos na hierarquia do objeto SharedWorkspace. Use o argumento da função ao adicionar membros à coleção SharedWorkspaceMembers para especificar o conjunto de permissões específicas para cada membro do espaço de trabalho.

Ao usar o modelo de objeto SharedWorkspace, é possível criar condições em que o cache do objeto SharedWorkspace não está sincronizado com a interface do usuário exibida no painel de Espaço de trabalho compartilhado do documento ativo. Por exemplo, se o método CreateNew programaticamente adiciona o documento ativo para um novo objeto workspace enquanto o painel de Espaço de trabalho compartilhado é aberto, o painel de Espaço de trabalho compartilhado continuarão exibir o botão criar. Em circunstâncias como essas, se o usuário fizer uma seleção no painel de Espaço de trabalho compartilhado que não é mais válido, será gerado um erro e uma operação de atualização é realizada para sincronizar a exibição com o estado do documento atual e os dados de espaço de trabalho compartilhado.

Os objetos Documento, Pasta de Trabalho e Apresentação também têm uma propriedade Sync que retorna um objeto Sync . Use o objeto Sync e suas propriedades e métodos para gerenciar a sincronização de local e as cópias do servidor do documento compartilhado.

Exemplo

O exemplo a seguir exibe as propriedades do espaço de trabalho compartilhado ao qual o documento ativo está conectado.

    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

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.