DocumentPropertyCollection

DocumentPropertyCollection class

Basisklasse fürBuiltInDocumentProperties UndCustomDocumentProperties Sammlungen.

Um mehr zu erfahren, besuchen Sie dieArbeiten Sie mit Dokumenteigenschaften Dokumentationsartikel.

public abstract class DocumentPropertyCollection : IEnumerable<DocumentProperty>

Eigenschaften

NameBeschreibung
Count { get; }Ruft die Anzahl der Elemente in der Sammlung ab.
Item { get; }Gibt a zurückDocumentProperty Objekt nach index.
virtual Item { get; }Gibt a zurückDocumentProperty Objekt mit dem Namen der Eigenschaft.

Methoden

NameBeschreibung
Clear()Entfernt alle Eigenschaften aus der Sammlung.
Contains(string)Gibt zurückWAHR wenn eine Eigenschaft mit dem angegebenen Namen in der Sammlung vorhanden ist.
GetEnumerator()Gibt ein Enumeratorobjekt zurück, das zum Durchlaufen aller Elemente in der Sammlung verwendet werden kann.
IndexOf(string)Ruft den Index einer Eigenschaft nach Namen ab.
Remove(string)Entfernt eine Eigenschaft mit dem angegebenen Namen aus der Sammlung.
RemoveAt(int)Entfernt eine Eigenschaft am angegebenen Index.

Bemerkungen

Bei den Namen der Eigenschaften wird die Groß-/Kleinschreibung nicht beachtet.

Die Eigenschaften in der Sammlung werden alphabetisch nach Namen sortiert.

Beispiele

Zeigt, wie mit den benutzerdefinierten Eigenschaften eines Dokuments gearbeitet wird.

Document doc = new Document();
CustomDocumentProperties properties = doc.CustomDocumentProperties;

Assert.AreEqual(0, properties.Count);

// Benutzerdefinierte Dokumenteigenschaften sind Schlüssel-Wert-Paare, die wir dem Dokument hinzufügen können.
properties.Add("Authorized", true);
properties.Add("Authorized By", "John Doe");
properties.Add("Authorized Date", DateTime.Today);
properties.Add("Authorized Revision", doc.BuiltInDocumentProperties.RevisionNumber);
properties.Add("Authorized Amount", 123.45);

// Die Sammlung sortiert die benutzerdefinierten Eigenschaften in alphabetischer Reihenfolge.
Assert.AreEqual(1, properties.IndexOf("Authorized Amount"));
Assert.AreEqual(5, properties.Count);

// Jede benutzerdefinierte Eigenschaft im Dokument drucken.
using (IEnumerator<DocumentProperty> enumerator = properties.GetEnumerator())
{
    while (enumerator.MoveNext())
        Console.WriteLine($"Name: \"{enumerator.Current.Name}\"\n\tType: \"{enumerator.Current.Type}\"\n\tValue: \"{enumerator.Current.Value}\"");
}

// Den Wert einer benutzerdefinierten Eigenschaft mithilfe eines DOCPROPERTY-Felds anzeigen.
DocumentBuilder builder = new DocumentBuilder(doc);
FieldDocProperty field = (FieldDocProperty)builder.InsertField(" DOCPROPERTY \"Authorized By\"");
field.Update();

Assert.AreEqual("John Doe", field.Result);

// Wir können diese benutzerdefinierten Eigenschaften in Microsoft Word über „Datei“ finden –> „Eigenschaften“ > „Erweiterte Eigenschaften“ > "Brauch".
doc.Save(ArtifactsDir + "DocumentProperties.DocumentPropertyCollection.docx");

// Im Folgenden finden Sie drei Möglichkeiten, benutzerdefinierte Eigenschaften aus einem Dokument zu entfernen.
// 1 - Nach Index entfernen:
properties.RemoveAt(1);

Assert.False(properties.Contains("Authorized Amount"));
Assert.AreEqual(4, properties.Count);

// 2 - Nach Namen entfernen:
properties.Remove("Authorized Revision");

Assert.False(properties.Contains("Authorized Revision"));
Assert.AreEqual(3, properties.Count);

// 3 – Die gesamte Sammlung auf einmal leeren:
properties.Clear();

Assert.AreEqual(0, properties.Count);

Siehe auch