Met documenteigenschappen werken

Documenteigenschappen kunnen nuttige informatie over uw document opslaan. Deze eigenschappen kunnen in twee groepen worden onderverdeeld:

• Systeem of ingebouwde die waarden bevatten zoals document titel, auteur naam, document statistieken, en anderen.
• Gebruiker-gedefinieerd of aangepast, verstrekt als naam-waarde paren waar de gebruiker zowel de naam als de waarde kan definiëren.

Het is nuttig om te weten dat informatie over API en versienummer wordt direct naar uitvoerdocumenten geschreven. Bijvoorbeeld, bij het omzetten van een document naar PDF, Aspose.Words vult het veld “Toepassing” in met “Aspose.Words”, en het “PDF Producer” veld met “Aspose.Words voor Java YY.M.N,” waar YY.M.N is de versie van Aspose.Words gebruikt voor conversie. Voor meer details, zie Generator van producntnaam opgenomen in uitvoerdocumenten.

Merk op dat u kan niet sturen Aspose.Words deze informatie uit uitvoerdocumenten te wijzigen of te verwijderen.

Toegangs-documenteigenschappen

Toegang tot document eigenschappen in Aspose.Words gebruik:

• BuiltInDocumentProperties om ingebouwde eigenschappen te verkrijgen.

• CustomDocumentProperties om aangepaste eigenschappen te verkrijgen.

BuiltInDocumentProperties en CustomDocumentProperties zijn collecties van DocumentProperty objecten. Deze objecten kunnen worden verkregen via de indexer eigenschap door naam of index.

BuiltInDocumentProperties biedt bovendien toegang tot documenteneigenschappen door middel van een reeks ingevoerde eigenschappen die terugkeerwaarden van het juiste type. CustomDocumentProperties stelt u in staat om documenteigenschappen toe te voegen of te verwijderen uit een document.

De DocumentProperty klasse kunt u de naam, waarde en het type van een document-eigenschap te krijgen. [Value]https://reference.aspone.com/words/java/com.aspone.words/documentproperty#Value) geeft een object terug, maar er is een blik methode waarin u de waarde van de eigenschap kunt omzetten naar een specifiek type. Nadat u krijgt om te weten welk type de woning is, kunt u gebruik maken van een van de {0} methoden, zoals {1}ToString en DocumentProperty.ToInt, de waarde van het passende type te verkrijgen.

Het volgende voorbeeld van code laat zien hoe u alle ingebouwde en aangepaste eigenschappen in een document opsomt:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
String fileName = dataDir + "Properties.doc";
Document doc = new Document(fileName);

System.out.println("1. Document name: " + fileName);

System.out.println("2. Built-in Properties");
for (DocumentProperty prop : doc.getBuiltInDocumentProperties())
	System.out.println(prop.getName() + " : " + prop.getValue());

System.out.println("3. Custom Properties");
for (DocumentProperty prop : doc.getCustomDocumentProperties())
	System.out.println(prop.getName() + " : " + prop.getValue());

U kunt het sjabloonbestand van dit voorbeeld downloaden van Aspose.Words GitHub.

In Microsoft Word, u kunt toegang krijgen tot documenten met behulp van het menu “Bestand” → Eigenschappen.

Documenteigenschappen toevoegen of verwijderen

U kunt geen ingebouwde documenteigenschappen toevoegen of verwijderen met behulp van Aspose.Words. U kunt alleen hun waarden wijzigen of bijwerken.

Aangepaste documenteigenschappen toevoegen met Aspose.Words, gebruik Add methode, waarbij de nieuwe eigendomsnaam en de waarde van het passende type worden vermeld. De methode geeft de nieuw aangemaakte DocumentProperty object.

Om aangepaste eigenschappen te verwijderen, gebruik de Remove methode, het doorgeven van de eigenschap naam te verwijderen, of de RemoveAt methode om de eigenschap per index te verwijderen. U kunt ook alle eigenschappen verwijderen met behulp van de Clear methode.

De volgende codevoorbeeld controleert of een aangepaste eigenschap met een bepaalde naam bestaat in een document en voegt een paar meer aangepaste document eigenschappen:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "Properties.doc");

CustomDocumentProperties props = doc.getCustomDocumentProperties();

if (props.get("Authorized") == null) {
	props.add("Authorized", true);
	props.add("Authorized By", "John Smith");
	props.add("Authorized Date", new Date());
	props.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber());
	props.add("Authorized Amount", 123.45);
}

U kunt het sjabloonbestand van dit voorbeeld downloaden van Aspose.Words GitHub.

Het volgende voorbeeld van code laat zien hoe een aangepaste documenteigenschap te verwijderen:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "Properties.doc");
doc.getCustomDocumentProperties().remove("Authorized Date");

Ingebouwde documenteigenschappen bijwerken

Aspose.Words niet automatisch document eigenschappen bijwerken, als Microsoft Word doet met een aantal eigenschappen, maar biedt een methode om een aantal statistische ingebouwde document eigenschappen bij te werken. Bel de UpdateWordCount methode om de volgende eigenschappen opnieuw te berekenen en bij te werken:

• Characters
• CharactersWithSpaces
• Words
• Paragraphs
• Lines

Een nieuwe aangepaste eigenschap aanmaken gekoppeld aan inhoud

Aspose.Words levert de AddLinkToContent methode om een nieuwe aangepaste documenteigenschap gekoppeld aan inhoud aan te maken. Deze eigenschap geeft het nieuw aangemaakte object terug of nul als de LinkSource is ongeldig.

Het volgende voorbeeld van code laat zien hoe u een link naar een aangepaste eigenschap kunt configureren:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "test.docx");

// Retrieve a list of all custom document properties from the file.
CustomDocumentProperties customProperties = doc.getCustomDocumentProperties();

// Add linked to content property.
DocumentProperty customProperty = customProperties.addLinkToContent("PropertyName", "BookmarkName");

// Also, accessing the custom document property can be performed by using the
// property name.
customProperty = customProperties.get("PropertyName");

// Check whether the property is linked to content.
boolean isLinkedToContent = customProperty.isLinkToContent();

// Get the source of the property.
String source = customProperty.getLinkSource();

// Get the value of the property.
String value = customProperty.getValue().toString();

Documentvariabelen ophalen

U kunt een verzameling van documentvariabelen met behulp van de Variables eigendom. Variabele namen en waarden zijn strings.

Het volgende voorbeeld van code laat zien hoe je documentvariabelen opsomt:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "Document.doc");

for (java.util.Map.Entry entry : doc.getVariables()) {
	String name = entry.getKey().toString();
	String value = entry.getValue().toString();

	// Do something useful.
	System.out.println("Name: " + name + ", Value: " + value);
}

U kunt het sjabloonbestand van dit voorbeeld downloaden van Aspose.Words GitHub.

Persoonlijke gegevens uit document verwijderen

Als u een Word-document wilt delen met andere mensen, kunt u persoonlijke informatie zoals auteur naam en bedrijf verwijderen. Gebruik hiervoor de RemovePersonalInformation eigenschap om de vlag aan te geven Microsoft Word verwijdert alle gebruikersinformatie uit opmerkingen, herzieningen en document eigenschappen bij het opslaan van het document.

Het instellen van deze optie verwijdert geen persoonlijke informatie tijdens het verwerken van een document in Aspose.Words en heeft alleen invloed op de Microsoft Word Gedrag.