Excel.LinkedWorkbookCollection class
Représente une collection d’objets de classeur liés.
- Extends
Propriétés
| context | Contexte de requête associé à l’objet. Cette opération connecte le processus du complément à celui de l’application hôte Office. |
| items | Obtient l’élément enfant chargé dans cette collection de sites. |
| workbook |
Représente le mode de mise à jour des liens du classeur. Le mode est le même pour tous les liens de classeur présents dans le classeur. |
Méthodes
| break |
Rompt tous les liens vers les classeurs liés. Une fois les liens rompus, toutes les formules faisant référence à des liens de classeur sont entièrement supprimées et remplacées par les valeurs les plus récemment récupérées. |
| get |
Obtient des informations sur un classeur lié par son URL. |
| get |
Obtient des informations sur un classeur lié par son URL. Si le classeur n’existe pas, cette méthode renvoie un objet avec sa |
| load(options) | Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter |
| load(property |
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter |
| load(property |
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter |
| refresh |
Effectuer une demande d’actualisation de tous les liens du classeur. |
| toJSON() | Remplace la méthode JavaScript |
Détails de la propriété
context
Contexte de requête associé à l’objet. Cette opération connecte le processus du complément à celui de l’application hôte Office.
context: RequestContext;Valeur de propriété
items
Obtient l’élément enfant chargé dans cette collection de sites.
readonly items: Excel.LinkedWorkbook[];Valeur de propriété
workbookLinksRefreshMode
Représente le mode de mise à jour des liens du classeur. Le mode est le même pour tous les liens de classeur présents dans le classeur.
workbookLinksRefreshMode: Excel.WorkbookLinksRefreshMode | "Manual" | "Automatic";Valeur de propriété
Excel.WorkbookLinksRefreshMode | "Manual" | "Automatic"
Remarques
Détails de la méthode
breakAllLinks()
Rompt tous les liens vers les classeurs liés. Une fois les liens rompus, toutes les formules faisant référence à des liens de classeur sont entièrement supprimées et remplacées par les valeurs les plus récemment récupérées.
breakAllLinks(): void;Retours
void
Remarques
getItem(key)
Obtient des informations sur un classeur lié par son URL.
getItem(key: string): Excel.LinkedWorkbook;Paramètres
- key
-
string
URL du classeur lié.
Retours
Le classeur lié avec l’URL donnée.
Remarques
getItemOrNullObject(key)
Obtient des informations sur un classeur lié par son URL. Si le classeur n’existe pas, cette méthode renvoie un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez * Méthodes et propriétés d’OrNullObject.
getItemOrNullObject(key: string): Excel.LinkedWorkbook;Paramètres
- key
-
string
URL du classeur lié.
Retours
Le classeur lié avec l’URL donnée.
Remarques
load(options)
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.
load(options?: Excel.Interfaces.LinkedWorkbookCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions): Excel.LinkedWorkbookCollection;Paramètres
- options
-
Excel.Interfaces.LinkedWorkbookCollectionLoadOptions & Excel.Interfaces.CollectionLoadOptions
Fournit des options pour les propriétés de l’objet à charger.
Retours
load(propertyNames)
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.
load(propertyNames?: string | string[]): Excel.LinkedWorkbookCollection;Paramètres
- propertyNames
-
string | string[]
Chaîne délimitée par des virgules ou tableau de chaînes spécifiant les propriétés à charger.
Retours
load(propertyNamesAndPaths)
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.
load(propertyNamesAndPaths?: OfficeExtension.LoadOption): Excel.LinkedWorkbookCollection;Paramètres
- propertyNamesAndPaths
- OfficeExtension.LoadOption
propertyNamesAndPaths.select est une chaîne délimitée par des virgules qui spécifie les propriétés à charger, et propertyNamesAndPaths.expand est une chaîne délimitée par des virgules qui spécifie les propriétés de navigation à charger.
Retours
refreshAll()
Effectuer une demande d’actualisation de tous les liens du classeur.
refreshAll(): void;Retours
void
Remarques
toJSON()
Remplace la méthode JavaScript toJSON() afin de fournir une sortie plus utile lorsqu’un objet API est passé à JSON.stringify(). (JSON.stringify, à son tour, appelle la toJSON méthode de l’objet qui lui est passé.) Alors que l’objet d’origine Excel.LinkedWorkbookCollection est un objet API, la toJSON méthode renvoie un objet JavaScript simple (typé ) Excel.Interfaces.LinkedWorkbookCollectionDataqui contient un tableau « items » avec des copies superficielles de toutes les propriétés chargées à partir des éléments de la collection.
toJSON(): Excel.Interfaces.LinkedWorkbookCollectionData;