CellValue Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Это обеспечивает дополнительные конструкторы, чем в созданных файлах.
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "v")]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType
[DocumentFormat.OpenXml.SchemaAttr(22, "v")]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType
[DocumentFormat.OpenXml.SchemaAttr("x:v")]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType
type CellValue = class
inherit XstringType
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "v")>]
type CellValue = class
inherit XstringType
[<DocumentFormat.OpenXml.SchemaAttr(22, "v")>]
type CellValue = class
inherit XstringType
[<DocumentFormat.OpenXml.SchemaAttr("x:v")>]
type CellValue = class
inherit XstringType
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type CellValue = class
inherit XstringType
Public Class CellValue
Inherits XstringType
- Наследование
- Наследование
- Атрибуты
Примеры
В следующем примере кода создается файл электронной таблицы с именем "CellValue.xlsx" и записывается текст "Microsoft" в ячейку A2.
using System;
using DocumentFormat.OpenXml;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Spreadsheet;
namespace CellTypeEx
{
class Program
{
static void Main(string[] args)
{
string fileName = @"C:\Users\Public\Documents\CellValueEx.xlsx";
// Create a spreadsheet document by supplying the fileName.
SpreadsheetDocument spreadsheetDocument = SpreadsheetDocument.
Create(fileName, SpreadsheetDocumentType.Workbook);
// Add a WorkbookPart to the document.
WorkbookPart workbookpart = spreadsheetDocument.AddWorkbookPart();
workbookpart.Workbook = new Workbook();
// Add a WorksheetPart to the WorkbookPart.
WorksheetPart worksheetPart = workbookpart.AddNewPart<WorksheetPart>();
worksheetPart.Worksheet = new Worksheet(new SheetData());
// Add Sheets to the Workbook.
Sheets sheets = spreadsheetDocument.WorkbookPart.Workbook.AppendChild<Sheets>(new Sheets());
// Append a new worksheet and associate it with the workbook.
Sheet sheet = new Sheet()
{
Id = spreadsheetDocument.WorkbookPart.
GetIdOfPart(worksheetPart),
SheetId = 1,
Name = "mySheet"
};
sheets.Append(sheet);
Worksheet worksheet = new Worksheet();
SheetData sheetData = new SheetData();
Row row = new Row() { RowIndex = 2U, Spans = new ListValue<StringValue>() };
Cell cell = new Cell()
{
CellReference = "A2",
DataType = CellValues.String,
CellValue = new CellValue("Microsoft")
};
row.Append(cell);
sheetData.Append(row);
worksheet.Append(sheetData);
worksheetPart.Worksheet = worksheet;
workbookpart.Workbook.Save();
// Close the document.
spreadsheetDocument.Close();
Console.WriteLine("All done.\nPress a key.");
Console.ReadKey();
}
}
}
Imports System
Imports DocumentFormat.OpenXml
Imports DocumentFormat.OpenXml.Packaging
Imports DocumentFormat.OpenXml.Spreadsheet
Module Module1
Sub Main(ByVal args As String())
Dim fileName As String = "C:\Users\Public\Documents\CellValueEx.xlsx"
' Create a spreadsheet document by supplying the fileName.
Dim spreadsheetDocument As SpreadsheetDocument = _
spreadsheetDocument.Create(fileName, SpreadsheetDocumentType.Workbook)
' Add a WorkbookPart to the document.
Dim workbookpart As WorkbookPart = spreadsheetDocument.AddWorkbookPart()
workbookpart.Workbook = New Workbook()
' Add a WorksheetPart to the WorkbookPart.
Dim worksheetPart As WorksheetPart = _
workbookpart.AddNewPart(Of WorksheetPart)()
worksheetPart.Worksheet = New Worksheet(New SheetData())
' Add Sheets to the Workbook.
Dim sheets As Sheets = _
spreadsheetDocument.WorkbookPart.Workbook.AppendChild(Of Sheets)(New Sheets())
' Append a new worksheet and associate it with the workbook.
Dim sheet As New Sheet() With { _
.Id = spreadsheetDocument.WorkbookPart.GetIdOfPart(worksheetPart), _
.SheetId = 1, _
.Name = "mySheet" _
}
sheets.Append(sheet)
Dim worksheet As New Worksheet()
Dim sheetData As New SheetData()
Dim row As New Row() With { _
.RowIndex = 2UI, _
.Spans = New ListValue(Of StringValue)() _
}
Dim cell As New Cell() With { _
.CellReference = "A2", _
.DataType = CellValues.[String], _
.CellValue = New CellValue("Microsoft") _
}
row.Append(cell)
sheetData.Append(row)
worksheet.Append(sheetData)
worksheetPart.Worksheet = worksheet
workbookpart.Workbook.Save()
' Close the document.
spreadsheetDocument.Close()
Console.WriteLine("All done." & vbLf & "Press a key.")
Console.ReadKey()
End Sub
End Module
Комментарии
[ISO/IEC 29500-1 1 издание]
v (значение ячейки)
В этом элементе хранится значение, содержащееся в ячейке. Если ячейка содержит строку, то это значение является индексом в таблице общих строк, который указывает на фактическую строку. В противном случае значение ячейки находится непосредственно в данном элементе. Ячейки с формулами содержат последний вычисленный результат формулы в данном элементе.
Для приложений, не желающих реализовать общую таблицу строк, "встроенная строка" может быть выражена в элементе <is> под <c> (вместо <V-элемента> в c><) так же, как строка будет выражена в общей строковой таблице. [Примечание. См. <> пример. конечная заметка]
[Пример. В этом примере ячейка B4 содержит число "360", а C4 содержит дату UTC 22 ноября 1976 года, 08:30.
<c r="B4">
<v>360</v>
</c>
<c r="C4" t="d">
<v>1976-11-22T08:30Z</v>
</c>
конец примера
Возможные значения для этого элемента определяются ST_Xstring простого типа (§22.9.2.19).
Родительские элементы |
---|
c (§18.3.1.4); cell (§18.14.1); nc (§18.11.1.3); oc (§18.11.1.5); tp (§18.15.3) |
[Примечание. Определение xml-схемы W3C для модели содержимого этого элемента (ST_Xstring) находится в §A.6.9. конечная заметка]
ISO/IEC29500: 2008.
Конструкторы
CellValue() |
Инициализирует новый экземпляр класса CellValue. |
CellValue(Boolean) | |
CellValue(DateTime) |
Создает экземпляр для CellValueDateTime. Даты должны быть в формате ISO 8601, что гарантируется этим конструктором |
CellValue(DateTimeOffset) |
Создает экземпляр для CellValueDateTimeOffset. Даты должны быть в формате ISO 8601, что гарантируется этим конструктором |
CellValue(Decimal) | |
CellValue(Double) | |
CellValue(Int32) | |
CellValue(String) |
Инициализирует новый экземпляр класса CellValue с указанным текстовым содержимым. |
Свойства
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 |
Это обеспечивает дополнительные конструкторы, чем в созданных файлах. |
LocalName |
Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement) |
MCAttributes |
Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement) |
NamespaceDeclarations |
Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement) |
NamespaceUri |
Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement) |
OpenXmlElementContext |
Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement) |
OuterXml |
Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement) |
Parent |
Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement) |
Prefix |
Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement) |
Space |
Содержимое содержит значительные пробелы Представляет следующий атрибут в схеме: xml:space (Унаследовано от XstringType) |
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) |
TryGetBoolean(Boolean) |
Пытается проанализировать значение ячейки для получения Boolean. |
TryGetDateTime(DateTime) |
Пытается проанализировать значение ячейки для получения DateTime. |
TryGetDateTimeOffset(DateTimeOffset) |
Пытается проанализировать значение ячейки для получения DateTimeOffset. |
TryGetDecimal(Decimal) |
Пытается проанализировать значение ячейки для получения Decimal. |
TryGetDouble(Double) |
Пытается проанализировать значение ячейки для получения Double. |
TryGetInt(Int32) |
Пытается проанализировать значение ячейки для получения Int32. |
WriteTo(XmlWriter) |
Сохраняет текущий узел в указанном xmlWriter. (Унаследовано от OpenXmlElement) |
Явные реализации интерфейса
IEnumerable.GetEnumerator() |
Это обеспечивает дополнительные конструкторы, чем в созданных файлах. (Унаследовано от OpenXmlElement) |
IEnumerable<OpenXmlElement>.GetEnumerator() |
Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement) |