CustomPartCollection

CustomPartCollection class

Représente une collection deCustomPart objets.

Pour en savoir plus, visitez leBalises de documents structurés ou contrôle de contenu article documentaire.

public class CustomPartCollection : IEnumerable<CustomPart>

Constructeurs

NomLa description
CustomPartCollection()Default_Constructor

Propriétés

NomLa description
Count { get; }Obtient le nombre d’éléments contenus dans la collection.
Item { get; set; }Obtient ou définit un élément à l’index spécifié.

Méthodes

NomLa description
Add(CustomPart)Ajoute un élément à la collection.
Clear()Supprime tous les éléments de la collection.
Clone()Crée une copie complète de cette collection et de ses éléments.
GetEnumerator()Renvoie un objet énumérateur qui peut être utilisé pour parcourir tous les éléments de la collection.
RemoveAt(int)Supprime un élément à l’index spécifié.

Remarques

Vous n’avez normalement pas besoin de créer des instances de cette classe. Vous accédez aux parties personnalisées liées au package OOXML via lePackageCustomParts propriété.

Exemples

Montre comment accéder à la collection de pièces personnalisées arbitraires d’un document.

Document doc = new Document(MyDir + "Custom parts OOXML package.docx");

Assert.AreEqual(2, doc.PackageCustomParts.Count);

// Clonez la deuxième partie, puis ajoutez le clone à la collection.
CustomPart clonedPart = doc.PackageCustomParts[1].Clone();
doc.PackageCustomParts.Add(clonedPart);
Assert.AreEqual(3, doc.PackageCustomParts.Count);

// Énumère la collection et imprime chaque partie.
using (IEnumerator<CustomPart> enumerator = doc.PackageCustomParts.GetEnumerator())
{
    int index = 0;
    while (enumerator.MoveNext())
    {
        Console.WriteLine($"Part index {index}:");
        Console.WriteLine($"\tName:\t\t\t\t{enumerator.Current.Name}");
        Console.WriteLine($"\tContent type:\t\t{enumerator.Current.ContentType}");
        Console.WriteLine($"\tRelationship type:\t{enumerator.Current.RelationshipType}");
        Console.WriteLine(enumerator.Current.IsExternal ?
            "\tSourced from outside the document" :
            $"\tStored within the document, length: {enumerator.Current.Data.Length} bytes");
        index++;
    }
}

// Nous pouvons supprimer des éléments de cette collection individuellement ou tous en même temps.
doc.PackageCustomParts.RemoveAt(2);

Assert.AreEqual(2, doc.PackageCustomParts.Count);

doc.PackageCustomParts.Clear();

Assert.AreEqual(0, doc.PackageCustomParts.Count);

Voir également

CustomPart Class CustomXmlPart Class