Extension 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.
Extensão.
Esta classe está disponível no Office 2007 e superior.
Quando o objeto é serializado como xml, seu nome qualificado é x:ext.
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "ext")]
public class Extension : DocumentFormat.OpenXml.OpenXmlCompositeElementpublic class Extension : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr(22, "ext")]
public class Extension : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr("x:ext")]
public class Extension : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr("x:ext")]
public class Extension : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class Extension : DocumentFormat.OpenXml.OpenXmlCompositeElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "ext")>]
type Extension = class
inherit OpenXmlCompositeElementtype Extension = class
inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr(22, "ext")>]
type Extension = class
inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr("x:ext")>]
type Extension = class
inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr("x:ext")>]
type Extension = class
inherit TypedOpenXmlCompositeElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type Extension = class
inherit OpenXmlCompositeElementPublic Class Extension
Inherits OpenXmlCompositeElementPublic Class Extension
Inherits TypedOpenXmlCompositeElement- Herança
- Herança
- Atributos
Comentários
[ISO/IEC 29500-1 1st Edition]
ext (Extensão)
Cada extensão em uma lista de extensões deve estar contida em um elemento ext. As extensões devem ter controle de versão por namespace, usando o atributo uri, e devem ter permissão para aparecer em qualquer ordem na lista de extensões. Qualquer número de extensões deve ser permitido dentro de uma lista de extensões.
Quando as listas de extensão são processadas, um consumidor pode entender algumas extensões e pode não entender outras. O modelo de preservação para extensões é que as extensões não processadas devem sempre ser preservadas (ao consumir) e gravadas (ao produzir) na íntegra, desde que o esquema subjacente estendido pela lista de extensões permaneça. [Exemplo: se uma planilha spreadsheetML contiver várias extensões em uma lista de extensões e, por meio do processamento de tempo de execução, essa planilha for removida da pasta de trabalho, as extensões associadas a essa planilha não deverão ser gravadas ao produzir o documento de marcação resultante. exemplo de término].
Os namespaces de marcação dentro de extensões não precisam ser listados no atributo de Compatibility-Rule ignorável, nem esses namespaces precisam ser listados nos atributos Compatibility-Rule PreserveElements e PreserveAttributes. [Nota: Consulte a Parte 3 para discussão adicional sobre Application-Defined Elementos de Extensão e regras de processamento. nota final]
[Exemplo:
Neste exemplo, há duas extensões escritas. A primeira extensão descreve uma nova estrutura que pode ter sido definida por uma segunda versão fictícia do /IEC 29500. A segunda extensão descreve uma estrutura que pode ser introduzida por uma parte privada, desenvolvida independentemente do /IEC 29500.
<extLst>
<ext uri='http://schemas.openxmlformats.org/spreadsheetml/versionTwoExtension'>
<v2:newContent xmln:v2='http://schemas.openxmlformats.org/spreadsheetml/versionTwoExtension'>
…
</v2:newContent>
</ext>
<ext uri='http://www.extension.com/versionOneExtension'>
<v2:moreContent xmlsn:v2='http://www.extension.com/versionOneExtension'>
…
</v2:moreContent>
</ext>
</extList>
exemplo de término]
Cada extensão tem um atributo uri, que serve como um identificador para indicar informações sobre a extensão. [Observação: por exemplo, o uri pode indicar a versão de uma especificação de marcação com a qual o conteúdo está em conformidade ou pode declarar a versão de um aplicativo de produção que gravou o conteúdo. nota final] Ao encontrar extensões, um consumidor de processamento deve determinar se ele sabe como processar extensões usando o valor do uri. Se o consumidor souber como processar tal extensão, a marcação contida nessa extensão será processada. Caso contrário, o conteúdo da extensão deve ser preservado enquanto a estrutura subjacente que está sendo estendida pelo extLst não tiver sido removida.
| Elementos pai |
|---|
| extLst (§18.2.10) |
| Elementos filho | Subcláusula |
|---|---|
| Qualquer elemento em qualquer namespace | n/d |
| Atributos | Descrição |
|---|---|
| uri (URI) | Um token para identificar informações de versão e aplicativo para essa extensão específica. Os valores possíveis para esse atributo são definidos pelo tipo de dados de token do Esquema XML do W3C. |
[Observação: a definição do esquema XML do W3C do modelo de conteúdo desse elemento (CT_Extension) está localizada em §A.2. nota final]
ISO/IEC29500: 2008.
Construtores
| Nome | Description |
|---|---|
| Extension() |
Inicializa uma nova instância da classe Extension. |
| Extension(IEnumerable<OpenXmlElement>) |
Inicializa uma nova instância da classe Extension com os elementos filho especificados. |
| Extension(OpenXmlElement[]) |
Inicializa uma nova instância da classe Extension com os elementos filho especificados. |
| Extension(String) |
Inicializa uma nova instância da classe Extension do XML externo. |
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) |
| FirstChild |
Obtém o primeiro filho do elemento OpenXmlElement atual. (Herdado de OpenXmlCompositeElement) |
| 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 OpenXmlCompositeElement) |
| InnerText |
Obtém ou define os valores concatenados do nó atual e de todos os seus filhos. (Herdado de OpenXmlCompositeElement) |
| InnerXml |
Obtém ou define a marcação que representa apenas os nós filhos do nó atual. (Herdado de OpenXmlCompositeElement) |
| LastChild |
Obtém o último filho do elemento OpenXmlElement atual. Retorna null (Nothing no Visual Basic) se não existe esse elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement) |
| LocalName |
Extensão. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é x:ext. |
| 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) |
| 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) |
| Uri |
URI Representa o seguinte atributo no esquema: URI |
| 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) |
| AddChild(OpenXmlElement, Boolean) |
Adiciona o elemento especificado ao elemento se for um filho conhecido. Isso adiciona o elemento no local correto de acordo com o esquema. (Herdado de OpenXmlCompositeElement) |
| 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 OpenXmlCompositeElement) |
| 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) |
| GetEnumerator() |
Retorna um enumerador que itera por meio da coleção filho. (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 OpenXmlCompositeElement) |
| 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 dos filhos do elemento atual. (Herdado de OpenXmlCompositeElement) |
| InsertBefore<T>(T, OpenXmlElement) |
Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlCompositeElement) |
| 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 nós filhos do elemento atual. (Herdado de OpenXmlCompositeElement) |
| 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 OpenXmlCompositeElement) |
| 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. (Herdado de OpenXmlCompositeElement) |
| 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 dos elementos filho do elemento atual por outro elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement) |
| 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() |
Extensão. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é x:ext. (Herdado de OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement) |