TextProperties Classe

Definição

Namespace:

DocumentFormat.OpenXml.Spreadsheet

Assembly:

DocumentFormat.OpenXml.dll

Pacote:

DocumentFormat.OpenXml v3.0.1

Define a Classe TextProperties.

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

Quando o objeto é serializado como xml, o nome qualificado é x:textPr.

public class TextProperties : DocumentFormat.OpenXml.OpenXmlCompositeElement

type TextProperties = class
    inherit OpenXmlCompositeElement

Public Class TextProperties
Inherits OpenXmlCompositeElement

Herança

Object

OpenXmlElement

OpenXmlCompositeElement

TextProperties

Comentários

[ISO/IEC 29500-1 1st Edition]

textPr (Definições de Importação de Texto)

Este elemento contém todas as definições de importação de texto.

[Exemplo: eis um exemplo do XML para uma ligação de texto:

<connection id="1" name="text data" type="6" refreshedVersion="3" background="1"  saveData="1">  
  <textPr prompt="0" characterSet="437" sourceFile="C:\Desktop\text data.txt"     delimiter="|">  
    <textFields count="5">  
      <textField/>  
      <textField type="text" position="7"/>  
      <textField type="text" position="28"/>  
      <textField position="36"/>  
      <textField type="text" position="41"/>  
    </textFields>  
  </textPr>  
</connection>  

exemplo]

Elementos pai
ligação (}18.13.1)

Elementos filho	Subclautilizar
textFields (Campos)	§18.13.11

Atributos	Descrição
characterSet (Conjunto de Carateres)	Nome do conjunto de carateres associado ao ficheiro de texto. Os valores para este atributo estão restritos aos nomes e aliases listados na listagem CONJUNTOS DE CARATERES DA IANA encontrada em http://www.iana.org/assignments/character-sets. [Nota: ao ler este valor, se um sistema não suportar um conjunto de carateres específico, a aplicação tem permissão para decidir qual é o melhor curso de ação de contingência. nota de fim] Se este atributo não estiver presente, será utilizado o atributo codePage. Os valores possíveis para este atributo são definidos pelo tipo de dados de cadeia de esquema W3C XML.
vírgula (Vírgula é Delimitador)	Sinalizador que indica se deve tratar carateres de vírgula como delimitadores de campo. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
consecutivos (Delimitadores Consecutivos)	Sinalizador que indica se os delimitadores consecutivos devem ser tratados como apenas um delimitador. Se este sinalizador for verdadeiro do que é possível ou mesmo provável que algumas linhas devolvam mais campos do que outras, estes campos preencherão sempre células na folha de cálculo da esquerda para a direita. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
decimal (Separador Decimal)	O caráter separador decimal. Este atributo e os milhares são utilizados apenas quando os dados no ficheiro de texto contêm separadores decimais e de milhares diferentes dos utilizados no computador, devido à utilização de uma definição de idioma diferente. A tabela seguinte mostra os resultados quando importa texto para uma aplicação de folha de cálculo com vários separadores. Os resultados numéricos são exibidos na coluna mais à direita. Separador do sistema decimal Separador de milhares do sistema Valor do separador decimal do ficheiro de texto Valor separador de milhares de ficheiros de texto Texto importado Valor da célula (tipo de dados) Period Ponto Ponto Ponto 123,123.45 123.123,45 (numérico) Ponto Ponto Ponto Ponto 123,123.45 123.123,45 (texto) Ponto Ponto Ponto Ponto 123,123.45 123.123,45 (numérico) Ponto Ponto Ponto Ponto 123 123,45 123 123,45 (texto) Ponto Ponto Ponto Espaço 123 123,45 123.123,45 (numérico) Espera-se que os valores de cadeias deste atributo sejam de um caráter de comprimento. Os valores possíveis para este atributo são definidos pelo ST_Xstring tipo simples (}22.9.2.19).
delimitado (Ficheiro Delimitado)	true se o ficheiro for Separador ou delimitado por carateres. false se o ficheiro deve ser analisado de acordo com os campos de comprimento fixo. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
delimitador (Delimitador Personalizado)	Caráter especificado pelo utilizador para ser tratado como um delimitador de campos. Só são suportados carateres individuais. Os valores possíveis para este atributo são definidos pelo ST_Xstring tipo simples (}22.9.2.19).
fileType (Tipo de Ficheiro)	Atributo ignorável com valor de enumeração definido por ST_FileType. Determina o tipo de conjunto de carateres a utilizar durante a importação. Apenas um de fileType e characterSet ou codePage deve ser especificado para um textPr. Os valores possíveis para este atributo são definidos pelo ST_FileType tipo simples (}18.18.29).
firstRow (Primeira Linha)	Indica em que linha do ficheiro iniciar a importação de dados. Todos os valores unsignedInt são permitidos, embora seja possível que firstRow seja superior ao número de linhas no ficheiro de texto, caso em que não são importados dados. Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt .
prompt (Pedir Nome do Ficheiro)	Sinalizador que indica se o utilizador quer que lhe seja pedido o nome do ficheiro durante a atualização. Se for falso, o utilizador não será solicitado. Se for verdadeiro ou não estiver presente, é pedido ao utilizador. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
qualificador (Qualificador)	Caráter utilizado como qualificador de cadeia de texto. Os valores possíveis para este atributo são definidos pelo ST_Qualifier tipo simples (}18.18.61).
ponto e vírgula (Ponto e vírgula é Delimitador)	Sinalizador que indica se deve tratar carateres de ponto e vírgula como delimitadores de campo. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
sourceFile (Nome do Ficheiro de Origem)	Caminho para o ficheiro de texto a utilizar para importar dados externos. Pode ser expresso na notação de caminho de ficheiro específico do sistema ou no sistema. [Nota: as aplicações podem decidir que formas suportam e se as notações de caminho de ficheiro específicas do sistema são suportadas. nota de fim] Os valores possíveis para este atributo são definidos pelo ST_Xstring tipo simples (}22.9.2.19).
espaço (o espaço é Delimitador)	Sinalizador que indica se deve tratar os carateres de espaço como delimitadores de campo. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
separador (Separador como Delimitador)	Sinalizador que indica se deve tratar carateres de tabulação como delimitadores de campo. Se for falso, os separadores não serão utilizados como delimitadores. Se forem verdadeiros ou não estiverem presentes, serão utilizados como delimitadores. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C.
milhares (Separador de Milhares)	O caráter separador de milhares. Este atributo e o atributo decimal são utilizados apenas quando os dados no ficheiro de texto contêm separadores decimais e de milhares diferentes dos utilizados no computador, devido à utilização de uma definição de idioma diferente. Veja a descrição do atributo decimal acima para obter uma Tabela que descreva o comportamento. Espera-se que os valores de cadeias deste atributo sejam de um caráter de comprimento. 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_TextPr) está localizada em {A.2. nota de fim]

ISO/IEC29500: 2008.

Construtores

TextProperties()	Inicializa uma nova instância da classe TextProperties.
TextProperties(IEnumerable<OpenXmlElement>)	Inicializa uma nova instância da classe TextProperties com os elementos subordinados especificados.
TextProperties(OpenXmlElement[])	Inicializa uma nova instância da classe TextProperties com os elementos subordinados especificados.
TextProperties(String)	Inicializa uma nova instância da classe TextProperties do XML externo.

Propriedades

ChildElements	Obtém todos os nós subordinados do elemento atual. (Herdado de OpenXmlElement)
CodePage	codePage Representa o seguinte atributo no esquema: codePage
Comma	vírgula Representa o seguinte atributo no esquema: vírgula
Consecutive	consecutivos Representa o seguinte atributo no esquema: consecutivo
Decimal	decimal Representa o seguinte atributo no esquema: decimal
Delimited	delimitado Representa o seguinte atributo no esquema: delimitado
Delimiter	delimitador Representa o seguinte atributo no esquema: delimitador
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)
FileType	fileType Representa o seguinte atributo no esquema: fileType
FirstChild	Obtém o primeiro elemento subordinado do elemento OpenXmlElement atual. (Herdado de OpenXmlCompositeElement)
FirstRow	firstRow Representa o seguinte atributo no esquema: firstRow
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 OpenXmlCompositeElement)
InnerText	Obtém ou define os valores concatenados do nó atual e de todos os respetivos subordinados. (Herdado de OpenXmlCompositeElement)
InnerXml	Obtém ou define a marcação que representa apenas os nós subordinados do nó atual. (Herdado de OpenXmlCompositeElement)
LastChild	Obtém o último elemento subordinado do elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir esse elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
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)
Prompt	prompt Representa o seguinte atributo no esquema: prompt
Qualifier	qualificador Representa o seguinte atributo no esquema: qualificador
Semicolon	ponto e vírgula Representa o seguinte atributo no esquema: ponto e vírgula
SourceFile	sourceFile Representa o seguinte atributo no esquema: sourceFile
Space	espaço Representa o seguinte atributo no esquema: espaço
TabAsDelimiter	separador Representa o seguinte atributo no separador esquema:
TextCharacterSet	characterSet Representa o seguinte atributo no esquema: characterSet
TextFields	Campos de Texto. Representa a seguinte etiqueta de elemento no esquema: x:textFields.
Thousands	milhares Representa o seguinte atributo no esquema: milhares
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)
AddChild(OpenXmlElement, Boolean)	Adiciona o elemento especificado ao elemento se for um subordinado conhecido. Esta ação adiciona o elemento na localização correta de acordo com o esquema. (Herdado de OpenXmlCompositeElement)
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 OpenXmlCompositeElement)
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 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 subordinados 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 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 nós subordinados do elemento atual. (Herdado de OpenXmlCompositeElement)
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 OpenXmlCompositeElement)
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. (Herdado de OpenXmlCompositeElement)
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 dos elementos subordinados do elemento atual por outro elemento OpenXmlElement. (Herdado de OpenXmlCompositeElement)
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()	Define a Classe TextProperties. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é x:textPr. (Herdado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement)