Simulink.data.Dictionary

Configurer un dictionnaire de données

Description

Un objet Simulink.data.Dictionary représente un dictionnaire de données. L’objet vous permet d’effectuer des opérations sur le dictionnaire de données telles que sauvegarder ou ignorer les modifications, importer des données depuis l’espace de travail de base et ajouter d’autres dictionnaires de données comme références.

Création

Les fonctions Simulink.data.dictionary.create et Simulink.data.dictionary.open créent un objet Simulink.data.Dictionary.

Propriétés

DataSources — Dictionnaires de données référencés

Lecture seule : cell array de vecteurs de caractères

Ce propriété est en lecture seule.

Dictionnaires de données référencés par nom de fichier, retournés en tant que cell array de vecteurs de caractères. Cette propriété ne répertorie que les dictionnaires de données directement référencés dont le parent est l’objet Simulink.data.Dictionary.

EnableAccessToBaseWorkspace — Spécifier si les modèles peuvent utiliser des données de design dans l’espace de travail de base

false (par défaut) | true

La possibilité pour les modèles liés d’utiliser des données de design dans l’espace de travail de base, spécifiés en tant que true ou false.

Pour déterminer si un dictionnaire fournit l’accès à l’espace de travail de base (y compris via des dictionnaires référencés), interrogez la propriété HasAccessToBaseWorkspace.

Pour plus d’informations sur cette propriété, y compris les restrictions qui limitent votre possibilité d’interagir avec les données de l’espace de travail de base via le dictionnaire, consultez Continue to Use Shared Data in the Base Workspace.

Types de données : logical

HasAccessToBaseWorkspace — Demander si les modèles peuvent utiliser des données de design dans l’espace de travail de base

Lecture seule : 0 (par défaut) | 1

Ce propriété est en lecture seule.

Demandez si les modèles peuvent utiliser des données de design dans l’espace de travail de base, retourné en tant que 1 (true) ou 0 (false). Si le dictionnaire ou un dictionnaire référencé possèdent la propriété EnableAccessToBaseWorkspace définie sur true, cette propriété retourne 1.

Utilisez cette propriété pour déterminer si les modèles qui renvoient au dictionnaire peuvent utiliser des données de design dans l’espace de travail de base. Vous n’avez pas besoin d’interroger chaque dictionnaire référencé pour déterminer si sa propriété EnableAccessToBaseWorkspace est définie sur true.

Types de données : logical

HasUnsavedChanges — Indicateur de modifications non sauvegardées

Lecture seule : 0 | 1

Ce propriété est en lecture seule.

Indicateur de modifications non sauvegardées dans le dictionnaire de données, retourné en tant que 0 ou 1. Cette valeur est 1 si les modifications ont été faites depuis la dernière sauvegarde du dictionnaire de données et 0 sinon.

NumberOfEntries — Nombre total d’entrées dans le dictionnaire de données

Lecture seule : entier

Ce propriété est en lecture seule.

Nombre total d’entrées dans le dictionnaire de données, y compris celles dans les dictionnaires référencés, retourné en tant que nombre entier.

Fonctions d'objet

addDataSource	Add reference data dictionary to parent data dictionary
close	Close connection between data dictionary and Simulink.data.Dictionary object
discardChanges	Discard changes to data dictionary
exportToVersion	Export a Simulink.data.Dictionary object to a previous version
filepath	Full path and file name of data dictionary
getSection	Return Simulink.data.dictionary.Section object to represent data dictionary section
hide	Remove data dictionary from Model Explorer
importEnumTypes	Import enumerated type definitions to data dictionary
importFromBaseWorkspace	Import base workspace variables to data dictionary
listEntry	List data dictionary entries
removeDataSource	Remove reference data dictionary from parent data dictionary
saveChanges	Save changes to data dictionary
show	Show data dictionary in Model Explorer

Exemples

Créer un nouveau dictionnaire de données et un objet de dictionnaire de données

Créez un fichier de dictionnaire de données myNewDictionary.sldd et un objet Simulink.data.Dictionary représentant le nouveau dictionnaire de données. Assignez l’objet à la variable dd1.

dd1 = Simulink.data.dictionary.create('myNewDictionary.sldd')

dd1 = 

  data dictionary with properties:

          DataSources: {0x1 cell}
    HasUnsavedChanges: 0
           NumberOfEntries: 0

Ouvrir un dictionnaire de données existant

Créez un objet Simulink.data.Dictionary représentant le dictionnaire de données existant myDictionary_ex_API.sldd. Assignez l’objet à la variable dd2.

dd2 = Simulink.data.dictionary.open('myDictionary_ex_API.sldd')

dd2 = 

  Dictionary with properties:

          DataSources: {'myRefDictionary_ex_API.sldd'}
    HasUnsavedChanges: 0
           NumberOfEntries: 4

Historique des versions

Introduit dans R2015a

Voir aussi

Simulink.data.dictionary.open | Simulink.data.dictionary.create | Simulink.data.dictionary.Section | Simulink.data.dictionary.Entry

Rubriques

• Store Data in Dictionary Programmatically
• What Is a Data Dictionary?