java.lang.Objectcom.aspose.words.DocumentPropertyCollection
public abstract class DocumentPropertyCollection
The names of the properties are case-insensitive. The properties in the collection are sorted alphabetically by name. Example:
Document doc = new Document();
CustomDocumentProperties properties = doc.getCustomDocumentProperties();
// The custom property collection will be empty by default
Assert.assertEquals(0, properties.getCount());
// We can populate it with key/value pairs with a variety of value types
properties.add("Authorized", true);
properties.add("Authorized By", "John Doe");
properties.add("Authorized Date", new Date());
properties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber());
properties.add("Authorized Amount", 123.45);
// Custom properties are automatically sorted in alphabetic order
Assert.assertEquals(properties.indexOf("Authorized Amount"), 1);
Assert.assertEquals(properties.getCount(), 5);
// Enumerate and print all custom properties
Iterator<DocumentProperty> enumerator = properties.iterator();
try {
while (enumerator.hasNext()) {
DocumentProperty property = enumerator.next();
System.out.println(MessageFormat.format("Name: \"{0}\", Type: \"{1}\", Value: \"{2}\"", property.getName(), property.getType(), property.getValue()));
}
} finally {
if (enumerator != null) enumerator.remove();
}
// We can view/edit custom properties by opening the document and looking in File > Properties > Advanced Properties > Custom
doc.save(getArtifactsDir() + "Properties.DocumentPropertyCollection.docx");
// We can remove elements from the property collection by index or by name
properties.removeAt(1);
Assert.assertFalse(properties.contains("Authorized Amount"));
Assert.assertEquals(properties.getCount(), 4);
properties.remove("Authorized Revision");
Assert.assertFalse(properties.contains("Authorized Revision"));
Assert.assertEquals(properties.getCount(), 3);
// We can also empty the entire custom property collection at once
properties.clear();
Assert.assertEquals(properties.getCount(), 0);
Property Getters/Setters Summary | ||
---|---|---|
int | getCount() | |
Gets number of items in the collection. | ||
DocumentProperty | get(int index) | |
Returns a |
||
DocumentProperty | get(java.lang.String name) | |
Returns a |
Method Summary | ||
---|---|---|
void | clear() | |
Removes all properties from the collection. | ||
boolean | contains(java.lang.String name) | |
Returns true if a property with the specified name exists in the collection. | ||
int | indexOf(java.lang.String name) | |
Gets the index of a property by name. | ||
java.util.Iterator<DocumentProperty> | iterator() | |
Returns an iterator object that can be used to iterate over all items in the collection. | ||
void | remove(java.lang.String name) | |
Removes a property with the specified name from the collection. | ||
void | removeAt(int index) | |
Removes a property at the specified index. |
Property Getters/Setters Detail |
---|
getCount | |
public int getCount() |
Example:
Shows how to work with custom document properties.Document doc = new Document(getMyDir() + "Properties.docx"); // A document's built in properties contains a set of predetermined keys // with values such as the author's name or document's word count // We can add our own keys and values to a custom properties collection also // Before we add a custom property, we need to make sure that one with the same name doesn't already exist Assert.assertEquals("Value of custom document property", doc.getCustomDocumentProperties().get("CustomProperty").toString()); doc.getCustomDocumentProperties().add("CustomProperty2", "Value of custom document property #2"); // Iterate over all the custom document properties System.out.println("Custom Properties:"); for (DocumentProperty customDocumentProperty : (Iterable<DocumentProperty>) doc.getCustomDocumentProperties()) { System.out.println(customDocumentProperty.getName()); System.out.println("\tType:\t{customDocumentProperty.Type}"); System.out.println("\tValue:\t\"{customDocumentProperty.Value}\""); }
get | |
public DocumentProperty get(int index) |
Note: In Java this method is slow because iterates over all nodes.
index
- Zero-based index of the Example:
Shows how to work with custom document properties.Document doc = new Document(getMyDir() + "Properties.docx"); // A document's built in properties contains a set of predetermined keys // with values such as the author's name or document's word count // We can add our own keys and values to a custom properties collection also // Before we add a custom property, we need to make sure that one with the same name doesn't already exist Assert.assertEquals("Value of custom document property", doc.getCustomDocumentProperties().get("CustomProperty").toString()); doc.getCustomDocumentProperties().add("CustomProperty2", "Value of custom document property #2"); // Iterate over all the custom document properties System.out.println("Custom Properties:"); for (DocumentProperty customDocumentProperty : (Iterable<DocumentProperty>) doc.getCustomDocumentProperties()) { System.out.println(customDocumentProperty.getName()); System.out.println("\tType:\t{customDocumentProperty.Type}"); System.out.println("\tValue:\t\"{customDocumentProperty.Value}\""); }
get | |
public DocumentProperty get(java.lang.String name) |
Returns null if a property with the specified name is not found.
name
- The case-insensitive name of the property to retrieve.Example:
Shows how to create a custom document property with the value of a date and time.Document doc = new Document(); doc.getCustomDocumentProperties().add("AuthorizedDate", new Date()); System.out.println("Document authorized on {doc.CustomDocumentProperties[");
Method Detail |
---|
clear | |
public void clear() |
Example:
Shows how to add custom properties to a document.Document doc = new Document(); CustomDocumentProperties properties = doc.getCustomDocumentProperties(); // The custom property collection will be empty by default Assert.assertEquals(0, properties.getCount()); // We can populate it with key/value pairs with a variety of value types properties.add("Authorized", true); properties.add("Authorized By", "John Doe"); properties.add("Authorized Date", new Date()); properties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber()); properties.add("Authorized Amount", 123.45); // Custom properties are automatically sorted in alphabetic order Assert.assertEquals(properties.indexOf("Authorized Amount"), 1); Assert.assertEquals(properties.getCount(), 5); // Enumerate and print all custom properties Iterator<DocumentProperty> enumerator = properties.iterator(); try { while (enumerator.hasNext()) { DocumentProperty property = enumerator.next(); System.out.println(MessageFormat.format("Name: \"{0}\", Type: \"{1}\", Value: \"{2}\"", property.getName(), property.getType(), property.getValue())); } } finally { if (enumerator != null) enumerator.remove(); } // We can view/edit custom properties by opening the document and looking in File > Properties > Advanced Properties > Custom doc.save(getArtifactsDir() + "Properties.DocumentPropertyCollection.docx"); // We can remove elements from the property collection by index or by name properties.removeAt(1); Assert.assertFalse(properties.contains("Authorized Amount")); Assert.assertEquals(properties.getCount(), 4); properties.remove("Authorized Revision"); Assert.assertFalse(properties.contains("Authorized Revision")); Assert.assertEquals(properties.getCount(), 3); // We can also empty the entire custom property collection at once properties.clear(); Assert.assertEquals(properties.getCount(), 0);
contains | |
public boolean contains(java.lang.String name) |
name
- The case-insensitive name of the property.Example:
Shows how to add custom properties to a document.Document doc = new Document(); CustomDocumentProperties properties = doc.getCustomDocumentProperties(); // The custom property collection will be empty by default Assert.assertEquals(0, properties.getCount()); // We can populate it with key/value pairs with a variety of value types properties.add("Authorized", true); properties.add("Authorized By", "John Doe"); properties.add("Authorized Date", new Date()); properties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber()); properties.add("Authorized Amount", 123.45); // Custom properties are automatically sorted in alphabetic order Assert.assertEquals(properties.indexOf("Authorized Amount"), 1); Assert.assertEquals(properties.getCount(), 5); // Enumerate and print all custom properties Iterator<DocumentProperty> enumerator = properties.iterator(); try { while (enumerator.hasNext()) { DocumentProperty property = enumerator.next(); System.out.println(MessageFormat.format("Name: \"{0}\", Type: \"{1}\", Value: \"{2}\"", property.getName(), property.getType(), property.getValue())); } } finally { if (enumerator != null) enumerator.remove(); } // We can view/edit custom properties by opening the document and looking in File > Properties > Advanced Properties > Custom doc.save(getArtifactsDir() + "Properties.DocumentPropertyCollection.docx"); // We can remove elements from the property collection by index or by name properties.removeAt(1); Assert.assertFalse(properties.contains("Authorized Amount")); Assert.assertEquals(properties.getCount(), 4); properties.remove("Authorized Revision"); Assert.assertFalse(properties.contains("Authorized Revision")); Assert.assertEquals(properties.getCount(), 3); // We can also empty the entire custom property collection at once properties.clear(); Assert.assertEquals(properties.getCount(), 0);
indexOf | |
public int indexOf(java.lang.String name) |
Note: In Java this method is slow because iterates over all nodes.
name
- The case-insensitive name of the property.Example:
Shows how to add custom properties to a document.Document doc = new Document(); CustomDocumentProperties properties = doc.getCustomDocumentProperties(); // The custom property collection will be empty by default Assert.assertEquals(0, properties.getCount()); // We can populate it with key/value pairs with a variety of value types properties.add("Authorized", true); properties.add("Authorized By", "John Doe"); properties.add("Authorized Date", new Date()); properties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber()); properties.add("Authorized Amount", 123.45); // Custom properties are automatically sorted in alphabetic order Assert.assertEquals(properties.indexOf("Authorized Amount"), 1); Assert.assertEquals(properties.getCount(), 5); // Enumerate and print all custom properties Iterator<DocumentProperty> enumerator = properties.iterator(); try { while (enumerator.hasNext()) { DocumentProperty property = enumerator.next(); System.out.println(MessageFormat.format("Name: \"{0}\", Type: \"{1}\", Value: \"{2}\"", property.getName(), property.getType(), property.getValue())); } } finally { if (enumerator != null) enumerator.remove(); } // We can view/edit custom properties by opening the document and looking in File > Properties > Advanced Properties > Custom doc.save(getArtifactsDir() + "Properties.DocumentPropertyCollection.docx"); // We can remove elements from the property collection by index or by name properties.removeAt(1); Assert.assertFalse(properties.contains("Authorized Amount")); Assert.assertEquals(properties.getCount(), 4); properties.remove("Authorized Revision"); Assert.assertFalse(properties.contains("Authorized Revision")); Assert.assertEquals(properties.getCount(), 3); // We can also empty the entire custom property collection at once properties.clear(); Assert.assertEquals(properties.getCount(), 0);
iterator | |
public java.util.Iterator<DocumentProperty> iterator() |
Example:
Shows how to add custom properties to a document.Document doc = new Document(); CustomDocumentProperties properties = doc.getCustomDocumentProperties(); // The custom property collection will be empty by default Assert.assertEquals(0, properties.getCount()); // We can populate it with key/value pairs with a variety of value types properties.add("Authorized", true); properties.add("Authorized By", "John Doe"); properties.add("Authorized Date", new Date()); properties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber()); properties.add("Authorized Amount", 123.45); // Custom properties are automatically sorted in alphabetic order Assert.assertEquals(properties.indexOf("Authorized Amount"), 1); Assert.assertEquals(properties.getCount(), 5); // Enumerate and print all custom properties Iterator<DocumentProperty> enumerator = properties.iterator(); try { while (enumerator.hasNext()) { DocumentProperty property = enumerator.next(); System.out.println(MessageFormat.format("Name: \"{0}\", Type: \"{1}\", Value: \"{2}\"", property.getName(), property.getType(), property.getValue())); } } finally { if (enumerator != null) enumerator.remove(); } // We can view/edit custom properties by opening the document and looking in File > Properties > Advanced Properties > Custom doc.save(getArtifactsDir() + "Properties.DocumentPropertyCollection.docx"); // We can remove elements from the property collection by index or by name properties.removeAt(1); Assert.assertFalse(properties.contains("Authorized Amount")); Assert.assertEquals(properties.getCount(), 4); properties.remove("Authorized Revision"); Assert.assertFalse(properties.contains("Authorized Revision")); Assert.assertEquals(properties.getCount(), 3); // We can also empty the entire custom property collection at once properties.clear(); Assert.assertEquals(properties.getCount(), 0);
remove | |
public void remove(java.lang.String name) |
name
- The case-insensitive name of the property.Example:
Shows how to add custom properties to a document.Document doc = new Document(); CustomDocumentProperties properties = doc.getCustomDocumentProperties(); // The custom property collection will be empty by default Assert.assertEquals(0, properties.getCount()); // We can populate it with key/value pairs with a variety of value types properties.add("Authorized", true); properties.add("Authorized By", "John Doe"); properties.add("Authorized Date", new Date()); properties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber()); properties.add("Authorized Amount", 123.45); // Custom properties are automatically sorted in alphabetic order Assert.assertEquals(properties.indexOf("Authorized Amount"), 1); Assert.assertEquals(properties.getCount(), 5); // Enumerate and print all custom properties Iterator<DocumentProperty> enumerator = properties.iterator(); try { while (enumerator.hasNext()) { DocumentProperty property = enumerator.next(); System.out.println(MessageFormat.format("Name: \"{0}\", Type: \"{1}\", Value: \"{2}\"", property.getName(), property.getType(), property.getValue())); } } finally { if (enumerator != null) enumerator.remove(); } // We can view/edit custom properties by opening the document and looking in File > Properties > Advanced Properties > Custom doc.save(getArtifactsDir() + "Properties.DocumentPropertyCollection.docx"); // We can remove elements from the property collection by index or by name properties.removeAt(1); Assert.assertFalse(properties.contains("Authorized Amount")); Assert.assertEquals(properties.getCount(), 4); properties.remove("Authorized Revision"); Assert.assertFalse(properties.contains("Authorized Revision")); Assert.assertEquals(properties.getCount(), 3); // We can also empty the entire custom property collection at once properties.clear(); Assert.assertEquals(properties.getCount(), 0);
removeAt | |
public void removeAt(int index) |
Note: In Java this method is slow because iterates over all nodes.
index
- The zero based index.Example:
Shows how to add custom properties to a document.Document doc = new Document(); CustomDocumentProperties properties = doc.getCustomDocumentProperties(); // The custom property collection will be empty by default Assert.assertEquals(0, properties.getCount()); // We can populate it with key/value pairs with a variety of value types properties.add("Authorized", true); properties.add("Authorized By", "John Doe"); properties.add("Authorized Date", new Date()); properties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber()); properties.add("Authorized Amount", 123.45); // Custom properties are automatically sorted in alphabetic order Assert.assertEquals(properties.indexOf("Authorized Amount"), 1); Assert.assertEquals(properties.getCount(), 5); // Enumerate and print all custom properties Iterator<DocumentProperty> enumerator = properties.iterator(); try { while (enumerator.hasNext()) { DocumentProperty property = enumerator.next(); System.out.println(MessageFormat.format("Name: \"{0}\", Type: \"{1}\", Value: \"{2}\"", property.getName(), property.getType(), property.getValue())); } } finally { if (enumerator != null) enumerator.remove(); } // We can view/edit custom properties by opening the document and looking in File > Properties > Advanced Properties > Custom doc.save(getArtifactsDir() + "Properties.DocumentPropertyCollection.docx"); // We can remove elements from the property collection by index or by name properties.removeAt(1); Assert.assertFalse(properties.contains("Authorized Amount")); Assert.assertEquals(properties.getCount(), 4); properties.remove("Authorized Revision"); Assert.assertFalse(properties.contains("Authorized Revision")); Assert.assertEquals(properties.getCount(), 3); // We can also empty the entire custom property collection at once properties.clear(); Assert.assertEquals(properties.getCount(), 0);