Idioma

Field Classe

Definição

Campo de Texto.

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

Quando o objeto é serializado como xml, seu nome qualificado é a:fld.

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.RunProperties))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.ParagraphProperties))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.Text))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(10, "fld")]
public class Field : DocumentFormat.OpenXml.OpenXmlCompositeElement
public class Field : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr(10, "fld")]
public class Field : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr("a:fld")]
public class Field : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr("a:fld")]
public class Field : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.RunProperties))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.ParagraphProperties))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.Text))]
public class Field : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.RunProperties))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.ParagraphProperties))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.Text))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class Field : DocumentFormat.OpenXml.OpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.RunProperties))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.ParagraphProperties))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.Text))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(10, "fld")>]
type Field = class
    inherit OpenXmlCompositeElement
type Field = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr(10, "fld")>]
type Field = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr("a:fld")>]
type Field = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr("a:fld")>]
type Field = class
    inherit TypedOpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.RunProperties))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.ParagraphProperties))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.Text))>]
type Field = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.RunProperties))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.ParagraphProperties))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Drawing.Text))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type Field = class
    inherit OpenXmlCompositeElement
Public Class Field
Inherits OpenXmlCompositeElement
Public Class Field
Inherits TypedOpenXmlCompositeElement
Herança
Herança
Atributos

Comentários

[ISO/IEC 29500-1 1st Edition]

fld (campo de texto)

Esse elemento especifica um campo de texto que contém texto gerado que o aplicativo deve atualizar periodicamente. Cada pedaço de texto, quando gerado, recebe um número de identificação exclusivo que é usado para se referir a um campo específico. No momento da criação, o campo de texto indica o tipo de texto que deve ser usado para atualizar esse campo. Esse tipo de atualização é usado para que todos os aplicativos que não criaram esse campo de texto ainda possam saber com que tipo de texto ele deve ser atualizado. Assim, o novo aplicativo pode anexar um tipo de atualização à ID do campo de texto para atualização contínua.

[Exemplo: considere um slide dentro de uma apresentação que precisa ter o número do slide colocado no slide. O DrawingML a seguir pode ser usado para descrever tal situação.

<p:txBody>  
  <a:bodyPr/>  
    <a:lstStyle/>  
    <a:p>  
      <a:fld id="{424CEEAC-8F67-4238-9622-1B74DC6E8318}" type="slidenum">  
      <a:rPr lang="en-US" smtClean="0"/>  
      <a:pPr/>  
      <a:t>3</a:t>  
    </a:fld>  
    <a:endParaRPr lang="en-US"/>  
  </a:p>  
</p:txBody>  

exemplo de término]

Elementos pai
p (§21.1.2.2.6)
Elementos filho Subcláusula
pPr (Propriedades de Parágrafo de Texto) §21.1.2.2.7
rPr (propriedades de execução de texto) §21.1.2.3.9
t (Cadeia de Texto) §21.1.2.3.11
Atributos Descrição
id (ID do Campo) Especifica o token exclusivo para este documento, host especificado que é usado para identificar o campo. Esse token é gerado quando o campo de texto é criado e persiste no arquivo como o mesmo token até que o campo de texto seja removido. Qualquer aplicativo deve marcar se há tokens conflitantes no documento antes de atribuir um novo token a um campo de texto.

Os valores possíveis para esse atributo são definidos pelo tipo ST_Guid simples (§22.9.2.4).
tipo (Tipo de Campo) Especifica o tipo de texto que deve ser usado para atualizar esse campo de texto. Isso é usado para informar ao aplicativo de renderização qual texto ele deve usar para atualizar esse campo de texto. Não há restrições de sintaxe específicas colocadas neste atributo. O aplicativo gerador pode usá-lo para representar qualquer texto que deve ser atualizado antes de renderizar a apresentação.

Valores reservados:

Valor

Descrição

SlideNum

Número do slide da apresentação

datetime

Formato de data e hora padrão para o aplicativo de renderização

datetime1

Formato de data e hora MM/DD/AAAA [Exemplo:fim,exemplo]

datetime2

Formato de data e hora Dia, Mês DD, AAAA [Exemplo: sexta-feira, exemplo de término]

datetime3

DD Mês AAAA formato de data e hora [Exemplo: exemplo final de 12 de outubro de 2007]

datetime4

Mês DD, AAAAA formato de data e hora [Exemplo:término, exemplo]

datetime5

Formato de data e hora DD-Mon-YY [Exemplo:exemplo de fim de 12 de outubro de 07]

datetime6

Formato de data e hora do mês YY [Exemplo:exemplo final de 07 de outubro]

datetime7

Formato de data e hora Seg-YY [Exemplo:exemplo de fim de 07 de outubro]

datetime8

DD/MM/AAAA hh:mm Formato de data e hora AM/PM [Exemplo:exemplo final]

datetime9

DD/MM/AAAA hh:mm:ss Formato de data e hora AM/PM [Exemplo: exemplo de término de 16:28:34]

datetime10

hh:mm formato de data e hora [Exemplo: 16:28 fim do exemplo]

datetime11

hh:mm:ss formato de data e hora [Exemplo: 16:28:34 fim do exemplo]

datetime12

hh:mm AM/PM formato de data e hora [Exemplo:fim exemplo]

datetime13

hh:mm:ss: formato de data e hora AM/PM [Exemplo: exemplo de término de 16:28:34]

Os valores possíveis para esse atributo são definidos pelo tipo de dados de cadeia de caracteres do esquema XML do W3C.

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

ISO/IEC29500: 2008.

Construtores

Nome Description
Field()

Inicializa uma nova instância da classe Field.

Field(IEnumerable<OpenXmlElement>)

Inicializa uma nova instância da classe Field com os elementos filho especificados.

Field(OpenXmlElement[])

Inicializa uma nova instância da classe Field com os elementos filho especificados.

Field(String)

Inicializa uma nova instância da classe Field 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)
Id

ID do Campo

Representa o seguinte atributo no esquema: id

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

Campo de Texto.

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

Quando o objeto é serializado como xml, seu nome qualificado é a:fld.

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)
ParagraphProperties

Propriedades de parágrafo de texto.

Representa a seguinte marca de elemento no esquema: a:pPr.

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)
RunProperties

Propriedades de caractere de texto.

Representa a seguinte marca de elemento no esquema: a:rPr.

Text

Texto.

Representa a seguinte marca de elemento no esquema: a:t.

Type

Tipo de Campo

Representa o seguinte atributo no esquema: tipo

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()

Campo de Texto.

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

Quando o objeto é serializado como xml, seu nome qualificado é a:fld.

(Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()

Retorna um enumerador que itera por meio da coleção filho.

(Herdado de OpenXmlElement)

Aplica-se a