TextProperties 类

定义

命名空间:

DocumentFormat.OpenXml.Spreadsheet

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

定义 TextProperties 类。

此类在 Office 2007 及更高版本中可用。

当对象序列化为 xml 时，其限定名称为 x：textPr。

public class TextProperties : DocumentFormat.OpenXml.OpenXmlCompositeElement

type TextProperties = class
    inherit OpenXmlCompositeElement

Public Class TextProperties
Inherits OpenXmlCompositeElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

TextProperties

注解

[ISO/IEC 29500-1 第 1 版]

textPr (文本导入设置)

此元素包含所有文本导入设置。

[示例：下面是文本连接的 XML 示例：

<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>  

示例]

父元素
connection (§18.13.1)

子元素	第
textFields (Fields)	§18.13.11

属性	说明
characterSet (字符集)	与文本文件关联的字符集的名称。 此属性的值限制为 IANA 字符集列表中列出的名称和别名，位于 http://www.iana.org/assignments/character-sets。 [注意：读取此值时，如果系统不支持特定字符集，则允许应用程序决定回退操作的最佳方案。 注释结束] 如果此属性不存在，则使用 codePage 属性。 此属性可能的值由 W3C XML 架构 string 数据类型定义。
逗号 (逗号是分隔符)	指示是否将逗号字符视为字段分隔符的标志。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
连续 (连续分隔符)	指示是否应仅将连续分隔符视为一个分隔符的标志。 如果此标志 为 true ，则某些行返回的字段数比其他行多，并且这些字段将始终从左到右填充工作表中的单元格。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
十进制 (小数分隔符)	小数分隔符。 仅当文本文件中的数据包含与计算机上使用的分隔符不同的小数分隔符和千位分隔符时，才使用此属性和 thousands 属性，因为使用了不同的语言设置。 下表显示了使用各种分隔符将文本导入电子表格应用程序时的结果。 数字结果显示在最右边的列中。 系统小数分隔符 系统千位分隔符 文本文件十进制分隔符值 文本文件千位分隔符值 导入的文本 单元格的值（数据类型） Period 逗号 逗号 句号 123.123,45 123,123.45（数字） 句号 逗号 逗号 逗号 123.123,45 123.123,45（文本） 逗号 句号 逗号 句号 123,123.45 123,123.45（数字） 句号 逗号 句号 逗号 123 123.45 123 123.45（文本） 句号 逗号 句号 空格 123 123.45 123,123.45（数字） 此属性的字符串值应为一个字符的长度。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
分隔 (分隔文件)	如果文件是制表符或字符分隔，则为 true。 如果应根据固定长度字段分析文件，则为 false。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
分隔符 (自定义分隔符)	要被视为字段分隔符的用户指定字符。 仅支持单个字符。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
fileType (文件类型)	具有 由 ST_FileType 定义的枚举值的可忽略属性。 确定导入期间要使用的字符集类型。 只能为 textPr 指定 fileType 和 characterSet 或 codePage 中的一个。 此属性的可能值由 ST_FileType 简单类型 (§18.18.29) 定义。
firstRow (First Row)	指示在文件的哪个行处开始数据导入。 允许所有 unsignedInt 值，但 firstRow 可能高于文本文件中的行数，在这种情况下，不会导入任何数据。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
提示 (提示文件名)	指示刷新时是否提示用户输入文件名的标志。 如果 为 false，则不会提示用户。 如果 为 true 或不存在，则会提示用户。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
限定符 (限定符)	用作文本字符串限定符的字符。 此属性的可能值由 ST_Qualifier 简单类型 (§18.18.61) 定义。
分号 (分号是分隔符)	指示是否将分号字符视为字段分隔符的标志。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
sourceFile (源文件名称)	用于导入外部数据的文本文件的路径。 可以用 或特定于系统的文件路径表示法表示。 [注意：应用程序可以决定它们支持哪些形式，以及是否支持特定于系统的文件路径表示法。 注释结束] 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
空格 (空格是分隔符)	指示是否将空格字符视为字段分隔符的标志。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
tab (Tab 作为分隔符)	指示是否将制表符视为字段分隔符的标志。 如果 为 false，则选项卡将不用作分隔符。 如果 为 true 或不存在，则它们将用作分隔符。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
千 (千位分隔符)	千位分隔符。 仅当文本文件中的数据包含与计算机上使用的分隔符不同的十进制和千位分隔符时，才使用此和 decimal 属性，因为使用了不同的语言设置。 有关描述行为的表，请参阅上面的十进制属性说明。 此属性的字符串值应为一个字符的长度。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。

[注意：此元素的内容模型 (CT_TextPr) 的 W3C XML 架构定义位于 §A.2 中。 注释结束]

ISO/IEC29500：2008。

构造函数

TextProperties()	初始化 TextProperties 类的新实例。
TextProperties(IEnumerable<OpenXmlElement>)	使用指定的子元素初始化 TextProperties 类的新实例。
TextProperties(OpenXmlElement[])	使用指定的子元素初始化 TextProperties 类的新实例。
TextProperties(String)	从外部 XML 初始化 TextProperties 类的新实例。

属性

ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
CodePage	codePage 表示架构中的以下属性：codePage
Comma	逗号 表示架构中的以下属性：逗号
Consecutive	连续 表示架构中的以下属性：连续
Decimal	decimal 表示架构中的以下属性：decimal
Delimited	分隔 表示架构中的以下属性：delimited
Delimiter	分隔符 表示架构中的以下属性：分隔符
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FileType	fileType 表示架构中的以下属性：fileType
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
FirstRow	firstRow 表示架构中的以下属性：firstRow
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
Prompt	提示 表示架构中的以下属性：prompt
Qualifier	限定 符 表示架构中的以下属性：限定符
Semicolon	分号 表示架构中的以下属性：分号
SourceFile	sourceFile 表示架构中的以下属性：sourceFile
Space	空格 表示架构中的以下属性：space
TabAsDelimiter	选项 卡 表示架构中的以下属性：选项卡
TextCharacterSet	characterSet 表示架构中的以下属性：characterSet
TextFields	TextFields。 表示架构中的以下元素标记：x：textFields。
Thousands	数以千计 表示架构中的以下属性：千
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	如果指定元素是已知的子元素，则将其添加到 元素。 这会根据架构将 元素添加到正确的位置。 (继承自 OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	将命名空间声明添加到当前节点。 (继承自 OpenXmlElement)
Ancestors()	枚举当前元素的所有上级。 (继承自 OpenXmlElement)
Ancestors<T>()	仅枚举具有指定类型的当前元素的上级。 (继承自 OpenXmlElement)
Annotation(Type)	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotation<T>()	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotations(Type)	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Annotations<T>()	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	将元素列表中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
Append(OpenXmlElement[])	将元素数组中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
AppendChild<T>(T)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlCompositeElement)
ClearAllAttributes()	清除所有属性，包括已知属性和扩展属性。 (继承自 OpenXmlElement)
Clone()	创建当前节点的副本。 (继承自 OpenXmlElement)
CloneNode(Boolean)	创建此节点的副本。
Descendants()	枚举当前元素的所有后代。 (继承自 OpenXmlElement)
Descendants<T>()	枚举类型为 T 的当前元素的所有后代。 (继承自 OpenXmlElement)
Elements()	枚举当前元素的所有子元素。 (继承自 OpenXmlElement)
Elements<T>()	仅枚举具有指定类型的当前元素的子元素。 (继承自 OpenXmlElement)
ElementsAfter()	枚举与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
ElementsBefore()	枚举当前元素之前且具有与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
GetAttribute(String, String)	获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 OpenXmlElement)
GetAttributes()	获取一个列表，该列表包含所有属性的副本。 (继承自 OpenXmlElement)
GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)
GetFirstChild<T>()	查找类型 T 中的第一个子元素。 (继承自 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素的指定索引处插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	将指定的元素紧接在当前元素的前面。 (继承自 OpenXmlElement)
IsAfter(OpenXmlElement)	确定当前元素是否以文档顺序显示在指定元素之后。 (继承自 OpenXmlElement)
IsBefore(OpenXmlElement)	确定当前元素是否按文档顺序显示在指定元素之前。 (继承自 OpenXmlElement)
LookupNamespace(String)	解析当前节点上下文中的命名空间前缀。 (继承自 OpenXmlElement)
LookupPrefix(String)	查找当前元素范围内命名空间 URI 的相应前缀。 (继承自 OpenXmlElement)
NextSibling()	获取紧跟在当前 OpenXmlElement 元素后面的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
NextSibling<T>()	获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
PrependChild<T>(T)	在当前元素的子节点列表的开头插入指定的元素。 (继承自 OpenXmlCompositeElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlCompositeElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	删除指定的子元素。 (继承自 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将当前元素的子元素之一替换为另一个 OpenXmlElement 元素。 (继承自 OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement)

显式接口实现

IEnumerable.GetEnumerator()	定义 TextProperties 类。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时，其限定名称为 x：textPr。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)