Partager via


TextProperties Classe

Définition

Définit la classe TextProperties.

Cette classe est disponible dans Office 2007 et versions ultérieures.

Lorsque l’objet est sérialisé au format xml, son nom qualifié est x :textPr.

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.TextFields))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "textPr")]
public class TextProperties : DocumentFormat.OpenXml.OpenXmlCompositeElement
public class TextProperties : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr(22, "textPr")]
public class TextProperties : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr("x:textPr")]
public class TextProperties : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr("x:textPr")]
public class TextProperties : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.TextFields))]
public class TextProperties : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.TextFields))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class TextProperties : DocumentFormat.OpenXml.OpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.TextFields))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "textPr")>]
type TextProperties = class
    inherit OpenXmlCompositeElement
type TextProperties = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr(22, "textPr")>]
type TextProperties = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr("x:textPr")>]
type TextProperties = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr("x:textPr")>]
type TextProperties = class
    inherit TypedOpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.TextFields))>]
type TextProperties = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.TextFields))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type TextProperties = class
    inherit OpenXmlCompositeElement
Public Class TextProperties
Inherits OpenXmlCompositeElement
Public Class TextProperties
Inherits TypedOpenXmlCompositeElement
Héritage
Héritage
Attributs

Remarques

[ISO/IEC 29500-1 1st Edition]

textPr (Paramètres d’importation de texte)

Cet élément contient tous les paramètres d’importation de texte.

[Exemple : Voici un exemple de code XML pour une connexion de texte :

<connection id="1" name="text data" type="6" refreshedVersion="3" background="1"  saveData="1">  
  <textPr prompt="0" characterSet="437" sourceFile="C:\Desktop\text data.txt"     delimiter="|">  
    <textFields count="5">  
      <textField/>  
      <textField type="text" position="7"/>  
      <textField type="text" position="28"/>  
      <textField position="36"/>  
      <textField type="text" position="41"/>  
    </textFields>  
  </textPr>  
</connection>  

exemple]

Éléments parents
connexion (§18.13.1)
Éléments enfants Paragraphe
textFields (Fields) §18.13.11
Attributs Description
characterSet (jeu de caractères) Nom du jeu de caractères associé au fichier texte. Les valeurs de cet attribut sont limitées aux noms et alias répertoriés dans la liste IANA CHARACTER SETS disponible à l’adresse http://www.iana.org/assignments/character-sets.

[Remarque : Lors de la lecture de cette valeur, si un système ne prend pas en charge un jeu de caractères particulier, l’application est autorisée à décider quelle est la meilleure action de secours. Fin de la remarque]

Si cet attribut n’est pas présent, l’attribut codePage est utilisé.

Les valeurs possibles de cet attribut sont définies par le type de données string du schéma W3C XML.
virgule (Virgule est délimiteur) Indicateur indiquant s’il faut traiter les caractères virgules en tant que délimiteurs de champ.

Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
consécutifs (délimiteurs consécutifs) Indicateur indiquant si les délimiteurs consécutifs doivent être traités comme un seul délimiteur. Si cet indicateur a la valeur true , il est possible ou même probable que certaines lignes retournent plus de champs que d’autres, et ces champs remplissent toujours les cellules de la feuille de calcul de gauche à droite.

Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
decimal (séparateur décimal) Caractère séparateur décimal. Cet attribut et les milliers sont utilisés uniquement lorsque les données du fichier texte contiennent des séparateurs décimaux et des milliers qui sont différents de ceux utilisés sur l’ordinateur, en raison d’un paramètre de langue différent utilisé.

Le tableau suivant présente les résultats lorsque vous importez du texte dans une application de feuille de calcul à l’aide de différents séparateurs. Les résultats numériques sont affichés dans la colonne la plus à droite.

Séparateur décimal système

Séparateur des milliers système

Valeur de séparateur décimal du fichier texte

Nombres de milliers de fichiers texte Valeur de séparateur

Texte importé

Valeur de la cellule (type de données)

Point

Virgule

Virgule

Point

123.123,45

123,123.45 (numérique)

Point

Virgule

Virgule

Virgule

123.123,45

123.123,45 (texte)

Virgule

Point

Virgule

Point

123.123,45

123,123.45 (numérique)

Point

Virgule

Point

Virgule

123.123,45

123 123.45 (texte)

Point

Virgule

Point

Espace

123.123,45

123,123.45 (numérique)

Les valeurs de chaîne de cet attribut sont censées être d’une longueur d’un caractère.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).
délimité (fichier délimité) true si le fichier est délimité par tabulation ou par caractères. false si le fichier doit être analysé en fonction des champs de longueur fixe.

Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
délimiteur (délimiteur personnalisé) Caractère spécifié par l’utilisateur à traiter comme un délimiteur de champ. Seuls les caractères uniques sont pris en charge.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).
fileType (type de fichier) Attribut ignoré avec la valeur d’énumération définie par ST_FileType. Détermine le type de jeu de caractères à utiliser lors de l’importation.

Un seul de fileType et characterSet ou codePage doit être spécifié pour un textPr.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_FileType (§18.18.29).
firstRow (Première ligne) Indique à quelle ligne du fichier démarrer l’importation de données. Toutes les valeurs unsignedInt sont autorisées, bien qu’il soit possible que firstRow soit supérieur au nombre de lignes dans le fichier texte, auquel cas aucune donnée n’est importée.

Les valeurs possibles de cet attribut sont définies par le type de données unsignedInt du schéma XML du W3C.
prompt (Invite de nom de fichier) Indicateur indiquant si l’utilisateur souhaite être invité à entrer le nom de fichier lors de l’actualisation. Si la valeur est false, l’utilisateur n’est pas invité. Si la valeur est true ou n’est pas présente, l’utilisateur est invité.

Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
qualificateur (qualificateur) Caractère utilisé comme qualificateur de chaîne de texte.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Qualifier (§18.18.61).
point-virgule (le point-virgule est délimiteur) Indicateur indiquant s’il faut traiter des points-virgules en tant que délimiteurs de champ.

Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
sourceFile (nom de fichier source) Chemin d’accès au fichier texte à utiliser pour importer des données externes. Peut être exprimé en ou notation de chemin de fichier spécifique au système.

[Remarque : les applications peuvent déterminer quelles formes elles prennent en charge et si les notations de chemin d’accès de fichier spécifiques au système sont prises en charge. Fin de la remarque]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).
espace (Espace est délimiteur) Indicateur indiquant s’il faut traiter les caractères d’espace en tant que délimiteurs de champ.

Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
tab (Tab comme délimiteur) Indicateur indiquant s’il faut traiter les caractères de tabulation comme des délimiteurs de champ. Si la valeur est false, les onglets ne seront pas utilisés comme délimiteurs. S’ils sont true ou non présents, ils sont utilisés comme délimiteurs.

Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
milliers (séparateur de milliers) Caractère séparateur de milliers. Cet attribut et l’attribut décimal sont utilisés uniquement lorsque les données du fichier texte contiennent des séparateurs décimaux et des milliers qui sont différents de ceux utilisés sur l’ordinateur, en raison d’un paramètre de langue différent utilisé. Reportez-vous à la description de l’attribut décimal ci-dessus pour obtenir une table décrivant le comportement.

Les valeurs de chaîne de cet attribut sont censées être d’une longueur d’un caractère.

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

[Remarque : La définition de schéma XML W3C du modèle de contenu de cet élément (CT_TextPr) se trouve dans §A.2. Fin de la remarque]

ISO/IEC29500 : 2008.

Constructeurs

TextProperties()

Initialise une nouvelle instance de la classe TextProperties.

TextProperties(IEnumerable<OpenXmlElement>)

Initialise une nouvelle instance de la classe TextProperties avec les éléments enfants spécifiés.

TextProperties(OpenXmlElement[])

Initialise une nouvelle instance de la classe TextProperties avec les éléments enfants spécifiés.

TextProperties(String)

Initialise une nouvelle instance de la classe TextProperties à partir d’un code XML externe.

Propriétés

ChildElements

Obtient tous les nœuds enfants de l’élément actuel.

(Hérité de OpenXmlElement)
CodePage

Codepage

Représente l’attribut suivant dans le schéma : codePage

Comma

virgule

Représente l’attribut suivant dans le schéma : virgule

Consecutive

Consécutifs

Représente l’attribut suivant dans le schéma : consécutif

Decimal

decimal

Représente l’attribut suivant dans le schéma : decimal

Delimited

Délimité

Représente l’attribut suivant dans le schéma : délimité

Delimiter

Délimiteur

Représente l’attribut suivant dans le schéma : délimiteur

ExtendedAttributes

Obtient tous les attributs étendus (attributs non définis dans le schéma) de l’élément actuel.

(Hérité de OpenXmlElement)
Features

Obtient un IFeatureCollection pour l’élément actuel. Cette collection de fonctionnalités sera en lecture seule, mais héritera des fonctionnalités de sa partie parente et de son package, le cas échéant.

(Hérité de OpenXmlElement)
FileType

Filetype

Représente l’attribut suivant dans le schéma : fileType

FirstChild

Obtient le premier enfant de l’élément OpenXmlElement actuel.

(Hérité de OpenXmlCompositeElement)
FirstRow

Firstrow

Représente l’attribut suivant dans le schéma : firstRow

HasAttributes

Obtient une valeur indiquant si l’élément actuel a des attributs.

(Hérité de OpenXmlElement)
HasChildren

Obtient une valeur qui indique si l’élément actuel a des éléments enfants.

(Hérité de OpenXmlCompositeElement)
InnerText

Obtient ou définit les valeurs concaténées du nœud actuel et de tous ses enfants.

(Hérité de OpenXmlCompositeElement)
InnerXml

Obtient ou définit le balisage qui représente uniquement les nœuds enfants du nœud actuel.

(Hérité de OpenXmlCompositeElement)
LastChild

Obtient le dernier enfant de l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type.

(Hérité de OpenXmlCompositeElement)
LocalName

Définit la classe TextProperties.

Cette classe est disponible dans Office 2007 et versions ultérieures.

Lorsque l’objet est sérialisé au format xml, son nom qualifié est x :textPr.

LocalName

Obtient le nom local de l’élément actuel.

(Hérité de OpenXmlElement)
MCAttributes

Obtient ou définit les attributs de compatibilité du balisage. Retourne null si aucun attribut de compatibilité de balisage n’est défini pour l’élément actuel.

(Hérité de OpenXmlElement)
NamespaceDeclarations

Obtient toutes les déclarations d’espace de noms définies dans l’élément actuel. Retourne un énumérateur vide s’il n’y a pas de déclaration d’espace de noms.

(Hérité de OpenXmlElement)
NamespaceUri

Obtient l’URI d’espace de noms de l’élément actuel.

(Hérité de OpenXmlElement)
OpenXmlElementContext

Obtient l’élément OpenXmlElementContext de l’élément actuel.

(Hérité de OpenXmlElement)
OuterXml

Obtient le balisage qui représente l’élément actuel et tous ses éléments enfants.

(Hérité de OpenXmlElement)
Parent

Obtient l’élément parent de l’élément actuel.

(Hérité de OpenXmlElement)
Prefix

Obtient le préfixe d’espace de noms de l’élément actuel.

(Hérité de OpenXmlElement)
Prompt

Invite

Représente l’attribut suivant dans le schéma : prompt

Qualifier

Qualification

Représente l’attribut suivant dans le schéma : qualificateur

Semicolon

point-virgule

Représente l’attribut suivant dans le schéma : point-virgule

SourceFile

sourceFile

Représente l’attribut suivant dans le schéma : sourceFile

Space

espace

Représente l’attribut suivant dans le schéma : espace

TabAsDelimiter

Onglet

Représente l’attribut suivant dans l’onglet schéma :

TextCharacterSet

characterSet

Représente l’attribut suivant dans le schéma : characterSet

TextFields

Textfields.

Représente la balise d’élément suivante dans le schéma : x :textFields.

Thousands

Milliers

Représente l’attribut suivant dans le schéma : milliers

XmlQualifiedName

Obtient le nom qualifié de l’élément actuel.

(Hérité de OpenXmlElement)
XName

Obtient le nom qualifié de l’élément actuel.

(Hérité de OpenXmlElement)

Méthodes

AddAnnotation(Object)

Ajoute un objet à la liste d’annotations de l’élément OpenXmlElement actuel.

(Hérité de OpenXmlElement)
AddChild(OpenXmlElement, Boolean)

Ajoute l’élément spécifié à l’élément s’il s’agit d’un enfant connu. Cela ajoute l’élément à l’emplacement approprié en fonction du schéma.

(Hérité de OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)

Ajoute une déclaration d’espace de noms au nœud actuel.

(Hérité de OpenXmlElement)
Ancestors()

Énumère tous les ancêtres de l’élément actuel.

(Hérité de OpenXmlElement)
Ancestors<T>()

Énumère uniquement les ancêtres de l’élément actuel qui ont le type spécifié.

(Hérité de OpenXmlElement)
Annotation(Type)

Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel.

(Hérité de OpenXmlElement)
Annotation<T>()

Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel.

(Hérité de OpenXmlElement)
Annotations(Type)

Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel.

(Hérité de OpenXmlElement)
Annotations<T>()

Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel.

(Hérité de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)

Ajoute chaque élément d’une liste d’éléments à la fin de la liste des éléments enfants de l’élément actuel.

(Hérité de OpenXmlElement)
Append(OpenXmlElement[])

Ajoute chaque élément d’un tableau d’éléments à la fin de la liste des éléments enfants de l’élément actuel.

(Hérité de OpenXmlElement)
AppendChild<T>(T)

Ajoute l’élément spécifié à la fin de la liste des nœuds enfants de l’élément actuel.

(Hérité de OpenXmlCompositeElement)
ClearAllAttributes()

Efface tous les attributs, y compris les attributs connus et les attributs étendus.

(Hérité de OpenXmlElement)
Clone()

Crée un doublon du nœud actuel.

(Hérité de OpenXmlElement)
CloneNode(Boolean)

Crée un doublon de ce nœud.

Descendants()

Énumère tous les descendants de l’élément actuel.

(Hérité de OpenXmlElement)
Descendants<T>()

Énumérez tous les descendants de l’élément actuel de type T.

(Hérité de OpenXmlElement)
Elements()

Énumère tous les enfants de l’élément actuel.

(Hérité de OpenXmlElement)
Elements<T>()

Énumère uniquement les enfants de l’élément actuel qui ont le type spécifié.

(Hérité de OpenXmlElement)
ElementsAfter()

Énumère tous les éléments frères qui suivent l’élément actuel et ont le même parent que l’élément actuel.

(Hérité de OpenXmlElement)
ElementsBefore()

Énumère tous les éléments frères qui précèdent l’élément actuel et ont le même parent que l’élément actuel.

(Hérité de OpenXmlElement)
GetAttribute(String, String)

Obtient un attribut Open XML avec le nom de balise et l’URI d’espace de noms spécifiés.

(Hérité de OpenXmlElement)
GetAttributes()

Obtient une liste qui contient une copie de tous les attributs.

(Hérité de OpenXmlElement)
GetEnumerator()

Retourne un énumérateur qui itère au sein de la collection enfant.

(Hérité de OpenXmlElement)
GetFirstChild<T>()

Recherche le premier élément enfant de type T.

(Hérité de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)

Insère l’élément spécifié immédiatement après l’élément de référence spécifié.

(Hérité de OpenXmlCompositeElement)
InsertAfterSelf<T>(T)

Insère l’élément spécifié immédiatement après l’élément actuel.

(Hérité de OpenXmlElement)
InsertAt<T>(T, Int32)

Insère l’élément spécifié à l’index spécifié des enfants de l’élément actuel.

(Hérité de OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)

Insère l’élément spécifié juste avant l’élément de référence spécifié.

(Hérité de OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)

Insère l’élément spécifié juste avant l’élément actuel.

(Hérité de OpenXmlElement)
IsAfter(OpenXmlElement)

Détermine si l’élément actuel apparaît après un élément spécifié dans l’ordre du document.

(Hérité de OpenXmlElement)
IsBefore(OpenXmlElement)

Détermine si l’élément actuel apparaît avant un élément spécifié dans l’ordre du document.

(Hérité de OpenXmlElement)
LookupNamespace(String)

Résout le préfixe d’espace de noms dans le contexte du nœud actuel.

(Hérité de OpenXmlElement)
LookupPrefix(String)

Recherche le préfixe correspondant pour un URI d’espace de noms dans l’étendue de l’élément actuel.

(Hérité de OpenXmlElement)
NextSibling()

Obtient l’élément OpenXmlElement qui suit immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement suivant.

(Hérité de OpenXmlElement)
NextSibling<T>()

Obtient l’élément OpenXmlElement avec le type spécifié qui suit l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’y a pas d’élément OpenXmlElement suivant.

(Hérité de OpenXmlElement)
PrependChild<T>(T)

Insère l’élément spécifié au début de la liste des nœuds enfants de l’élément actuel.

(Hérité de OpenXmlCompositeElement)
PreviousSibling()

Obtient l’élément OpenXmlElement qui précède immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic ) s’il n’existe aucun élément OpenXmlElement précédent.

(Hérité de OpenXmlElement)
PreviousSibling<T>()

Obtient l’élément OpenXmlElement avec le type spécifié qui précède l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement précédent.

(Hérité de OpenXmlElement)
Remove()

Supprime l’élément actuel de son parent.

(Hérité de OpenXmlElement)
RemoveAllChildren()

Supprime tous les éléments enfants de l’élément actuel.

(Hérité de OpenXmlCompositeElement)
RemoveAllChildren<T>()

Supprimez tous les éléments enfants de l’élément actuel qui sont de type T.

(Hérité de OpenXmlElement)
RemoveAnnotations(Type)

Supprime les annotations du type spécifié de l’élément OpenXmlElement actuel.

(Hérité de OpenXmlElement)
RemoveAnnotations<T>()

Supprime les annotations avec le type spécifié de l’élément OpenXmlElement actuel.

(Hérité de OpenXmlElement)
RemoveAttribute(String, String)

Supprime l’attribut de l’élément actuel.

(Hérité de OpenXmlElement)
RemoveChild<T>(T)

Supprime l’élément enfant spécifié.

(Hérité de OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)

Supprime la déclaration d’espace de noms pour le préfixe spécifié. Ne supprime rien s’il n’y a pas de préfixe.

(Hérité de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)

Remplace l’un des éléments enfants de l’élément actuel par un autre élément OpenXmlElement.

(Hérité de OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)

Définit un attribut sur l’élément spécifié. Si l’attribut est un attribut connu, la valeur de l’attribut est définie. Si l’attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus.

(Hérité de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)

Définit un certain nombre d’attributs à l’élément . Si un attribut est un attribut connu, la valeur de l’attribut est définie. Si un attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus.

(Hérité de OpenXmlElement)
WriteTo(XmlWriter)

Enregistre le nœud actuel dans le XmlWriter spécifié.

(Hérité de OpenXmlElement)

Implémentations d’interfaces explicites

IEnumerable.GetEnumerator()

Définit la classe TextProperties.

Cette classe est disponible dans Office 2007 et versions ultérieures.

Lorsque l’objet est sérialisé au format xml, son nom qualifié est x :textPr.

(Hérité de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()

Retourne un énumérateur qui itère au sein de la collection enfant.

(Hérité de OpenXmlElement)

S’applique à