Low-Code presentatiewerkzaamheden in .NET
Overzicht
De Aspose.Slides.LowCode namespace biedt statische hulpklassen voor algemene presentatie‑bewerkingen. Deze helpers verpakken veelgebruikte object‑modelworkflows in gerichte methoden, zodat u bestanden kunt converteren of samenvoegen, presentatie‑elementen kunt verwerken, vormen kunt verzamelen en ongebruikte inhoud kunt verwijderen met minder code.
Low‑code helpers zijn het meest bruikbaar wanneer de bewerking van toepassing is op een volledig bestand of presentatie en de standaard workflow aan uw eisen voldoet. Gebruik het volledige Aspose.Slides objectmodel wanneer u fijnmazige controle nodig heeft over individuele dia’s, masters, lay‑outs, vormen, exportinstellingen of relaties tussen presentatie‑elementen.
De onderstaande tabel geeft een overzicht van de beschikbare helpers:
| Helper | Gebruik voor |
|---|---|
| Convert | Een presentatie naar een ander formaat converteren met een directe bestand‑naar‑bestand‑aanroep. |
| Merger | Volledige presentatiesamenvoeging van bestanden met hetzelfde formaat. |
| ForEach | Een actie uitvoeren voor elke dia, vorm, alinea of tekstgedeelte. |
| Collect | Vormen ophalen uit de volledige presentatie voor herhaalde verwerking of analyse. |
| Compress | Ongebruikte masters en lay‑outs verwijderen en ingesloten lettertype‑data reduceren. |
Presentatie converteren
Gebruik Convert.AutoByExtension wanneer de bestandsextensie van de uitvoer voldoende is om het exportformaat te bepalen. De methode opent de bronpresentatie, bepaalt het vereiste formaat op basis van het uitvoerpad en schrijft het resultaat.
using Aspose.Slides.LowCode;
Convert.AutoByExtension("input.pptx", "output.pdf");
De Convert‑klasse biedt ook speciale methoden voor PDF, SVG, JPEG, PNG en TIFF uitvoer. Gebruik het volledige objectmodel wanneer u de presentatie moet inspecteren of aanpassen vóór export, of wanneer u een exportoptie moet configureren die niet beschikbaar is via de helper. Zie Convert Presentation voor formaat‑specifieke workflows en opties.
Presentaties samenvoegen
Gebruik Merger.Process om volledige presentaties met één oproep samen te voegen. De invoer‑presentaties moeten hetzelfde bestandsformaat hebben.
using Aspose.Slides.LowCode;
var inputFiles = new[] { "part-1.pptx", "part-2.pptx" };
Merger.Process(inputFiles, "merged.pptx");
De helper is geschikt wanneer alle dia’s aan één resultaat moeten worden toegevoegd zonder dat ze individueel geselecteerd of opnieuw gemapt moeten worden. Gebruik het volledige objectmodel wanneer u geselecteerde dia’s moet samenvoegen, een bestemmings‑master of lay‑out moet toepassen, secties expliciet moet behouden, of verschillende dia‑groottes moet harmoniseren. Zie Merge Presentations voor die scenario’s.
Door presentatie‑elementen itereren
De ForEach‑klasse roept een terugbel‑functie aan voor elk gevraagd type presentatie‑element. Het voorkomt geneste verzamelings‑lussen en is handig voor inspectie of formatteringswijzigingen op presentatieniveau.
Het volgende voorbeeld gebruikt ForEach.Slide, ForEach.Shape, ForEach.Paragraph en ForEach.Portion om de overeenkomstige elementen te inspecteren:
using System;
using Aspose.Slides;
using Aspose.Slides.LowCode;
using var presentation = new Presentation("input.pptx");
ForEach.Slide(presentation, (slide, index) =>
{
Console.WriteLine($"Slide {index}: {slide.Shapes.Count} shapes");
});
ForEach.Shape(presentation, (shape, slide, index) =>
{
Console.WriteLine($"Shape {index} on {slide.GetType().Name}: {shape.Name}");
});
ForEach.Paragraph(presentation, (paragraph, slide, index) =>
{
Console.WriteLine($"Paragraph {index} on {slide.GetType().Name}: {paragraph.Text}");
});
ForEach.Portion(presentation, (portion, paragraph, slide, index) =>
{
Console.WriteLine($"Portion {index} on {slide.GetType().Name}: {portion.Text}");
});
Standaard omvat de traversering van vormen en tekst over de gehele presentatie normale, master‑ en lay‑outdia’s. Overloads met een includeNotes‑parameter kunnen ook notitiedia’s verwerken. Gebruik directe verzamelings‑lussen wanneer de volgorde van traversering, vroegtijdig afbreken, filteren vóór de terugbel‑aanroep of gedetailleerde ouder‑kind‑controle belangrijk is.
Vormen verzamelen
Gebruik Collect.Shapes wanneer u een verzameling van alle vormen in een presentatie nodig heeft in plaats van een terugbel‑functie voor elke vorm. Dit is nuttig wanneer dezelfde set later gefilterd, geteld of meerdere keren verwerkt moet worden.
using System;
using Aspose.Slides;
using Aspose.Slides.LowCode;
using var presentation = new Presentation("input.pptx");
var shapes = Collect.Shapes(presentation);
foreach (var shape in shapes)
{
Console.WriteLine($"{shape.Name}: {shape.GetType().Name}");
}
Gebruik ForEach.Shape in plaats daarvan wanneer elke vorm direct kan worden verwerkt en u de verzamelde resultaten niet hoeft te behouden.
Presentatie‑inhoud comprimeren
De Compress‑klasse kan ongebruikte structurele elementen verwijderen en ingesloten lettertype‑data reduceren:
- Compress.RemoveUnusedLayoutSlides verwijdert lay‑outdia’s die door geen enkele normale dia worden gerefereerd.
- Compress.RemoveUnusedMasterSlides verwijdert masters die niet langer in gebruik zijn.
- Compress.CompressEmbeddedFonts verwijdert ongebruikte tekens uit ingesloten lettertypes.
using Aspose.Slides;
using Aspose.Slides.Export;
using Aspose.Slides.LowCode;
using var presentation = new Presentation("input.pptx");
Compress.RemoveUnusedLayoutSlides(presentation);
Compress.RemoveUnusedMasterSlides(presentation);
Compress.CompressEmbeddedFonts(presentation);
presentation.Save("compressed.pptx", SaveFormat.Pptx);
Verwijder eerst ongebruikte lay‑outs voordat u ongebruikte masters verwijdert, zodat een master die na het opschonen van lay‑outs niet meer wordt gerefereerd eveneens kan worden verwijderd. Sla de geoptimaliseerde presentatie op in een nieuw bestand als u later de oorspronkelijke masters, lay‑outs of volledige ingesloten lettertype‑data nodig heeft. Voor meer details, zie Slide Master en Embedded Font.
Veelgestelde vragen
Wanneer moet ik de low‑code‑API gebruiken in plaats van het volledige objectmodel?
Gebruik low‑code helpers wanneer een standaardbewerking van toepassing is op een compleet bestand of presentatie en geen gedetailleerde controle over individuele elementen vereist. Gebruik het volledige objectmodel wanneer u specifieke dia’s moet selecteren, relaties tussen master en lay‑out moet beheersen, de tussentijdse status moet inspecteren, of gedrag moet configureren dat de helper niet blootlegt.
Kan Merger presentaties combineren met verschillende bestandsformaten?
Nee. Merger.Process vereist invoer‑presentaties in hetzelfde formaat. Converteer de invoer‑bestanden eerst naar een gemeenschappelijk formaat, bijvoorbeeld met Convert.AutoByExtension, en voeg vervolgens de geconverteerde bestanden samen.
Verwerkt ForEach master‑, lay‑out‑ en notitiedia’s?
ForEach.Slide doorloopt normale presentatiedia’s. De presentatie‑brede ForEach.Shape, ForEach.Paragraph en ForEach.Portion operaties omvatten standaard normale, master‑ en lay‑outdia’s. Gebruik hun overloads met includeNotes op true om notitiedia’s op te nemen.
Wat is het verschil tussen ForEach.Shape en Collect.Shapes?
Gebruik ForEach.Shape om elke vorm direct via een terugbel‑functie te verwerken. Gebruik Collect.Shapes wanneer u een dooriterbare verzameling nodig heeft die u later kunt behouden, filteren, tellen of meerdere keren kunt doorlopen.
Maakt Compress altijd de presentatiedatei kleiner?
Niet noodzakelijk. Het resultaat hangt af van of de presentatie ongebruikte lay‑outs, ongebruikte masters of ingesloten lettertypes met ongebruikte tekens bevat. Als geen van deze aanwezig is, zullen de betreffende Compress‑operaties de bestandsgrootte mogelijk niet verkleinen.
Worden wijzigingen die door ForEach of Compress worden aangebracht automatisch opgeslagen?
Nee. Deze helpers werken op het geladen Presentation object in het geheugen. Nadat u elementen hebt gewijzigd in een ForEach terugbel‑functie of Compress hebt uitgevoerd, roept u Presentation.Save aan om het resultaat weg te schrijven.