ConditionalFormattingRule Класс

Определение

Пространство имен:

DocumentFormat.OpenXml.Spreadsheet

Сборка:

DocumentFormat.OpenXml.dll

Пакет:

DocumentFormat.OpenXml v3.0.1

Правило условного форматирования.

Этот класс доступен в Office 2007 и более поздних версиях.

Когда объект сериализуется как xml, его полное имя — x:cfRule.

public class ConditionalFormattingRule : DocumentFormat.OpenXml.OpenXmlCompositeElement

type ConditionalFormattingRule = class
    inherit OpenXmlCompositeElement

Public Class ConditionalFormattingRule
Inherits OpenXmlCompositeElement

Наследование

Object

OpenXmlElement

OpenXmlCompositeElement

ConditionalFormattingRule

Комментарии

[ISO/IEC 29500-1 1 издание]

cfRule (правило условного форматирования)

В этом наборе содержится описание правила условного форматирования.

[Пример:

В этом примере показано правило условного форматирования, позволяющее выделить ячейки со значениями выше 0,5. Обратите внимание, что в этом случае содержимое формулы<> является статическим значением, но также может быть выражением формулы.

<conditionalFormatting sqref="E3:E9">  
  <cfRule type="cellIs" dxfId="0" priority="1" operator="greaterThan">  
    <formula>0.5</formula>  
  </cfRule>  
</conditionalFormatting>  

конец примера

Только правила со значением атрибута типа выражения поддерживают синтаксис формулы.

Родительские элементы
conditionalFormatting (§18.3.1.18)

Дочерние элементы	Вложенные запросы
colorScale (цветовая шкала)	§18.3.1.16
dataBar (панель данных)	§18.3.1.28
extLst (область хранения данных о будущих компонентах)	§18.2.10
formula (Formula)	§18.3.1.43
iconSet (набор значков)	§18.3.1.49

Атрибуты	Описание
aboveAverage (выше или ниже среднего)	Указывает, является ли правило "выше среднего". "1" означает "выше среднего". Этот атрибут игнорируется, если тип не равен параметру aboveAverage. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
bottom (Bottom N)	Указывает, является ли правило "верхний или нижний n" правилом "нижний n". "1" означает "нижнее". Этот атрибут игнорируется, если тип не равен top10. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
dxfId (идентификатор разностного форматирования)	Это индекс элемента dxf в части "Стили", указывающий, какое форматирование ячейки следует применять при выполнении условий правила условного форматирования. Возможные значения для этого атрибута определяются ST_DxfId простого типа (§18.18.25).
equalAverage (Equal Average)	Флаг, указывающий, включают ли критерии "aboveAverage" и "belowAverage" само среднее значение или исключают это значение. "1" указывает на включение среднего значения в условия. Этот атрибут игнорируется, если тип не равен параметру aboveAverage. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
operator (Operator)	Оператор в правиле условного форматирования "значение ячейки является". Этот атрибут игнорируется, если тип не равен cellIs Возможные значения для этого атрибута определяются простым типом ST_ConditionalFormattingOperator (§18.18.15).
процент (первые 10 процентов)	Указывает, является ли правило "верхний/нижний n" правилом "верхний/нижний n процентов". Этот атрибут игнорируется, если тип не равен top10. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
priority (Priority)	Приоритет этого правила условного форматирования. Это значение используется для определения формата, который должен быть оценен и отрисовывается. Более низкие числовые значения имеют более высокий приоритет, чем более высокие числовые значения, где "1" является наивысшим приоритетом. Возможные значения для этого атрибута определяются типом данных W3C XML Schema int .
rank (Rank)	Значение "n" в правиле условного форматирования "верхний/нижний n". Этот атрибут игнорируется, если тип не равен top10. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
stdDev (StdDev)	Число стандартных отклонений, включаемых выше или ниже среднего в правиле условного форматирования. Этот атрибут игнорируется, если тип не равен параметру aboveAverage. Если для stdDev имеется значение, а тип правила = aboveAverage, это правило автоматически является правилом "выше или ниже N стандартных отклонений". Возможные значения для этого атрибута определяются типом данных W3C XML Schema int .
stopIfTrue (stop if True)	Если этот флаг имеет значение "1", правила с более низким приоритетом не применяются к этому правилу, если это правило имеет значение true. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
text (Text)	Текстовое значение в правиле условного форматирования "text contains". Этот атрибут игнорируется, если тип не равен containsText. Допустимые значения этого атрибута определяются типом данных string схемы XML (консорциум W3C).
timePeriod (период времени)	Применимый период времени в "дате..." Правило условного форматирования. Этот атрибут игнорируется, если тип не равен timePeriod. Возможные значения для этого атрибута определяются простым типом ST_TimePeriod (§18.18.82).
type (Type)	Тип правила условного форматирования. Возможные значения для этого атрибута определяются простым типом ST_CfType (§18.18.12).

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

ISO/IEC29500: 2008.

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

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

Свойства

AboveAverage	Выше или ниже среднего Представляет следующий атрибут в схеме: aboveAverage
Bottom	Нижний N Представляет следующий атрибут в схеме: bottom
ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
EqualAverage	Равное среднее Представляет следующий атрибут в схеме: equalAverage
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FirstChild	Получает первый дочерний элемент текущего элемента OpenXmlElement. (Унаследовано от OpenXmlCompositeElement)
FormatId	Идентификатор разностного форматирования Представляет следующий атрибут в схеме: dxfId
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)
Operator	Оператор Представляет следующий атрибут в схеме: оператор
OuterXml	Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement)
Parent	Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement)
Percent	Первые 10 процентов Представляет следующий атрибут в схеме: percent
Prefix	Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
Priority	Приоритет Представляет следующий атрибут в схеме: priority
Rank	РАНГ Представляет следующий атрибут в схеме: rank
StdDev	StdDev Представляет следующий атрибут в схеме: stdDev
StopIfTrue	Остановить, если значение true Представляет следующий атрибут в схеме: stopIfTrue
Text	Текст Представляет следующий атрибут в схеме: text
TimePeriod	Период времени Представляет следующий атрибут в схеме: timePeriod
Type	Тип Представляет следующий атрибут в схеме: type
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()	Правило условного форматирования. Этот класс доступен в Office 2007 и более поздних версиях. Когда объект сериализуется как xml, его полное имя — x:cfRule. (Унаследовано от OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)