ColumnIndex Classe

Definição

Namespace:

DocumentFormat.OpenXml.Wordprocessing

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Índice de Coluna Que Contém Valores Exclusivos para Registo.

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

Quando o objeto é serializado como xml, o nome qualificado é w:column.

public class ColumnIndex : DocumentFormat.OpenXml.Wordprocessing.UnsignedDecimalNumberType

type ColumnIndex = class
    inherit UnsignedDecimalNumberType

Public Class ColumnIndex
Inherits UnsignedDecimalNumberType

Herança

Object

OpenXmlElement

OpenXmlLeafElement

UnsignedDecimalNumberType

ColumnIndex

Comentários

[ISO/IEC 29500-1 1st Edition]

coluna (Índice de Coluna a Ser Mapeado)

Este elemento especifica o índice baseado em zero da coluna numa determinada origem de dados externa que deve ser mapeada para o nome local de um campo MERGEFIELD específico (\17.16.5.35) especificado pelos dados de mapeamento do campo principal. O atributo val especifica este valor de índice, que é utilizado para procurar a coluna adequada na origem de dados.

Se este elemento for omitido ou o respetivo valor exceder o número de colunas na origem de dados associada, o índice da coluna referenciada será considerado 0.

[Exemplo: considere um documento de origem que esteja ligado a uma origem de dados externa com três colunas. Nesta origem de dados externa, estas são três colunas ordenadas e intituladas da seguinte forma: primeiro, meio e último, respetivamente. O wordprocessingML seguinte especifica que, quando este documento estava ligado à origem de dados, estas colunas foram ordenadas desta forma:

<w:fieldMapData>  
  …  <w:name w:val="first" />  
  <w:column w:val="0" />  
</w:fieldMapData>  
<w:fieldMapData>  
  …  <w:name w:val="middle" />  
  <w:column w:val="1" />  
</w:fieldMapData>  
<w:fieldMapData>  
  …  <w:name w:val="last" />  
  <w:column w:val="2" />  
</w:fieldMapData>  

O WordprocessingML acima demonstra que a coluna intitulada first tem de ser associada à primeira coluna na base de dados externa ao especificar um elemento de coluna com o atributo val igual à adição. A coluna intitulada meio tem de ser associada à segunda coluna na base de dados externa ao especificar um elemento de coluna com o atributo val igual a 1. Por fim, a coluna intitulada último tem de ser associada à terceira coluna na base de dados externa ao especificar um elemento de coluna com o respetivo atributo val igual a 2. exemplo final]

É importante perceber que os valores do elemento name são uma cache da última vez que o documento foi ligado à base de dados e os índices especificados têm de ser utilizados para ligar os mapeamentos de campos às colunas na origem de dados. exemplo final]

Elementos pai
fieldMapData (}17.14.15)

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

[ISO/IEC 29500-1 1st Edition]

coluna (Índice da Coluna Que Contém Valores Exclusivos para Registo)

Este elemento especifica a coluna na origem de dados externa especificada que contém dados exclusivos para o registo atual nessa origem de dados. Este elemento deve ser utilizado em conjunto com o elemento uniqueTag (}17.14.35) para manter uma relação entre um registo específico numa origem de dados externa e uma determinada origem ou documento intercalado. O atributo val neste elemento deve ser interpretado como um índice baseado em zero nas colunas especificadas pela origem de dados, especificando a coluna resultante como a coluna na qual o elemento uniqueTag deve ser pesquisado.

Se este elemento especificar um número de coluna que exceda o número de colunas na origem de dados externa especificada, o respetivo valor será ignorado.

[Nota: estas informações são necessárias como parte de uma impressão em série, uma vez que os registos podem ser adicionados ou eliminados de origens de dados externas e tem de ser fornecido um meio para manter dados de exclusão ou inclusão específicos de registos com o elemento ativo (\17.14.1) e o registo de dados externos afetado quando o documento wordprocessingML é novamente ligado à origem de dados externa, independentemente da ordenação dos registos na origem de dados externa. nota de fim]

[Exemplo: considere o seguinte fragmento do WordprocessingML para obter as informações sobre um único registo num documento de origem para uma impressão em série:

<w:recipientData>  
  <w:active w:val="0" />  
  <w:column w:val="12" />   
  <w:uniqueTag>258865469</w:uniqueTag>   
</w:recipientData>  

O registo de dados externos associado a estas informações é especificado através da coluna na origem de dados externa correspondente ao elemento de coluna com um atributo val igual a 12, que contém uma linha cujo valor nesta coluna tem um valor correspondente ao elemento uniqueTag (\17.14.35) com um atributo val igual a 258865469. Este registo não é importado para o documento wordprocessingML intercalado, uma vez que o elemento ativo (}17.14.1) associado ao registo de dados externo especificado tem um atributo val igual a 0.

Por outras palavras, quando a origem de dados externa especificada está ligada, o registo na décima terceira coluna da origem de dados externa que tem os conteúdos 258865469 e não povoa campos mapeados num documento intercalado com dados desse registo. exemplo final]

Elementos pai
recipientData (}17.14.27)

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

ISO/IEC29500: 2008.

Construtores

ColumnIndex()

Inicializa uma nova instância da classe ColumnIndex.

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)
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)
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)
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)
Val	val Representa o seguinte atributo no esquema: w:val (Herdado de UnsignedDecimalNumberType)
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()	Índice de Coluna Que Contém Valores Exclusivos para Registo. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é w:column. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)