Text Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Текст.
Этот класс доступен в Office 2007 и более поздних версиях.
Когда объект сериализуется как xml, его полное имя — w:t.
public class Text : DocumentFormat.OpenXml.Wordprocessing.TextType
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(23, "t")]
public class Text : DocumentFormat.OpenXml.Wordprocessing.TextType
[DocumentFormat.OpenXml.SchemaAttr(23, "t")]
public class Text : DocumentFormat.OpenXml.Wordprocessing.TextType
[DocumentFormat.OpenXml.SchemaAttr("w:t")]
public class Text : DocumentFormat.OpenXml.Wordprocessing.TextType
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class Text : DocumentFormat.OpenXml.Wordprocessing.TextType
type Text = class
inherit TextType
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(23, "t")>]
type Text = class
inherit TextType
[<DocumentFormat.OpenXml.SchemaAttr(23, "t")>]
type Text = class
inherit TextType
[<DocumentFormat.OpenXml.SchemaAttr("w:t")>]
type Text = class
inherit TextType
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type Text = class
inherit TextType
Public Class Text
Inherits TextType
- Наследование
- Наследование
- Атрибуты
Примеры
В следующем примере кода создается документ с именем "TextEx.docx" по указанному пути и в него записывается фраза "Hello, World!".
using System;
using DocumentFormat.OpenXml;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
namespace TextEx
{
class Program
{
static void Main(string[] args)
{
string fileName = @"c:\users\public\documents\TextEx.docx";
// Create a wordprocessing document with the specified file name.
WordprocessingDocument wordprocessingDocument =
WordprocessingDocument.Create(fileName, WordprocessingDocumentType.Document);
// Add a MainDocumentPart object.
MainDocumentPart mainDocumentPart =
wordprocessingDocument.AddMainDocumentPart();
// Creatre the document structure.
mainDocumentPart.Document = new Document();
Document document = mainDocumentPart.Document;
Body body = document.AppendChild(new Body());
Paragraph para = body.AppendChild(new Paragraph());
Run run = para.AppendChild(new Run());
// Write some text to the file.
run.AppendChild(new Text("Hello, World!"));
// Close the document.
wordprocessingDocument.Close();
Console.WriteLine("The document has been created.\nPress a key");
Console.ReadKey();
}
}
}
Imports DocumentFormat.OpenXml
Imports DocumentFormat.OpenXml.Packaging
Imports DocumentFormat.OpenXml.Wordprocessing
Module Module1
Sub Main(ByVal args As String())
Dim fileName As String = "c:\users\public\documents\TextEx.docx"
' Create a wordprocessing document with the specified file name.
Dim wordprocessingDocument As WordprocessingDocument = _
wordprocessingDocument.Create(fileName, WordprocessingDocumentType.Document)
' Add a MainDocumentPart object.
Dim mainDocumentPart As MainDocumentPart = _
wordprocessingDocument.AddMainDocumentPart()
' Creatre the document structure.
mainDocumentPart.Document = New Document()
Dim document As Document = mainDocumentPart.Document
Dim body As Body = document.AppendChild(New Body())
Dim para As Paragraph = body.AppendChild(New Paragraph())
Dim run As Run = para.AppendChild(New Run())
' Write some text to the file.
run.AppendChild(New Text("Hello, World!"))
' Close the document.
wordprocessingDocument.Close()
Console.WriteLine("The document has been created." & vbLf & "Press a key")
Console.ReadKey()
End Sub
End Module
Комментарии
[ISO/IEC 29500-1 1 издание]
t (текст)
Этот элемент указывает, что этот запуск содержит литеральный текст, который должен отображаться в документе. Элемент t должен использоваться для всех текстовых выполнений, которые не являются:
Часть области текста, которая содержится в удаленной области с помощью элемента del (§17.13.5.14)
Часть области текста, которая содержится в коде поля
[Пример. Рассмотрим абзац содержимого WordprocessingML с текстом This is text. Таким образом, этот пункт будет представлен следующим образом:
<w:p>
<w:r>
<w:t>This is text</w:t>
</w:r>
</w:p>
Текст содержится в узле t. конец примера
| Родительские элементы |
|---|
| r (§22.1.2.87); r (§17.3.2.25) |
[Примечание. Определение xml-схемы W3C для модели содержимого этого элемента (CT_Text) находится в §A.1. конечная заметка]
ISO/IEC29500: 2008.
Конструкторы
| Text() |
Инициализирует новый экземпляр класса Text. |
| Text(String) |
Инициализирует новый экземпляр класса Text с указанным текстовым содержимым. |
Свойства
| ChildElements |
Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement) |
| ExtendedAttributes |
Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement) |
| Features |
IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement) |
| FirstChild |
Возвращает первый дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement) |
| HasAttributes |
Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement) |
| HasChildren |
Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlLeafTextElement) |
| InnerText |
Возвращает или задает объединенные значения элемента и всех его дочерних элементов. (Унаследовано от OpenXmlLeafTextElement) |
| InnerXml |
Возвращает или задает разметку, представляющую только дочерние элементы текущего элемента. (Унаследовано от OpenXmlLeafTextElement) |
| LastChild |
Возвращает последний дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement) |
| LocalName |
Текст. Этот класс доступен в Office 2007 и более поздних версиях. Когда объект сериализуется как xml, его полное имя — w:t. |
| LocalName |
Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement) |
| MCAttributes |
Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement) |
| NamespaceDeclarations |
Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement) |
| NamespaceUri |
Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement) |
| OpenXmlElementContext |
Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement) |
| OuterXml |
Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement) |
| Parent |
Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement) |
| Prefix |
Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement) |
| Space |
Пробел Представляет следующий атрибут в схеме: xml:space (Унаследовано от TextType) |
| Text |
Возвращает или задает текст текущего элемента. (Унаследовано от OpenXmlLeafTextElement) |
| XmlQualifiedName |
Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement) |
| XName |
Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement) |
Методы
| AddAnnotation(Object) |
Добавляет объект в список заметок текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement) |
| 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) |
Добавляет указанный элемент в конец списка дочерних узлов текущего элемента. (Унаследовано от OpenXmlElement) |
| 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) |
Вставляет указанный элемент сразу после указанного ссылочного элемента. (Унаследовано от OpenXmlElement) |
| InsertAfterSelf<T>(T) |
Вставляет указанный элемент сразу после текущего элемента. (Унаследовано от OpenXmlElement) |
| InsertAt<T>(T, Int32) |
Вставляет указанный элемент по указанному индексу в список дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement) |
| InsertBefore<T>(T, OpenXmlElement) |
Вставляет указанный элемент непосредственно перед указанным ссылочным элементом. (Унаследовано от OpenXmlElement) |
| 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) |
Вставляет указанный элемент в начало списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement) |
| PreviousSibling() |
Возвращает элемент OpenXmlElement, который непосредственно предшествует текущему элементу OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement) |
| PreviousSibling<T>() |
Возвращает элемент OpenXmlElement с указанным типом, который предшествует текущему объекту OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement) |
| Remove() |
Удаляет текущий элемент из родительского элемента. (Унаследовано от OpenXmlElement) |
| RemoveAllChildren() |
Удаляет все дочерние элементы текущего элемента. (Унаследовано от OpenXmlLeafTextElement) |
| RemoveAllChildren<T>() |
Удалите все дочерние элементы текущего элемента типа T. (Унаследовано от OpenXmlElement) |
| RemoveAnnotations(Type) |
Удаляет заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement) |
| RemoveAnnotations<T>() |
Удаляет заметки с указанным типом из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement) |
| RemoveAttribute(String, String) |
Удаляет атрибут из текущего элемента. (Унаследовано от OpenXmlElement) |
| RemoveChild<T>(T) |
Удаляет указанный дочерний элемент из списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement) |
| RemoveNamespaceDeclaration(String) |
Удаляет объявление пространства имен для указанного префикса. Ничего не удаляет, если нет префикса. (Унаследовано от OpenXmlElement) |
| ReplaceChild<T>(OpenXmlElement, T) |
Заменяет дочерний элемент другим дочерним элементом в списке дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement) |
| SetAttribute(OpenXmlAttribute) |
Задает атрибут заданного элемента. Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement) |
| SetAttributes(IEnumerable<OpenXmlAttribute>) |
Задает ряд атрибутов элемента . Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement) |
| WriteTo(XmlWriter) |
Сохраняет текущий узел в указанном xmlWriter. (Унаследовано от OpenXmlElement) |
Явные реализации интерфейса
| IEnumerable.GetEnumerator() |
Текст. Этот класс доступен в Office 2007 и более поздних версиях. Когда объект сериализуется как xml, его полное имя — w:t. (Унаследовано от OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement) |