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 CHARACTER SETS по адресу http://www.iana.org/assignments/character-sets. [Примечание. При чтении этого значения, если система не поддерживает определенный набор символов, приложению разрешено решать, какой вариант является лучшим вариантом резервного действия. конечная заметка] Если этот атрибут отсутствует, используется атрибут codePage. Допустимые значения этого атрибута определяются типом данных string схемы XML (консорциум W3C).
запятая (запятая — разделитель)	Флаг, указывающий, следует ли обрабатывать символы-запятые как разделители полей. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
последовательный (последовательные разделители)	Флаг, указывающий, следует ли рассматривать последовательные разделители как только один разделитель. Если этот флаг имеет значение true , чем возможно, или даже вероятно, что некоторые строки будут возвращать больше полей, чем другие, и эти поля всегда будут заполнять ячейки на листе слева направо. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
decimal (десятичный разделитель)	Символ десятичного разделителя. Этот атрибут и атрибуты тысяч используются только в том случае, если данные в текстовом файле содержат разделители десятичных и тысяч, которые отличаются от используемых на компьютере из-за другого параметра языка. В следующей таблице показаны результаты импорта текста в приложение электронной таблицы с помощью различных разделителей. Числовые результаты отображаются в крайнем правом столбце. Системный разделитель десятичных разрядов Разделитель системных тысяч Значение разделителя десятичного файла в текстовом файле Значение разделителя тысяч текстовых файлов Импортированный текст Значение ячейки (тип данных) Period Запятой Запятой Period 123.123,45 123,123,45 (числовое значение) Period Запятой Запятой Запятой 123.123,45 123.123,45 (текст) Запятой Period Запятой Period 123,123.45 123,123,45 (числовое значение) Period Запятой Period Запятой 123 123.45 123 123.45 (текст) Period Запятой Period Space 123 123.45 123,123,45 (числовое значение) Строковые значения этого атрибута должны быть длиной в один символ. Возможные значения для этого атрибута определяются ST_Xstring простого типа (§22.9.2.19).
с разделителями (файл с разделителями)	Значение true , если файл имеет табуляции или разделитель символов. значение false , если файл должен быть проанализирован в соответствии с полями фиксированной длины. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
разделитель (настраиваемый разделитель)	Заданный пользователем символ, который будет рассматриваться как разделитель полей. Поддерживаются только отдельные символы. Возможные значения для этого атрибута определяются ST_Xstring простого типа (§22.9.2.19).
fileType (тип файла)	Игнорируемый атрибут со значением перечисления, определенным ST_FileType. Определяет тип набора символов, используемых во время импорта. Для textPr должен быть указан только один из fileType и characterSet или codePage. Возможные значения для этого атрибута определяются простым типом ST_FileType (§18.18.29).
firstRow (первая строка)	Указывает, в какой строке файла следует начать импорт данных. Разрешены все значения unsignedInt, хотя вполне возможно, что firstRow превышает число строк в текстовом файле, и в этом случае данные не импортируются. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
prompt (запрос имени файла)	Флаг, указывающий, требуется ли пользователю запрашивать имя файла при обновлении. Если задано значение false, пользователю не будет предложено. Если значение true или нет, пользователю будет предложено. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
квалификатор (квалификатор)	Символ, используемый в качестве квалификатора текстовой строки. Возможные значения для этого атрибута определяются простым типом ST_Qualifier (§18.18.61).
точка с запятой (точка с запятой — разделитель)	Флаг, указывающий, следует ли обрабатывать символы с запятой как разделители полей. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
sourceFile (имя исходного файла)	Путь к текстовому файлу для импорта внешних данных. Может быть выражено в нотации пути файла или для конкретной системы. [Примечание. Приложения могут решать, какие формы поддерживаются и поддерживаются ли системные нотации пути к файлам. конечная заметка] Возможные значения для этого атрибута определяются ST_Xstring простого типа (§22.9.2.19).
пробел (пробел — разделитель)	Флаг, указывающий, следует ли обрабатывать пробелы как разделители полей. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
tab (tab — разделитель)	Флаг, указывающий, следует ли обрабатывать символы табуляции как разделители полей. Если значение равно false, вкладки не будут использоваться в качестве разделителей. Если значение true или нет, они используются в качестве разделителей. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
thousands (Разделитель тысяч)	Символ разделителя тысяч. Этот атрибут и десятичный атрибут используются только в том случае, если данные в текстовом файле содержат разделители decimal и тысяч, отличающиеся от используемых на компьютере из-за другого параметра языка. Обратитесь к описанию десятичного атрибута выше для таблицы, описывающей поведение. Строковые значения этого атрибута должны быть длиной в один символ. Возможные значения для этого атрибута определяются ST_Xstring простого типа (§22.9.2.19).

[Примечание. Определение xml-схемы W3C для модели содержимого этого элемента (CT_TextPr) находится в §A.2. конечная заметка]

ISO/IEC29500: 2008.

Конструкторы

TextProperties()	Инициализирует новый экземпляр класса TextProperties.
TextProperties(IEnumerable<OpenXmlElement>)	Инициализирует новый экземпляр класса TextProperties указанными дочерними элементами.
TextProperties(OpenXmlElement[])	Инициализирует новый экземпляр класса TextProperties указанными дочерними элементами.
TextProperties(String)	Инициализирует новый экземпляр класса TextProperties из внешнего XML- кода.

Свойства

ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
CodePage	Codepage Представляет следующий атрибут в схеме: codePage
Comma	Запятая Представляет следующий атрибут в схеме: запятая
Consecutive	Последовательных Представляет следующий атрибут в схеме: последовательный
Decimal	decimal Представляет следующий атрибут в схеме: decimal
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. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от 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)	Возвращает атрибут Open XML с указанным именем тега и URI пространства имен. (Унаследовано от 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. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
NextSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего OpenXmlElement. (Унаследовано от OpenXmlElement)
PrependChild<T>(T)	Вставляет указанный элемент в начало списка дочерних узлов текущего элемента. (Унаследовано от OpenXmlCompositeElement)
PreviousSibling()	Возвращает элемент OpenXmlElement, который непосредственно предшествует текущему элементу OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
PreviousSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который предшествует текущему объекту OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от 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)