HeaderReference Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Referência de Cabeçalho.
Esta classe está disponível no Office 2007 e superior.
Quando o objeto é serializado como xml, o nome qualificado é w:headerReference.
public class HeaderReference : DocumentFormat.OpenXml.Wordprocessing.HeaderFooterReferenceType[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(23, "headerReference")]
public class HeaderReference : DocumentFormat.OpenXml.Wordprocessing.HeaderFooterReferenceType[DocumentFormat.OpenXml.SchemaAttr(23, "headerReference")]
public class HeaderReference : DocumentFormat.OpenXml.Wordprocessing.HeaderFooterReferenceType[DocumentFormat.OpenXml.SchemaAttr("w:headerReference")]
public class HeaderReference : DocumentFormat.OpenXml.Wordprocessing.HeaderFooterReferenceType[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class HeaderReference : DocumentFormat.OpenXml.Wordprocessing.HeaderFooterReferenceTypetype HeaderReference = class
inherit HeaderFooterReferenceType[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(23, "headerReference")>]
type HeaderReference = class
inherit HeaderFooterReferenceType[<DocumentFormat.OpenXml.SchemaAttr(23, "headerReference")>]
type HeaderReference = class
inherit HeaderFooterReferenceType[<DocumentFormat.OpenXml.SchemaAttr("w:headerReference")>]
type HeaderReference = class
inherit HeaderFooterReferenceType[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type HeaderReference = class
inherit HeaderFooterReferenceTypePublic Class HeaderReference
Inherits HeaderFooterReferenceType- Herança
- Herança
- Atributos
Comentários
[ISO/IEC 29500-1 1st Edition]
headerReference (Header Reference)
Este elemento especifica um único cabeçalho que deve ser associado à secção atual no documento. Este cabeçalho deve ser referenciado através do atributo ID, que especifica uma relação explícita com a parte cabeçalho adequada no pacote WordprocessingML.
Se o tipo de relação da relação especificada por este elemento não for , não http://schemas.openxmlformats.org/officeDocument/2006/headerestiver presente ou não tiver um valor de atributo TargetMode de Interno, o documento será considerado não conforme.
Em cada secção de um documento, pode haver até três tipos diferentes de cabeçalhos:
Cabeçalho da primeira página
Cabeçalho de página ímpar
Cabeçalho de página par
O tipo de cabeçalho especificado pelo cabeçalho atualReferência é especificado através do atributo type.
Se qualquer tipo de cabeçalho for omitido para uma determinada secção, aplicar-se-ão as seguintes regras.
Se não for especificado nenhum headerReference para o cabeçalho da primeira página e o elemento titlePg for especificado, o cabeçalho da primeira página será herdado da secção anterior ou, se esta for a primeira secção do documento, será criado um novo cabeçalho em branco. Se o elemento titlePg não for especificado, não será apresentado nenhum cabeçalho de primeira página e o cabeçalho de página ímpar será utilizado no seu lugar.
Se não for especificado nenhum headerReference para o cabeçalho de página par e for especificado o elemento evenAndOddHeaders, o cabeçalho da página par será herdado da secção anterior ou, se esta for a primeira secção do documento, será criado um novo cabeçalho em branco. Se o elemento evenAndOddHeaders não for especificado, não será apresentado nenhum cabeçalho de página par e o cabeçalho de página ímpar será utilizado no seu lugar.
Se não for especificado nenhum cabeçalhoReferência para o cabeçalho de página ímpar, o cabeçalho par da página será herdado da secção anterior ou, se esta for a primeira secção do documento, será criado um novo cabeçalho em branco.
[Exemplo: considere um documento de três páginas com um cabeçalho de página diferente, ímpar e par definido da seguinte forma:
f290aae3-2d0e-46b2-9a84-7e59757bc879
Este documento define três cabeçalhos, cada um dos quais tem uma relação da parte do documento com um ID de relação exclusivo, conforme mostrado na seguinte marcação de empacotamento:
<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
…
<Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/header" Target="header1.xml" />
<Relationship Id="rId3" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/header" Target="header2.xml" />
<Relationship Id="rId5" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/header" Target="header3.xml" />
…
</Relationships>
Estas relações são, em seguida, referenciadas nas propriedades da secção com o seguinte WordprocessingML:
<w:sectPr>
…
<w:headerReference r:id="rId3" w:type="first" />
<w:headerReference r:id="rId5" w:type="default" />
<w:headerReference r:id="rId2" w:type="even" />
…
</w:sectPr>
A secção resultante tem de utilizar a parte do cabeçalho com o id de relação rId3 para a primeira página, a parte do cabeçalho com o id de relação rId2 para todas as páginas pares subsequentes e a parte do cabeçalho com o id rId5 de relação para todas as páginas ímpares subsequentes. exemplo final]
| Elementos pai |
|---|
| sectPr (}17.6.17); sectPr (}17.6.18) |
[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (CT_HdrFtrRef) está localizada em {A.1. nota de fim]
ISO/IEC29500: 2008.
Construtores
| HeaderReference() |
Inicializa uma nova instância da classe HeaderReference. |
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) |
| Id |
Relação com a Peça Representa o seguinte atributo no esquema: r:id (Herdado de HeaderFooterReferenceType) |
| 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 |
Referência de Cabeçalho. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é w:headerReference. |
| 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) |
| Type |
type Representa o seguinte atributo no esquema: w:type (Herdado de HeaderFooterReferenceType) |
| 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) |
| GetEnumerator() |
Devolve um enumerador que itera através da coleção subordinada. (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() |
Referência de Cabeçalho. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é w:headerReference. (Herdado de OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement) |