Hantera dokumentegenskaper

Introduktion

Microsoft Excel ger möjlighet att lägga till egenskaper till kalkylarksfiler. Dessa dokumentegenskaper ger användbar information och är indelade i två kategorier enligt beskrivningen nedan.

• Systemdefinierade (inbyggda) egenskaper: Inbyggda egenskaper innehåller allmän information om dokumentet som dokumenttitel, författarens namn, dokumentstatistik och så vidare.
• Användardefinierade (anpassade) egenskaper: Anpassade egenskaper definierade av slutanvändaren i form av namn-värdepar.

Den viktigaste punkten att veta om inbyggda och anpassade egenskaper är att inbyggda egenskaper kan nås och ändras, men inte kan skapas eller tas bort, men anpassade dokumentegenskaper kan skapas och hanteras.

Hantera dokumentegenskaper med Microsoft Excel

Microsoft Excel tillåter hantering av dokumentegenskaper för Excel-filer på ett WYSIWYG-sätt. Följ stegen nedan för att öppnaEgenskaper dialogrutan i Excel 2016.

1. FrånFil menyn, väljInfo.

Välj infomeny

1. Klicka påEgenskaperrubrik och välj “Avancerade egenskaper”.

Klicka på Avancerat val av egenskaper

1. Hantera filens dokumentegenskaper.

Egenskapsdialog
I dialogrutan Egenskaper finns det olika flikar, som Allmänt, Sammanfattning, Statistik, Innehåll och Tull. Varje flik hjälper till att konfigurera olika typer av information relaterad till filen. Fliken Anpassad används för att hantera anpassade egenskaper.

Arbeta med dokumentegenskaper med Aspose.Cells

Utvecklare kan hantera dokumentegenskaperna dynamiskt med hjälp av Aspose.Cells API:er. Den här funktionen hjälper utvecklarna att lagra användbar information tillsammans med filen, som när filen togs emot, bearbetades, tidsstämplad och så vidare.

Aspose.Cells for Java skriver direkt informationen om API och versionsnummer i utdatadokument. Till exempel, när dokument återges till PDF, fylls Aspose.Cells for Java iAnsökan fält med värdet ‘Aspose.Cells’ ochPDF Producent fält med värdet, t.ex. ‘Aspose.Cells for Java v17.9’.

Observera att du inte kan instruera Aspose.Cells for Java att ändra eller ta bort denna information från utdatadokument.

Åtkomst till dokumentegenskaper

Aspose.Cells API:er stöder båda typerna av dokumentegenskaper, inbyggda och anpassade. Aspose.Cells'Arbetsbok klass representerar en Excel-fil och, liksom en Excel-fil, denArbetsbok klass kan innehålla flera kalkylblad, var och en representerad avArbetsblad klass medan samlingen av kalkylblad representeras avArbetsbladssamlingklass.

AnvändArbetsbladssamlingför att komma åt filens dokumentegenskaper enligt beskrivningen nedan.

• För att komma åt inbyggda dokumentegenskaper, användWorksheetCollection.BuiltInDocumentProperties.
• För att komma åt anpassade dokumentegenskaper, användWorksheetCollection.CustomDocumentProperties.

BådeWorksheetCollection.BuiltInDocumentProperties ochWorksheetCollection.CustomDocumentProperties returnera en instans avDocumentPropertyCollection . Denna samling innehållerDocumentPropertyobjekt, som vart och ett representerar en enskild inbyggd eller anpassad dokumentegenskap.

Det är upp till applikationskravet hur man kommer åt en fastighet, det vill säga; genom att använda index eller namn på fastigheten frånDocumentPropertyCollectionsom visas i exemplet nedan.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xls");
 
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Accessing a custom document property by using the property name
DocumentProperty customProperty1 = customProperties.get("ContentTypeId");
 
System.out.println(customProperty1.getName() + " " + customProperty1.getValue());
 
// Accessing a custom document property by using the property index
DocumentProperty customProperty2 = customProperties.get(0);
 
System.out.println(customProperty2.getName() + " " + customProperty2.getValue());

DeDocumentPropertyklass tillåter att hämta namn, värde och typ av dokumentegenskapen:

• För att få fastighetsnamnet, användDocumentProperty.Name.
• För att få fastighetsvärdet, användDocumentProperty.Value. DocumentProperty.Valuereturnerar värdet som ett objekt.
• För att få egenskapstypen, användDocumentProperty.Type . Detta returnerar en avPropertyTypeuppräkningsvärden.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xls");
 
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Accessing a custom document property
DocumentProperty customProperty1 = customProperties.get(0);
 
// Storing the value of the document property as an object
Object objectValue = customProperty1.getValue();
 
// Accessing a custom document property
DocumentProperty customProperty2 = customProperties.get(1);
 
// Checking the type of the document property and then storing the value of the
// document property according to that type
if (customProperty2.getType() == PropertyType.STRING)
{
  String value = customProperty2.getValue().toString();
}

Lägga till eller ta bort anpassade dokumentegenskaper

Som vi har beskrivit tidigare i början av detta ämne kan utvecklare inte lägga till eller ta bort inbyggda egenskaper eftersom dessa egenskaper är systemdefinierade men det är möjligt att lägga till eller ta bort anpassade egenskaper eftersom dessa är användardefinierade.

Lägga till anpassade egenskaper

Aspose.Cells API:er har avslöjatLägg till metod förCustomDocumentPropertyCollection klass för att lägga till anpassade egenskaper till samlingen. DeLägg till-metoden lägger till egenskapen i Excel-filen och returnerar en referens för den nya dokumentegenskapen som enDocumentPropertyobjekt.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
 
// Retrieve a list of all custom document properties of the Excel file
CustomDocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Adding a custom document property to the Excel file
DocumentProperty publisher = customProperties.add("Publisher", "Aspose");

Konfigurera “Länk till innehåll” anpassad egendom

För att skapa en anpassad egenskap kopplad till innehållet i ett givet intervall, anropaCustomDocumentPropertyCollection.addLinkToContent metod och passegenskapens namn och källa. Du kan kontrollera om en egenskap är konfigurerad som länkad till innehåll med hjälp avDocumentProperty.isLinkedToContent fast egendom. Dessutom är det också möjligt att få källomfånget med hjälp avKälla egendom avDocumentPropertyklass.

Vi använder en enkel mall Microsoft Excel-fil i exemplet. Arbetsboken har ett definierat namngivet intervall märktMyRange som hänvisar till ett cellvärde.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
 
// Retrieve a list of all custom document properties of the Excel file
CustomDocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Add link to content.
customProperties.addLinkToContent("Owner", "MyRange");
 
// Accessing the custom document property by using the property name
DocumentProperty customProperty1 = customProperties.get("Owner");
 
// Check whether the property is lined to content
Boolean islinkedtocontent = customProperty1.isLinkedToContent();
 
// Get the source for the property
String source = customProperty1.getSource();

Ta bort anpassade egenskaper

För att ta bort anpassade egenskaper med Aspose.Cells, ringDocumentPropertyCollection.remove och skicka namnet på dokumentegenskapen som ska tas bort.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
 
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Removing a custom document property
customProperties.remove("Publisher");