RangeSet Classe

Definição

Namespace:

DocumentFormat.OpenXml.Spreadsheet

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Conjunto de Intervalos.

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

Quando o objeto é serializado como xml, o 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. O elemento destina-se a facilitar a criação de um relatório de tabela dinâmica ao consolidar intervalos de Folhas de Cálculoml com categorias de dados semelhantes a resumir. O esquema mais simples para a origem de dados é que cada intervaloConjunto de dados esteja no formato de lista, com etiquetas de coluna na primeira linha, etiquetas de linha na primeira coluna, o resto das linhas com itens semelhantes na mesma linha e coluna e sem linhas ou colunas em branco dentro do intervalo. Um intervalo específicoConjunto pode consistir num intervalo com nome incorporado fornecido pela aplicação, um intervalo com nome definido pelo utilizador, uma referência de intervalo ou uma referência a um livro externo.

Quando vários intervalos são consolidados com esta funcionalidade, podem ser criados até 4 filtros de relatório personalizados (também conhecidos como campos de página) para ajudar a filtrar o relatório de tabela dinâmica, ao ativar especificamente um ou mais dos intervalos individuais a serem selecionados no filtro de relatório. Para cada campo de página personalizado criado, uma etiqueta personalizada pode ser especificada e atribuída a cada intervalo que participe no intervalo de consolidação, para que a tabela dinâmica possa ser filtrada por um ou mais dos intervalos que estão a ser resumidos.

[Exemplo:Considere um livro com 6 folhas de cálculo. Na Folha1 temos:

00cfa900-e26c-47f7-af92-700036912181

Na Folha2 temos:

c6bee0fb-5844-4b3e-b9ed-403edbfcee23

… e assim sucessivamente até à Folha5.

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

8a269c06-dfb2-4f3a-8061-b81d3d1f02af

Repare que, para o filtro da segunda página, foi atribuída uma etiqueta personalizada aos itens, "um", "dois", ..., "cinco", para cada uma das origens de dados folha1, Folha2, ..., Folha5, respetivamente. Da mesma forma, foi atribuída uma etiqueta personalizada aos itens, "1", "2", ..., "5" para cada uma das origens de dados Folha1, Folha2, ..., Shet5, respetivamente.

O XML que representa estes filtros de página personalizados tem de ser semelhante ao 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 final]

[Nota: os atributos i1, i2, i3 e i4 correspondem a campos de página personalizados criados na interface de utilizador. O ML da folha de cálculo só suporta 4 campos de página personalizados. nota de fim]

Elementos pai
rangeSets (}18.10.1.80)

Atributos	Descrição
i1 (Página 1 do Índice de Itens de Campo)	Especifica o índice de um item de campo de página no filtro de página um. Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
i2 (Página 2 do Índice de Itens de Campo)	Especifica o índice de um item de campo de página no filtro de página dois. Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
i3 (Índice de Itens de 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 este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
i4 (Página 4 do Índice de Itens de Campo)	Especifica o índice de um item de campo de página no filtro de página quatro. Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
ID (ID da Relação) Espaço de nomes: .../officeDocument/2006/relationships	Especifica o identificador exclusivo da peça Livro onde o conjunto de intervalos está armazenado. Consulte Livro (}18.2) para obter mais informações. Os valores possíveis para este atributo são definidos pelo ST_RelationshipId tipo simples (}22.8.2.1).
name (Intervalo com Nome)	Especifica o intervalo com nome. Os valores possíveis para este atributo são definidos pelo ST_Xstring tipo simples (}22.9.2.19).
ref (Referência)	Especifica o intervalo de células. Os valores possíveis para este atributo são definidos pelo ST_Ref tipo simples (}18.18.62).
folha (Nome da Folha)	Especifica o nome da folha. Os valores possíveis para este atributo são definidos pelo ST_Xstring tipo simples (}22.9.2.19).

[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (CT_RangeSet) está localizada em {A.2. nota de fim]

ISO/IEC29500: 2008.

Construtores

RangeSet()

Inicializa uma nova instância da classe RangeSet.

Propriedades

ChildElements	Obtém todos os nós subordinados do elemento atual. (Herdado de OpenXmlElement)
ExtendedAttributes	Obtém todos os atributos expandidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement)
Features	Obtém um IFeatureCollection para o elemento atual. Esta coleção de funcionalidades será só de leitura, mas herdará as funcionalidades da parte principal e do pacote, se disponível. (Herdado de OpenXmlElement)
FieldItemIndexPage1	Página 1 do Índice de Itens de Campo Representa o seguinte atributo no esquema: i1
FieldItemIndexPage2	Página 2 do Índice de Itens de Campo Representa o seguinte atributo no esquema: i2
FieldItemIndexPage3	Página 3 do índice de Itens de Campo Representa o seguinte atributo no esquema: i3
FieldItemIndexPage4	Página 4 do Índice de Itens de Campo Representa o seguinte atributo no esquema: i4
FirstChild	Obtém o primeiro elemento subordinado do elemento OpenXmlElement. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement. (Herdado de OpenXmlElement)
HasAttributes	Obtém um valor que indica se o elemento atual tem atributos. (Herdado de OpenXmlElement)
HasChildren	Obtém um valor que indica se o elemento atual tem elementos subordinados. (Herdado de OpenXmlLeafElement)
Id	ID da Relação Representa o seguinte atributo no esquema: r:id
InnerText	Obtém ou define os valores concatenados do nó e de todos os respetivos subordinados. (Herdado de OpenXmlElement)
InnerXml	Obtém ou define a marcação que representa apenas elementos subordinados do elemento atual. (Herdado de OpenXmlLeafElement)
LastChild	Obtém o último elemento subordinado do elemento OpenXmlElement. Devolve nulo (Nada no Visual Basic) se não existir 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 markup. Devolve nulo se não forem definidos atributos de compatibilidade de markup para o elemento atual. (Herdado de OpenXmlElement)
Name	Intervalo com Nome Representa o seguinte atributo no esquema: nome
NamespaceDeclarations	Obtém todas as declarações de espaço de nomes definidas no elemento atual. Devolve um enumerador vazio se não existir nenhuma declaração de espaço de nomes. (Herdado de OpenXmlElement)
NamespaceUri	Obtém o URI do espaço de nomes 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 respetivos elementos subordinados. (Herdado de OpenXmlElement)
Parent	Obtém o elemento principal do elemento atual. (Herdado de OpenXmlElement)
Prefix	Obtém o prefixo de espaço de nomes do elemento atual. (Herdado de OpenXmlElement)
Reference	Referências Representa o seguinte atributo no esquema: ref
Sheet	Nome da Folha Representa o seguinte atributo no esquema: folha
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

AddAnnotation(Object)	Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
AddNamespaceDeclaration(String, String)	Adiciona uma declaração de espaço de nomes ao nó atual. (Herdado de OpenXmlElement)
Ancestors()	Enumera todos os predecessores do elemento atual. (Herdado de OpenXmlElement)
Ancestors<T>()	Enumera apenas os predecessores do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
Annotation(Type)	Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement)
Annotation<T>()	Obtenha o primeiro objeto de anotação do tipo especificado a partir 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 fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Append(OpenXmlElement[])	Acrescenta cada elemento de uma matriz de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
AppendChild<T>(T)	Acrescenta o elemento especificado ao fim da lista de nós subordinados do elemento atual. (Herdado de OpenXmlElement)
ClearAllAttributes()	Limpa todos os atributos, incluindo atributos conhecidos e atributos expandidos. (Herdado de OpenXmlElement)
Clone()	Cria um duplicado do nó atual. (Herdado de OpenXmlElement)
CloneNode(Boolean)	Cria um duplicado deste nó.
Descendants()	Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement)
Descendants<T>()	Enumerar todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement)
Elements()	Enumera todos os elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
Elements<T>()	Enumera apenas os subordinados do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement)
ElementsAfter()	Enumera todos os elementos do elemento colateral que seguem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
ElementsBefore()	Enumera todos os elementos do elemento colateral que precedem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement)
GetAttribute(String, String)	Obtém um atributo Open XML com o nome da etiqueta especificado e o URI do espaço de nomes. (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 subordinado 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 subordinados 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 depois de 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 espaço de nomes no contexto do nó atual. (Herdado de OpenXmlElement)
LookupPrefix(String)	Localiza o prefixo correspondente para um URI de espaço de nomes no âmbito do elemento atual. (Herdado de OpenXmlElement)
NextSibling()	Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement seguinte. (Herdado de OpenXmlElement)
NextSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir um OpenXmlElement seguinte. (Herdado de OpenXmlElement)
PrependChild<T>(T)	Insere o elemento especificado no início da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
PreviousSibling()	Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
PreviousSibling<T>()	Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement)
Remove()	Remove o elemento atual do respetivo elemento principal. (Herdado de OpenXmlElement)
RemoveAllChildren()	Remove todos os elementos subordinados do elemento atual. (Herdado de OpenXmlLeafElement)
RemoveAllChildren<T>()	Remova todos os elementos subordinados 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 subordinado especificado da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Remove a declaração de espaço de nomes para o prefixo especificado. Não remove nada se não existir um prefixo. (Herdado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Substitui um elemento subordinado por outro elemento subordinado na lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Define um atributo para o elemento especificado. Se o atributo for um atributo conhecido, o valor do atributo é definido. Se o atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Define vários atributos para o elemento . Se um atributo for um atributo conhecido, o valor do atributo é definido. Se um atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement)

Implantações explícitas de interface

IEnumerable.GetEnumerator()	Conjunto de Intervalos. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é x:rangeSet. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)