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

ColumnIndex - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Index de colonne contenant des valeurs uniques pour l'enregistrement. Lorsque l'objet est sérialisé en XML, son nom complet est w:column.

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

public class ColumnIndex : UnsignedDecimalNumberType

[ISO/IEC 29500-1 1st Edition]

colonne (Index de colonne qui est mappée)

Cet élément spécifie l'index de base zéro de la colonne dans une source de données externe qui doit être mappée sur le nom local d'un champ MERGEFIELD spécifique (§17.16.5.35) spécifié par les données de mappage de champ parent. L'attribut val spécifie cette valeur d'index, qui est utilisée pour rechercher la colonne appropriée dans la source de données.

Si cet élément est omis ou si sa valeur dépasse le nombre de colonnes dans la source de données associée, puis l'index de la colonne référencée doit être par défaut est 0.

[Exemple: pensez à un document source qui est connecté à une source de données externe avec trois colonnes. Au sein de cette source de données externe, il s'agit des trois colonnes sont commandés et intitulées comme suit : en premier, milieuet dernier, respectivement. Le schéma WordprocessingML suivant spécifie que lorsque ce document a été connecté à la source de données, ces colonnes ont été commandés de cette manière :

<w:fieldMapData>
  …  <w:name w:val="first" />
  <w:column w:val="0" />
</w:fieldMapData>
<w:fieldMapData>
  …  <w:name w:val="middle" />
  <w:column w:val="1" />
</w:fieldMapData>
<w:fieldMapData>
  …  <w:name w:val="last" />
  <w:column w:val="2" />
</w:fieldMapData>

Le schéma WordprocessingML ci-dessus montre que la colonne intitulé première doit être associée à la première colonne de la base de données externe en spécifiant un élément colonne avec son attribut val égale à l'addition, la colonne intitulée intermédiaire doit être associée à la deuxième colonne de la base de données externe en spécifiant un élément de la colonne avec son attribut val égal à 1.Enfin, la colonne intitulée dernier doit être associée à la troisième colonne de la base de données externe en spécifiant un élément de la colonne avec son attribut val égal à 2. exemple de fin]

Il est important de savoir que les valeurs de l'élément de nom sont un cache de la dernière fois que le document a été connecté à la base de données et les index spécifiés doivent être utilisés pour connecter les mappages de champs avec les colonnes de la source de données. exemple de fin]

Éléments parents

fieldMapData (§17.14.15)

Attributs

Description

Val (valeur décimale du numéro)

Spécifie que le contenu de cet attribut contient un nombre décimal.

Le contenu de ce nombre décimal est interprété en fonction du contexte de l'élément XML parent.

[Exemple: considérez la propriété WordprocessingML numérique suivante de type simple ST_DecimalNumber:

<… w:val="1512645511" />

La valeur de l'attribut de val est un nombre décimal dont la valeur doit être 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_DecimalNumber (§17.18.10).

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

[ISO/IEC 29500-1 1st Edition]

colonne (Index de colonne contenant des valeurs uniques pour l'enregistrement)

Cet élément spécifie la colonne dans la source de données externe spécifiée qui contient des données uniques pour l'enregistrement en cours dans cette source de données. Cet élément doit être utilisé conjointement avec l'élément uniqueTag (§17.14.35) pour conserver une relation entre un enregistrement spécifique dans une source de données externe et une source de donnée ou un document fusionné. L'attribut val sur cet élément doit être interprété comme un index de base zéro dans les colonnes spécifiées par la source de données que la colonne dans laquelle l'élément uniqueTag doit être recherché en spécifiant la colonne résultante.

Si cet élément spécifie un numéro de colonne qui dépasse le nombre de colonnes dans la source de données externe spécifié, sa valeur doit être ignorée.

[Remarque: cette information est nécessaire dans le cadre d'un publipostage sous forme d'enregistrements peut être ajouté ou supprimé à partir de sources de données externes, et un moyen doit être fourni pour mettre à jour les données d'inclusion ou d'exclusion spécifiques à l'enregistrement à l'aide de l'élément actif (§17.14.1) et l'enregistrement de données externes affectées lorsque le document WordprocessingML est reconnecté à la source de données externe, quel que soit l'ordre des enregistrements dans la source de données externe. fin de la Remarque]

[Exemple: considérons le fragment suivant de WordprocessingML pour obtenir les informations relatives à un enregistrement unique dans un document source pour une fusion et publipostage :

<w:recipientData>
  <w:active w:val="0" />
  <w:column w:val="12" /> 
  <w:uniqueTag>258865469</w:uniqueTag> 
</w:recipientData>

L'enregistrement de données externes associé à ces informations est spécifié via la colonne dans la source de données externe correspondant à l'élément de colonne avec un attribut de val égale à 12, qui contient une ligne dont la valeur de cette colonne a une valeur correspondant à l'élément uniqueTag (§17.14.35) avec un attribut de val égale à 258865469. Cet enregistrement n'est pas importé dans le document fusionné de WordprocessingML comme l'élément actif (§17.14.1) associé à l'enregistrement de données externe a un attribut de val égal à 0.

En d'autres termes, lorsque la source de données externe spécifié est connectée à, l'enregistrement dans la treizième colonne de la source de données externe qui a la valeur 258865469et renseigne pas de champs mappés dans un document fusionné avec les données de cet enregistrement. exemple de fin]

Éléments parents

recipientData (§17.14.27)

Attributs

Description

Val (valeur décimale du numéro)

Spécifie que le contenu de cet attribut contient un nombre décimal.

Le contenu de ce nombre décimal est interprété en fonction du contexte de l'élément XML parent.

[Exemple: considérez la propriété WordprocessingML numérique suivante de type simple ST_DecimalNumber:

<… w:val="1512645511" />

La valeur de l'attribut de val est un nombre décimal dont la valeur doit être 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_DecimalNumber (§17.18.10).

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_DecimalNumber) 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: