Wstęp

Witamy! Jeśli poznajesz Aspose.Words dla .NET i chcesz dowiedzieć się, jak dodawać niestandardowe właściwości dokumentów do plików Word, jesteś we właściwym miejscu. Właściwości niestandardowe są nieocenione do przechowywania dodatkowych metadanych, których nie obejmują właściwości wbudowane. Niezależnie od tego, czy chcesz śledzić autoryzację dokumentu, numery wersji, czy konkretne daty, właściwości niestandardowe mogą Ci się przydać. W tym samouczku przeprowadzimy Cię przez kroki, aby bezproblemowo dodać te właściwości za pomocą Aspose.Words dla .NET. Zaczynajmy!

Wymagania wstępne

Zanim zagłębisz się w kod, upewnij się, że masz następujące elementy:

  1. Biblioteka Aspose.Words dla .NET: Pobierz ją Tutaj.
  2. Środowisko programistyczne: IDE, takie jak Visual Studio.
  3. Podstawowa znajomość języka C#: Znajomość języka C# i .NET będzie pomocna.
  4. Przykładowy dokument: Przygotuj przykładowy dokument Word o nazwie Properties.docx do modyfikacji.

Importowanie przestrzeni nazw

Aby uzyskać dostęp do funkcjonalności Aspose.Words, musisz zaimportować niezbędne przestrzenie nazw na początku kodu:

using System;
using Aspose.Words;

Krok 1: Konfigurowanie ścieżki dokumentu

Następnie zdefiniujmy ścieżkę do dokumentu Word. Ten krok jest niezbędny do zlokalizowania i otwarcia dokumentu. Properties.docx plik.

// Podaj ścieżkę do katalogu dokumentów.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document(dataDir + "Properties.docx");

Pamiętaj o wymianie "YOUR DOCUMENT DIRECTORY" z rzeczywistą ścieżką do dokumentu.

Krok 2: Dostęp do niestandardowych właściwości dokumentu

Teraz uzyskajmy dostęp do niestandardowych właściwości dokumentu Word, w którym będą znajdować się Twoje niestandardowe metadane.

CustomDocumentProperties customDocumentProperties = doc.CustomDocumentProperties;

Ten wiersz daje Ci dostęp do zbioru niestandardowych właściwości, z którymi będziesz pracować.

Krok 3: Sprawdzanie istniejących nieruchomości

Przed dodaniem nowych nieruchomości warto sprawdzić, czy dana nieruchomość już istnieje, aby uniknąć duplikacji.

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

Ten kod sprawdza, czy właściwość „Authorized” już istnieje. Jeśli tak, metoda kończy działanie przed czasem, zapobiegając powstawaniu duplikatów.

Krok 4: Dodawanie właściwości logicznej

Dodajmy niestandardową właściwość logiczną, która będzie wskazywać, czy dokument jest autoryzowany.

customDocumentProperties.Add("Authorized", true);

Ten wiersz dodaje właściwość o nazwie „Authorized” i ustawia jej wartość na true.

Krok 5: Dodawanie właściwości ciągu

Następnie określimy, kto autoryzował dokument, dodając właściwość ciągu.

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

Możesz zastąpić „John Smith” dowolną nazwą.

Krok 6: Dodawanie właściwości daty

Aby śledzić, kiedy dokument został autoryzowany, dodajmy właściwość daty.

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

Ten wiersz dodaje właściwość o nazwie „Data autoryzacji” i przypisuje jej dzisiejszą datę za pomocą DateTime.Today.

Krok 7: Dodawanie numeru rewizji

W celu kontroli wersji możemy dodać właściwość, która będzie śledziła numer wersji dokumentu.

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

Tutaj dodajemy właściwość „Autoryzowana wersja”, która przechowuje aktualny numer wersji dokumentu.

Krok 8: Dodawanie właściwości liczbowej

Na koniec dodajmy właściwość liczbową, która umożliwi przechowywanie autoryzowanej kwoty, np. kwoty budżetowej.

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

Ten wiersz dodaje właściwość o nazwie „Kwota autoryzowana” o wartości 123.45Możesz dostosować tę liczbę według potrzeb.

Wniosek

Gratulacje! Udało Ci się dodać niestandardowe właściwości dokumentu do dokumentu Word za pomocą Aspose.Words dla .NET. Właściwości te to potężne narzędzie do przechowywania metadanych dostosowanych do Twoich potrzeb, niezależnie od tego, czy śledzisz szczegóły autoryzacji, numery wersji, czy konkretne kwoty.

Najczęściej zadawane pytania

Czym są niestandardowe właściwości dokumentu?

Niestandardowe właściwości dokumentu to metadane, które można dodać do dokumentu programu Word w celu przechowywania dodatkowych informacji nieujętych we wbudowanych właściwościach.

Czy mogę dodać inne właściwości niż ciągi znaków i liczby?

Tak, możesz dodawać różne typy właściwości, w tym wartości logiczne, daty i nawet obiekty niestandardowe.

Jak mogę uzyskać dostęp do tych właściwości w dokumencie Word?

Dostęp do niestandardowych właściwości można uzyskać programowo, używając Aspose.Words, lub przeglądać je bezpośrednio w programie Word, korzystając z właściwości dokumentu.

Czy można edytować lub usuwać właściwości niestandardowe?

Oczywiście! Możesz łatwo edytować lub usuwać właściwości niestandardowe za pomocą metod udostępnianych przez Aspose.Words.

Czy właściwości niestandardowe można wykorzystać do filtrowania dokumentów?

Tak! Właściwości niestandardowe doskonale nadają się do kategoryzowania i filtrowania dokumentów na podstawie określonych metadanych.