Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

MappedName - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Nom de champ de fusion prédéfinis. Lorsque l'objet est sérialisé en XML, son nom complet est w:mappedName.

Espace de noms :  DocumentFormat.OpenXml.Wordprocessing
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

public class MappedName : StringType

[ISO/IEC 29500-1 1st Edition]

mappedName (prédéfinis les nom de champ de fusion)

Cet élément spécifie le nom qui doit être mappé vers le numéro de la colonne spécifié par l'élément de colonne (§17.14.6) au sein de ce mappage de champ du champ le schéma WordprocessingML prédéfini MERGEFIELD . [Conseils: cet élément permet de la colonne en cours à partir de la source de données spécifiée d'être mappé à un nom de champ prédéfini, qui permet aux applications d'avoir un jeu standard de noms de champs à utiliser que les données de noms de colonnes source, par exemple, pour créer des formats d'adresse d'y placer un champ ADDRESSBLOCK . conseils de fin]

Si cet élément est omis, le mappage des colonnes source données actuelle n'auront pas un nom de champ de fusion prédéfinis mis en correspondance avec son contenu et doit uniquement être référencé via le nom de colonne de source de données spécifié par l'élément de nom (§17.14.24) lorsqu'ils sont référencés par un ou plusieurs champs MERGEFIELD . Si l'application n'a pas un champ de fusion prédéfinis dont le nom correspond au nom spécifié à l'aide de l'attribut de val, cet élément peut être ignoré.

[Exemple: considérons le fragment suivant de WordprocessingML, représentant deux colonnes provenant d'une source de données externes qui ont été mappés à des champs intégrés prénom et Nom de famille, respectivement :

<w:fieldMapData>
  <w:column w:val="0" />
  <w:name w:val="Column Name A" />
  <w:mappedName w:val="First Name" />
  …
</w:fieldMapData>
<w:fieldMapData>
  <w:column w:val="1" />
  <w:name w:val="Column Name B" />
  <w:mappedName w:val="Last Name" />
  …
</w:fieldMapData>

Les première et deuxième colonnes, spécifiés par l'élément de la colonne valeurs de 0 et 1 indiquent respectivement que les noms de champs prédéfinis WordprocessingML prénom et Nom sont mappés aux colonnes de la source de données externe et que les données source de noms pour les colonnes se nom de la colonne A et B du nom de colonne, respectivement.

Par conséquent, si les champs MERGEFIELD appelant pour le prénom et le Nom sont insérés dans un document WordprocessingML connecté à la source de données externe avec les mappages de champs spécifiés ci-dessus, lorsque la fusion a lieu, les données de la première et deuxième colonne remplit les champs appelant pour le prénom et le Nom des données dans le document WordprocessingML fusionné. exemple de fin]

Éléments parents

fieldMapData (§17.14.15)

Attributs

Description

Val (chaîne de valeur)

Spécifie que le contenu contient une chaîne.

Le contenu de cette chaîne est interprété en fonction du contexte de l'élément XML parent.

[Exemple: considérons le fragment de WordprocessingML suivant :

<w:pPr>
  <w:pStyle w:val="heading1" /> 
</w:pPr>

La valeur de l'attribut de val est l'ID de du style de paragraphe associés styleId.

Cependant, considérons le fragment suivant :

<w:sdtPr>
  <w:alias w:val="SDT Title Example" />
  …
</w:sdtPr>

Dans ce cas, le nombre décimal dans l'attribut val est la légende de la balise de document parent structuré. Dans chaque cas, la valeur est interprétée dans le contexte de l'élément parent. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_String (§22.9.2.13).

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_String) se trouve dans §A.1. fin de la Remarque]

© ISO/IEC29500: 2008.

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: