SharedWorkspace Interface

Définition

Espace de noms:

Microsoft.Office.Core

Assembly:

office.dll

Cet objet, membre ou énumération est déconseillé et n’est pas destiné à être utilisé dans votre code. Un objet SharedWorkspace permet au développeur d’ajouter le document actif à un espace de travail de document Microsoft Windows SharePoint Services sur le serveur et de gérer d’autres objets dans l’espace de travail partagé.

public interface class SharedWorkspace : Microsoft::Office::Core::_IMsoDispObj

[System.Runtime.InteropServices.Guid("000C0385-0000-0000-C000-000000000046")]
public interface SharedWorkspace : Microsoft.Office.Core._IMsoDispObj

[<System.Runtime.InteropServices.Guid("000C0385-0000-0000-C000-000000000046")>]
type SharedWorkspace = interface
    interface _IMsoDispObj

Public Interface SharedWorkspace
Implements _IMsoDispObj

Attributs

GuidAttribute

Implémente

_IMsoDispObj

Remarques

La propriété SharedWorkspace d’un objet Document Microsoft Office Word 2003, d’un objet Workbook Microsoft Office Excel 2003 et d’un objet Presentation Microsoft Office PowerPoint 2003 renvoie un objet SharedWorkspace .

Utilisez l’objet SharedWorkspace pour ajouter le document Word, Excel ou PowerPoint actif à un espace de travail de document Windows SharePoint Services sur le serveur afin de tirer parti des fonctionnalités de collaboration de l’espace de travail, ou de déconnecter ou de supprimer le document de l’espace de travail. Utilisez les collections de l’objet SharedWorkspace pour gérer les fichiers, les dossiers, les liens, les membres et les tâches associées au document partagé.

Le modèle objet SharedWorkspace est toujours disponible, même si aucun document n’est stocké dans un espace de travail. La propriété SharedWorkspace des objets Document, Workbook et Presentation ne retourne pas Nothing lorsque le document n’est pas partagé. Utilisez la Connected propriété de l’objet SharedWorkspace pour déterminer si le document actif est effectivement enregistré et connecté à un espace de travail partagé.

Les utilisateurs doivent disposer des autorisations appropriées pour utiliser les objets, les propriétés et les méthodes présents dans la hiérarchie de l’objet SharedWorkspace.

Utilisez la SharedWorkspaceFiles collection, accessible via la Files propriété de l’objet SharedWorkspace , pour gérer les documents et les fichiers enregistrés dans un espace de travail partagé.

Utilisez la SharedWorkspaceFolders collection, accessible via la Folders propriété de l’objet SharedWorkspace , pour gérer les sous-dossiers dans le dossier principal de la bibliothèque de documents d’un espace de travail partagé.

Utilisez la SharedWorkspaceLinks collection, accessible via la Links propriété de l’objet SharedWorkspace , pour gérer les liens vers des documents supplémentaires et des informations d’intérêt pour les membres qui collaborent sur le ou les documents dans l’espace de travail partagé.

Utilisez la SharedWorkspaceMembers collection, accessible via la Members propriété de l’objet SharedWorkspace , pour gérer les utilisateurs qui disposent des droits de participer à un espace de travail partagé et de collaborer sur le ou les documents partagés enregistrés dans l’espace de travail.

Utilisez la SharedWorkspaceTasks collection, accessible via la Tasks propriété de l’objet SharedWorkspace , pour gérer les tâches attribuées aux membres qui collaborent sur le ou les documents dans l’espace de travail partagé.

Utilisez la CreateNew(Object, Object) méthode pour créer un espace de travail de document et ajouter le document actif à l’espace de travail. Utilisez les Name propriétés et URL pour retourner des informations sur l’espace de travail.

L'objet SharedWorkspace utilise un cache local d'objets et de propriétés à partir du serveur. Le développeur peut être amené à mettre à jour ce cache avant d'effectuer certaines opérations ou à enregistrer sur le serveur les modifications de propriétés figurant dans le cache. Utilisez la Refresh() méthode de l’objet SharedWorkspace pour actualiser le cache local à partir du serveur et utilisez la LastRefreshed propriété pour déterminer quand l’opération d’actualisation a eu lieu pour la dernière fois. Utilisez la méthode Save des SharedWorkspaceLink objets et SharedWorkspaceTask après avoir modifié leurs propriétés localement afin de charger les modifications sur le serveur.

Utilisez la Disconnect() méthode pour déconnecter la copie locale du document actif de l’espace de travail partagé, tout en laissant intacte la copie partagée dans l’espace de travail. Utilisez la RemoveDocument() méthode pour supprimer entièrement le document partagé de l’espace de travail partagé.

Les utilisateurs ont besoin des autorisations appropriées pour utiliser les objets, les propriétés et les méthodes dans la hiérarchie d’objets SharedWorkspace . Utilisez l’argument Role lors de l’ajout de membres à la SharedWorkspaceMembers collection pour spécifier le jeu d’autorisations propre à chaque membre de l’espace de travail.

Lorsque vous utilisez le modèle objet SharedWorkspace , il est possible de créer des conditions où le cache d’objets SharedWorkspace n’est pas synchronisé avec l’interface utilisateur affichée dans le volet Espace de travail partagé du document actif. Par exemple, si la méthode CreateNew ajoute par programmation le document actif à un nouvel espace de travail alors que le volet Espace de travail partagé est ouvert, le volet Espace de travail partagé continue d’afficher le bouton Créer. Dans de tels cas, si l’utilisateur sélectionne un élément dans le volet Espace de travail partagé qui n’est plus valide, une erreur se produit et une opération d’actualisation est exécutée afin de synchroniser l’affichage avec l’état actuel du document et les données de l’espace de travail partagé.

Les Documentobjets , Workbooket Presentation ont également une propriété Sync qui retourne un Sync objet . Utilisez l’objet Sync ainsi que ses propriétés et méthodes pour gérer la synchronisation des copies locale et hébergée sur le serveur du document partagé.

Propriétés

Application	Renvoie un objet Application qui représente l’application conteneur de l’objet .
Connected	Retourne une valeur booléenne qui indique si le document actif est actuellement enregistré et connecté à un espace de travail partagé.
Creator	Renvoie un entier 32 bits qui indique l'application dans laquelle l'objet spécifié a été créé.
Files	Renvoie une SharedWorkspaceFiles collection qui représente la liste des fichiers stockés dans la bibliothèque de documents associée à l’espace de travail partagé actuel.
Folders	Renvoie une SharedWorkspaceFolders collection qui représente la liste des sous-dossiers de la bibliothèque de documents associée à l’espace de travail partagé actuel.
LastRefreshed	Retourne la date et l’heure auxquelles la Refresh() méthode a été appelée récemment.
Links	Renvoie une SharedWorkspaceLinks collection qui représente la liste des liens enregistrés dans l’espace de travail partagé actuel.
Members	Renvoie une SharedWorkspaceMembers collection qui représente la liste des membres de l’espace de travail partagé actuel.
Name	Cette propriété renvoie ou définit le nom de l'objet spécifié.
Parent	Renvoie l’objet Parent de l’objet spécifié.
SourceURL	Désigne l’emplacement de la copie publique d’un document partagé vers lequel les modifications doivent être publiées une fois que le document a été révisé dans un espace de travail de document distinct.
Tasks	Retourne une SharedWorkspaceTaskscollection qui représente la liste des tâches dans l’espace de travail partagé actuel.
URL	Retourne l’URL (Uniform Resource Locator) de niveau supérieur de l’espace de travail partagé.

Méthodes

CreateNew(Object, Object)	Crée un espace de travail de document sur le serveur et ajoute le document actif au nouvel espace de travail partagé.
Delete()	Supprime l’espace de travail partagé actif et toutes les données qu’il contient.
Disconnect()	Déconnecte la copie locale du document actif de l’espace de travail partagé.
Refresh()	Actualise le cache local des SharedWorkspace fichiers, dossiers, liens, membres et tâches de l’objet à partir du serveur.
RemoveDocument()	Supprime le document actif de l’espace de travail partagé.