Zavedení

Vítejte! Pokud zkoumáte Aspose.Words pro .NET a chcete se naučit, jak do souborů Word přidat vlastní vlastnosti dokumentů, jste na správném místě. Vlastní vlastnosti jsou neocenitelné pro ukládání dalších metadat, která vestavěné vlastnosti nepokrývají. Ať už potřebujete sledovat autorizaci dokumentu, čísla revizí nebo konkrétní data, vlastní vlastnosti vám mohou pomoci. V tomto tutoriálu vás provedeme kroky, jak tyto vlastnosti bezproblémově přidat pomocí Aspose.Words pro .NET. Začněme!

Předpoklady

Než se ponoříte do kódu, ujistěte se, že máte následující:

  1. Knihovna Aspose.Words pro .NET: Stáhněte si ji zde.
  2. Vývojové prostředí: IDE, například Visual Studio.
  3. Základní znalost C#: Znalost C# a .NET bude užitečná.
  4. Ukázkový dokument: Připravte si ukázkový dokument aplikace Word s názvem Properties.docx pro úpravu.

Import jmenných prostorů

Pro přístup k funkcím Aspose.Words budete muset na začátek kódu importovat potřebné jmenné prostory:

using System;
using Aspose.Words;

Krok 1: Nastavení cesty k dokumentu

Dále definujme cestu k vašemu dokumentu Word. Tento krok je nezbytný pro nalezení a otevření vašeho Properties.docx soubor.

// Zadejte cestu k adresáři s vašimi dokumenty.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document(dataDir + "Properties.docx");

Nezapomeňte vyměnit "YOUR DOCUMENT DIRECTORY" se skutečnou cestou k vašemu dokumentu.

Krok 2: Přístup k vlastnostem vlastního dokumentu

Nyní se podívejme na vlastnosti vlastního dokumentu Word, kde budou uložena vaše vlastní metadata.

CustomDocumentProperties customDocumentProperties = doc.CustomDocumentProperties;

Tento řádek vám poskytuje přístup ke kolekci vlastních vlastností, se kterými budete pracovat.

Krok 3: Kontrola existujících vlastností

Před přidáním nových vlastností je vhodné zkontrolovat, zda již nějaká vlastnost existuje, aby se předešlo duplicitě.

if (customDocumentProperties["Authorized"] != null) return;

Tento kód kontroluje, zda již vlastnost „Authorized“ existuje. Pokud ano, metoda se ukončí předčasně, čímž se zabrání duplikátům.

Krok 4: Přidání booleovské vlastnosti

Přidejme vlastní booleovskou vlastnost, která bude označovat, zda je dokument autorizován.

customDocumentProperties.Add("Authorized", true);

Tento řádek přidá vlastnost s názvem „Authorized“ a nastaví její hodnotu na true.

Krok 5: Přidání vlastnosti typu String

Dále specifikujeme, kdo dokument autorizoval, přidáním vlastnosti řetězec.

customDocumentProperties.Add("Authorized By", "John Smith");

Nebojte se nahradit „John Smith“ jakýmkoli jménem, které vám vyhovuje.

Krok 6: Přidání vlastnosti data

Pro sledování, kdy byl dokument autorizován, přidejme vlastnost date.

customDocumentProperties.Add("Authorized Date", DateTime.Today);

Tento řádek přidá vlastnost s názvem „Authorized Date“ a přiřadí jí dnešní datum pomocí DateTime.Today.

Krok 7: Přidání čísla revize

Pro správu verzí můžeme přidat vlastnost pro sledování čísla revize dokumentu.

customDocumentProperties.Add("Authorized Revision", doc.BuiltInDocumentProperties.RevisionNumber);

Zde přidáme vlastnost „Autorizovaná revize“, která obsahuje aktuální číslo revize dokumentu.

Krok 8: Přidání číselné vlastnosti

Nakonec přidejme číselnou vlastnost pro uložení autorizované částky, například rozpočtové částky.

customDocumentProperties.Add("Authorized Amount", 123.45);

Tento řádek přidá vlastnost s názvem „Authorized Amount“ s hodnotou 123.45Toto číslo můžete dle potřeby upravit.

Závěr

Gratulujeme! Úspěšně jste přidali vlastní vlastnosti dokumentu do dokumentu Word pomocí Aspose.Words pro .NET. Tyto vlastnosti představují účinný způsob, jak ukládat metadata přizpůsobená vašim požadavkům, ať už se jedná o podrobnosti o autorizaci sledování, čísla revizí nebo konkrétní částky.

Často kladené otázky

Co jsou vlastní vlastnosti dokumentu?

Vlastní vlastnosti dokumentu jsou metadata, která můžete přidat do dokumentu aplikace Word a uložit tak další informace, které nejsou zahrnuty ve vestavěných vlastnostech.

Mohu přidat jiné vlastnosti než řetězce a čísla?

Ano, můžete přidat různé typy vlastností, včetně booleovských hodnot, dat a dokonce i vlastních objektů.

Jak mohu k těmto vlastnostem přistupovat v dokumentu Word?

K vlastním vlastnostem můžete přistupovat programově pomocí Aspose.Words nebo si je můžete zobrazit přímo ve Wordu prostřednictvím vlastností dokumentu.

Je možné upravovat nebo mazat vlastní vlastnosti?

Rozhodně! Vlastní vlastnosti můžete snadno upravovat nebo mazat pomocí metod poskytovaných Aspose.Words.

Lze použít vlastní vlastnosti pro filtrování dokumentů?

Ano! Vlastní vlastnosti jsou vynikající pro kategorizaci a filtrování dokumentů na základě konkrétních metadat.