--- title: "Trabalhar com propriedades do documento em Java" --- As propriedades do documento permitem armazenar algumas informações úteis sobre o documento. Essas propriedades podem ser divididas em dois grupos: * Sistema ou built-in que contêm valores como título do documento, nome do autor, estatísticas do documento e outros. * Definido pelo utilizador ou personalizado, fornecido como pares nome-valor em que o utilizador pode definir o nome e o valor. É útil saber que as informações sobre API e o número da versão são gravadas diretamente nos documentos de saída. Por exemplo, ao converter um documento para PDF, Aspose.Words preenche o campo "aplicação" com "Aspose.Words" e o campo "PDF produtor" com "Aspose.Words para Java YY.M. N", em que *YY.M.N* é a versão de Aspose.Words utilizada para a conversão. Para mais detalhes, ver [Nome do gerador ou do produtor incluu nos documentos de sa](/words/pt/java/generator-or-producer-name-included-in-output-documents/). ``` Observe que você **cannot direct** Aspose.Words Para alterar ou remover essas informações dos documentos de saída. ``` ## Aceder Às Propriedades Do Documento Para aceder às propriedades do documento em Aspose.Words utilize: * [BuiltInDocumentProperties](https://reference.aspose.com/words/java/com.aspose.words/document/#getBuiltInDocumentProperties) para obter propriedades internas. * [CustomDocumentProperties](https://reference.aspose.com/words/java/com.aspose.words/document/#getCustomDocumentProperties) para obter propriedades personalizadas. **BuiltInDocumentProperties** **BuiltInDocumentProperties** A classe [DocumentProperty](https://reference.aspose.com/words/java/com.aspose.words/documentproperty/) permite obter o nome, o valor e o tipo de uma propriedade document. [Valor]https://reference.aspose.com/words/java/com.aspose.words/documentproperty#Value) retorna um objeto, mas há um conjunto de métodos que permitem que você obtenha o valor da propriedade convertido em um tipo específico. Depois de saber que tipo é a propriedade, você pode usar um dos métodos **DocumentProperty.ToXXX**, como **DocumentProperty.** [ToString](https://reference.aspose.com/words/java/com.aspose.words/documentproperty/#toString) e **DocumentProperty.**[ToInt](https://reference.aspose.com/words/java/com.aspose.words/documentproperty/#toInt), para obter o valor do tipo apropriado. O exemplo de código a seguir mostra como enumerar todas as propriedades internas e personalizadas em um documento: {{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-document-DocProperties-EnumerateProperties.java" >}} ``` Você pode baixar o arquivo de modelo deste exemplo em [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-Java/blob/master/Examples/Data/Properties.docx). ``` Em Microsoft Word, pode aceder às propriedades do documento através do menu "Ficheiro Propriedades". ![work-with-document-properties-aspose-words-java.png](/words/java/work-with-document-properties/work-with-document-properties-1.png) ## Adicionar ou remover propriedades do documento Não é possível adicionar ou remover propriedades de Documento integradas utilizando Aspose.Words. Você só pode alterar ou atualizar seus valores. Para adicionar propriedades de Documento personalizadas com Aspose.Words, use o método [Add](https://reference.aspose.com/words/java/com.aspose.words/customdocumentproperties/#add-java.lang.String-boolean), passando o novo nome da propriedade e o valor do tipo apropriado. O método retorna o objeto **DocumentProperty** recém-criado. Para remover propriedades personalizadas, use o método [Remove](https://reference.aspose.com/words/java/com.aspose.words/customdocumentproperties/#remove-java.lang.String), passando o nome da propriedade para remover ou o método [RemoveAt](https://reference.aspose.com/words/java/com.aspose.words/customdocumentproperties/#removeAt-int) Para remover a propriedade por índice. Você também pode remover todas as propriedades usando o método [Clear](https://reference.aspose.com/words/java/com.aspose.words/customdocumentproperties/#clear). O exemplo de código a seguir verifica se uma propriedade personalizada com um determinado nome existe em um documento e adiciona mais algumas propriedades de Documento personalizadas: {{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-document-DocProperties-CustomAdd.java" >}} ``` Você pode baixar o arquivo de modelo deste exemplo em [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-Java/blob/master/Examples/Data/Properties.docx). ``` O exemplo de código a seguir mostra como remover uma propriedade de Documento personalizada: {{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-document-DocProperties-CustomRemove.java" >}} ## Actualizar As Propriedades Integradas Do Documento Aspose.Words não atualiza automaticamente as propriedades do documento, como Microsoft Word faz com algumas propriedades, mas fornece um método para atualizar algumas propriedades estatísticas internas do documento. Chame o método [UpdateWordCount](https://reference.aspose.com/words/java/com.aspose.words/document/#updateWordCount) para recalcular e atualizar as seguintes propriedades: * [Characters](https://reference.aspose.com/words/java/com.aspose.words/builtindocumentproperties#Characters) * [CharactersWithSpaces](https://reference.aspose.com/words/java/com.aspose.words/builtindocumentproperties#CharactersWithSpaces) * [Words](https://reference.aspose.com/words/java/com.aspose.words/builtindocumentproperties#Words) * [Paragraphs](https://reference.aspose.com/words/java/com.aspose.words/builtindocumentproperties#Paragraphs) * [Lines](https://reference.aspose.com/words/java/com.aspose.words/builtindocumentproperties#Lines) ## Criar uma nova propriedade personalizada vinculada ao conteúdo Aspose.Words fornece o método [AddLinkToContent](https://reference.aspose.com/words/java/com.aspose.words/customdocumentproperties/#addLinkToContent-java.lang.String-java.lang.String) para criar uma nova propriedade de Documento personalizada vinculada ao conteúdo. Esta propriedade retorna o objeto de propriedade recém-criado ou null se [LinkSource](https://reference.aspose.com/words/java/com.aspose.words/documentproperty/#isLinkToContent) For inválido. O exemplo de código a seguir mostra como configurar um link para uma propriedade personalizada: {{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-document-DocProperties-ConfiguringLinkToContent.java" >}} ## Obter Variáveis Do Documento Você pode obter uma coleção de variáveis de documento usando a propriedade [Variables](https://reference.aspose.com/words/java/com.aspose.words/document/#getVariables). Os nomes e valores das variáveis são strings. O exemplo de código a seguir mostra como enumerar variáveis de Documento: {{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-document-GetDocumentVariables-GetDocumentVariables.java" >}} ``` Você pode baixar o arquivo de modelo deste exemplo em [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-Java/blob/master/Examples/Data/Properties.docx). ``` ## Remover informações pessoais do documento Se pretender partilhar um documento do Word com outras pessoas, pode querer remover informações pessoais, como o nome do autor e a empresa. Para fazer isso, use a propriedade [RemovePersonalInformation](https://reference.aspose.com/words/java/com.aspose.words/document/#getRemovePersonalInformation) para definir o sinalizador indicando que Microsoft Word removerá todas as informações do usuário dos comentários, revisões e propriedades do documento ao salvar o documento. ``` A definição desta opção não remove, de facto, as informações pessoais durante o processamento de um documento em Aspose.Words e afecta apenas o comportamento Microsoft Word. ```