RangeSet Classe

Definição

Namespace:

DocumentFormat.OpenXml.Spreadsheet

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

conjunto de intervalo.

Esta classe está disponível no Office 2007 e superior.

Quando o objeto é serializado como xml, seu nome qualificado é x:rangeSet.

public class RangeSet : DocumentFormat.OpenXml.OpenXmlLeafElement

type RangeSet = class
    inherit OpenXmlLeafElement

Public Class RangeSet
Inherits OpenXmlLeafElement

Herança

Object

OpenXmlElement

OpenXmlLeafElement

RangeSet

Comentários

[ISO/IEC 29500-1 1st Edition]

rangeSet (Range Set)

Representa um único intervalo na coleção rangeSets. destina-se a facilitar a criação de um relatório de tabela dinâmica consolidando intervalos de SpreadsheetML com categorias semelhantes de dados a serem resumidos. O layout mais simples para a fonte de dados é que cada rangeSets de dados esteja em formato de lista, com rótulos de coluna na primeira linha, rótulos de linha na primeira coluna, o restante das linhas com itens semelhantes na mesma linha e coluna e sem linhas ou colunas em branco dentro do intervalo. Um rangeSet específico pode consistir em um intervalo nomeado interno fornecido pelo aplicativo, um intervalo nomeado definido pelo usuário, uma referência de intervalo ou uma referência a uma pasta de trabalho externa.

Quando vários intervalos são consolidados usando essa funcionalidade, até 4 filtros de relatório personalizados (também conhecidos como campos de página) podem ser criados para ajudar a filtrar o relatório de tabela dinâmica, habilitando especificamente um ou mais intervalos individuais a serem selecionados no filtro de relatório. Para cada campo de página personalizado criado, um rótulo personalizado poderá ser especificado e atribuído a cada intervalo participante do intervalo de consolidação, para que a Tabela Dinâmica possa ser filtrada por um ou mais intervalos que estão sendo resumidos.

[Exemplo: considere uma pasta de trabalho com 6 planilhas. Na Planilha1 temos:

00CFA900-E26C-47F7-AF92-700036912181

Na Planilha2 temos:

c6bee0fb-5844-4b3e-b9ed-403edbfcee23

… e assim por diante até a Planilha5.

Na Planilha6, temos os intervalos consolidados sendo resumidos por uma Tabela Dinâmica e existem dois filtros de página para a Tabela Dinâmica.

8a269c06-dfb2-4f3a-8061-b81d3d1f02af

Observe que, para o filtro de segunda página, os itens receberam um rótulo personalizado, "um", "dois", ..., "cinco", para cada uma das fontes de dados Planilha1, Planilha2, ..., Planilha5, respectivamente. Da mesma forma, os itens receberam um rótulo personalizado, "1", "2", ..., "5" para cada uma das fontes de dados Planilha1, Planilha2, ..., Shet5, respectivamente.

O XML que representa esses filtros de página personalizados deve ser como o seguinte:

<cacheSource type="consolidation">  
  <consolidation autoPage="0">  
    <pages count="2">  
      <page count="5">  
        <pageItem name="1"/>  
        <pageItem name="2"/>  
        <pageItem name="3"/>  
        <pageItem name="4"/>  
        <pageItem name="5"/>  
      </page>  
      <page count="5">  
        <pageItem name="one"/>  
        <pageItem name="two"/>  
        <pageItem name="three"/>  
        <pageItem name="four"/>  
        <pageItem name="five"/>  
      </page>  
    </pages>  
    <rangeSets count="5">  
      <rangeSet i1="0" i2="0" ref="A1:B3" sheet="Sheet1"/>  
      <rangeSet i1="1" i2="1" ref="A1:B3" sheet="Sheet2"/>  
      <rangeSet i1="2" i2="2" ref="A1:B3" sheet="Sheet3"/>  
      <rangeSet i1="3" i2="3" ref="A1:B3" sheet="Sheet4"/>  
      <rangeSet i1="4" i2="4" ref="A1:B3" sheet="Sheet5"/>  
    </rangeSets>  
  </consolidation>  
</cacheSource>  

exemplo de término]

[Observação: os atributos i1, i2, i3 e i4 correspondem aos campos de página personalizados criados na interface do usuário. O ML de planilha dá suporte a apenas quatro campos de página personalizados. nota final]

Elementos pai
rangeSets (§18.10.1.80)

Atributos	Descrição
i1 (Índice do Item de Campo, Página 1)	Especifica o índice de um item de campo de página no filtro de página um. Os valores possíveis para esse atributo são definidos pelo tipo de dados unsignedInt do esquema XML do W3C.
i2 (Índice do Item de Campo, Página 2)	Especifica o índice de um item de campo de página no filtro de página dois. Os valores possíveis para esse atributo são definidos pelo tipo de dados unsignedInt do esquema XML do W3C.
i3 (Índice do item do campo, página 3)	Especifica o índice de um item de campo de página no filtro de página três. Os valores possíveis para esse atributo são definidos pelo tipo de dados unsignedInt do esquema XML do W3C.
i4 (Índice do Item de Campo, Página 4)	Especifica o índice de um item de campo de página no filtro de página quatro. Os valores possíveis para esse atributo são definidos pelo tipo de dados unsignedInt do esquema XML do W3C.
id (ID da relação) Namespace: .../officeDocument/2006/relationships	Especifica o identificador exclusivo da parte da pasta de trabalho em que o conjunto de intervalos é armazenado. Consulte Pasta de Trabalho (§18.2) para obter mais informações. Os valores possíveis para esse atributo são definidos pelo tipo ST_RelationshipId simples (§22.8.2.1).
name (Intervalo Nomeado)	Especifica o intervalo nomeado. Os valores possíveis para esse atributo são definidos pelo tipo ST_Xstring simples (§22.9.2.19).
ref (Referência)	Especifica o intervalo de células. Os valores possíveis para esse atributo são definidos pelo tipo simples ST_Ref (§18.18.62).
planilha (Nome da Planilha)	Especifica o nome da planilha. Os valores possíveis para esse atributo são definidos pelo tipo ST_Xstring simples (§22.9.2.19).

[Observação: a definição do esquema XML do W3C do modelo de conteúdo (CT_RangeSet) desse elemento está localizada em §A.2. nota final]

ISO/IEC29500: 2008.

Construtores

Nome	Description
RangeSet()	Inicializa uma nova instância da classe RangeSet.

Propriedades

Nome	Description
ChildElements	Obtém todos os nós filhos do elemento atual. (Herdado de OpenXmlElement)
ExtendedAttributes	Obtém todos os atributos estendidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
Features	Obtém um IFeatureCollection para o elemento atual. Essa coleção de recursos será somente leitura, mas herdará recursos de sua parte pai e pacote, se disponível. (Herdado de OpenXmlElement)
FieldItemIndexPage1	Índice de Item de Campo Página 1 Representa o seguinte atributo no esquema: i1
FieldItemIndexPage2	Índice de Item de Campo Página 2 Representa o seguinte atributo no esquema: i2
FieldItemIndexPage3	Índice de item de campo Página 3 Representa o seguinte atributo no esquema: i3
FieldItemIndexPage4	Índice de Item de Campo Página 4 Representa o seguinte atributo no esquema: i4
FirstChild	Obtém o primeiro filho do elemento OpenXmlElement. Retorna null (Nothing no Visual Basic) se não existe esse elemento OpenXmlElement. (Herdado de OpenXmlElement)
HasAttributes	Obtém um valor que indica se o elemento atual tem algum atributo. (Herdado de OpenXmlElement)
HasChildren	Obtém um valor que indica se o elemento atual tem algum elemento filho. (Herdado de OpenXmlLeafElement)
Id	ID do Relacionamento Representa o seguinte atributo no esquema: r:id
InnerText	Obtém ou define os valores concatenados do nó e de todos os seus filhos. (Herdado de OpenXmlElement)
InnerXml	Obtém ou define a marcação que representa apenas elementos filho do elemento atual. (Herdado de OpenXmlLeafElement)
LastChild	Obtém o último filho do elemento OpenXmlElement. Retorna null (Nothing no Visual Basic) se não existe esse elemento OpenXmlElement. (Herdado de OpenXmlElement)
LocalName	Obtém o nome local do elemento atual. (Herdado de OpenXmlElement)
MCAttributes	Obtém ou define os atributos de compatibilidade de marcação. Retorna null se nenhum atributo de compatibilidade de marcação for definido para o elemento atual. (Herdado de OpenXmlElement)
Name	Intervalo nomeado Representa o seguinte atributo no esquema: name
NamespaceDeclarations	Obtém todas as declarações de namespace definidas no elemento atual. Retorna um enumerador vazio se não houver nenhuma declaração de namespace. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do namespace do elemento atual. (Herdado de OpenXmlElement)
OpenXmlElementContext	Obtém o OpenXmlElementContext do elemento atual. (Herdado de OpenXmlElement)
OuterXml	Obtém a marcação que representa o elemento atual e todos os seus elementos filho. (Herdado de OpenXmlElement)
Parent	Obtém o elemento pai do elemento atual. (Herdado de OpenXmlElement)
Prefix	Obtém o prefixo do namespace do elemento atual. (Herdado de OpenXmlElement)
Reference	Referências Representa o seguinte atributo no esquema: ref
Sheet	Nome da Planilha Representa o seguinte atributo no esquema: de dados
XmlQualifiedName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)
XName	Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement)

Métodos

Nome	Description
AddAnnotation(Object)	Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de namespace ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os ancestrais do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os ancestrais do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations(Type)	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotations<T>()	Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Acrescenta cada elemento de uma lista de elementos ao final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos ao final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Anexa o elemento especificado ao final da lista de nós filhos do elemento atual. (Herdado de OpenXmlElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos estendidos. (Herdado de OpenXmlElement)
Clone()	Cria uma duplicata do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria uma duplicata desse nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumere todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os filhos do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os filhos do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos irmãos que seguem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos irmãos que precedem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da marca especificado e o URI do namespace. (Herdado de OpenXmlElement)
GetAttributes()	Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement)
GetFirstChild<T>()	Localiza o primeiro elemento filho no tipo T. (Herdado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente após o elemento de referência especificado. (Herdado de OpenXmlElement)
InsertAfterSelf<T>(T)	Insere o elemento especificado imediatamente após o elemento atual. (Herdado de OpenXmlElement)
InsertAt<T>(T, Int32)	Insere o elemento especificado no índice especificado na lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlElement)
InsertBeforeSelf<T>(T)	Insere o elemento especificado imediatamente antes do elemento atual. (Herdado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina se o elemento atual aparece após um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina se o elemento atual aparece antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement)
LookupNamespace(String)	Resolve o prefixo do namespace no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um URI de namespace no escopo do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Retorna null (Nothing no Visual Basic) se não houver nenhum próximo elemento OpenXmlElement. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Retorna null (Nothing no Visual Basic) se não houver próximo OpenXmlElement. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Retorna nulo (nada no Visual Basic ) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Retorna nulo (nada no Visual Basic) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual de seu pai. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos filho do elemento atual. (Herdado de OpenXmlLeafElement)
RemoveAllChildren<T>()	Remova todos os elementos filho do elemento atual que são do tipo T. (Herdado de OpenXmlElement)
RemoveAnnotations(Type)	Remove as anotações do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAnnotations<T>()	Remove as anotações com o tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
RemoveAttribute(String, String)	Remove o atributo do elemento atual. (Herdado de OpenXmlElement)
RemoveChild<T>(T)	Remove o elemento filho especificado da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de namespace para o prefixo especificado. Não removerá nada se não houver prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um elemento filho por outro elemento filho na lista de elementos filho do elemento atual. (Herdado de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for conhecido, o valor do atributo será definido. Se o atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define vários atributos para o elemento. Se um atributo for conhecido, o valor do atributo será definido. Se um atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Salva o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

Nome	Description
IEnumerable.GetEnumerator()	conjunto de intervalo. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é x:rangeSet. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement)