Beheer gevoeligheidslabels in PowerPoint‑presentaties in .NET

Waar deze pagina over gaat

Lees, voeg toe, werk bij, verwijder en migreer Microsoft Purview-gevoeligheidslabels in PowerPoint‑PPTX‑presentaties met Aspose.Slides voor .NET.

Overzicht

Microsoft Purview sensitivity labels helpen organisaties documenten te classificeren en te beheren. Tijdens geautomatiseerde presentatieverwerking kan een toepassing een bestaand label behouden, een door een beleid geselecteerd label toepassen, de status updaten, of labelmetadata migreren die door een oudere Microsoft Information Protection (MIP)‑workflow is geschreven.

Aspose.Slides stelt moderne sensitivity‑labelmetadata beschikbaar via Presentation.SensitivityLabels. Deze eigenschap retourneert een ISensitivityLabelCollection die kan worden geïnspecteerd en aangepast vóórdat de presentatie wordt opgeslagen als PPTX.

Opmerking

Identificatoren van gevoeligheidslabels en beleidsinformatie worden gedefinieerd door uw Microsoft Purview‑configuratie. Controleer de beschikbaarheid van labels en beleidsvereisten in uw omgeving voordat u metadata toevoegt of migreert. De waarden van ISensitivityLabel.ContentMarkTypes beschrijven de inhoudsmarkeringen die aan een label zijn gekoppeld; ze voegen op zichzelf geen zichtbare tekst of vormen toe aan dia’s.

Begrijp de eigenschappen van gevoeligheidslabels

Elke ISensitivityLabel bevat de volgende metadata:

Eigenschap	Doel
ISensitivityLabel.Id	Identificeert het gevoeligheidslabel in het Purview‑beleid.
ISensitivityLabel.SiteId	Identificeert de site die bij het labelbeleid hoort.
ISensitivityLabel.IsEnabled	Geeft aan of het label is ingeschakeld.
ISensitivityLabel.IsRemoved	Geeft aan dat het label is verwijderd. Stel deze eigenschap in op `true` wanneer de verwijderingsstatus bewaard moet blijven in de metadata.
ISensitivityLabel.AssignmentMethodType	Specificeert of het label automatisch is toegepast of via een gebruikersbeslissing.
ISensitivityLabel.ContentMarkTypes	Lijst de type inhoudsmarkeringen die aan het label zijn gekoppeld.

De SensitivityLabelAssignmentType‑enumeratie beschrijft hoe een label werd toegewezen:

SensitivityLabelAssignmentType.Standard vertegenwoordigt een standaard of automatisch toegepast label.
SensitivityLabelAssignmentType.Privileged vertegenwoordigt een label dat via een gebruikersbeslissing is toegepast, inclusief handmatig aangebrachte, aanbevolen en verplichte labels.

De SensitivityLabelContentType‑enumeratie identificeert de markering die aan een label is gekoppeld:

Waarde	Betekenis
SensitivityLabelContentType.None	Het label werd standaard of automatisch toegepast.
SensitivityLabelContentType.Header	Koptekstinhoudmarkering is gekoppeld aan het label.
SensitivityLabelContentType.Footer	Voettekstinhoudmarkering is gekoppeld aan het label.
SensitivityLabelContentType.Watermark	Watermerkinhoudmarkering is gekoppeld aan het label.
SensitivityLabelContentType.Encryption	Versleutelingsbescherming is gekoppeld aan het label.

Meerdere markeringstypen kunnen aan één label worden gekoppeld.

Lijst bestaande gevoeligheidslabels

Lees de moderne labelcollectie uit Presentation.SensitivityLabels en doorloop deze. Het volgende voorbeeld lijst elke eigenschap en inhoudsmarkering op die voor elk label is opgeslagen:

using System;
using Aspose.Slides;

using var presentation = new Presentation("presentation.pptx");
var sensitivityLabels = presentation.SensitivityLabels;

foreach (var sensitivityLabel in sensitivityLabels)
{
    Console.WriteLine("Label ID: " + sensitivityLabel.Id);
    Console.WriteLine("Site ID: " + sensitivityLabel.SiteId);
    Console.WriteLine("Enabled: " + sensitivityLabel.IsEnabled);
    Console.WriteLine("Removed: " + sensitivityLabel.IsRemoved);
    Console.WriteLine("Assignment method: " + sensitivityLabel.AssignmentMethodType);

    foreach (var contentMarkType in sensitivityLabel.ContentMarkTypes)
    {
        Console.WriteLine("Content marking: " + contentMarkType);
    }
}

Voeg een gevoeligheidslabel met inhoudsmarkering toe

Gebruik ISensitivityLabelCollection.Add met de label‑identificator, site‑identificator, ingeschakelde status en toewijzingsmethode. Nadat de methode het nieuwe ISensitivityLabel heeft geretourneerd, voeg je de vereiste markeringswaarden toe via ISensitivityLabel.ContentMarkTypes.

Het volgende voorbeeld voegt een handmatig geselecteerd label toe dat is gekoppeld aan voettekst‑ en watermerk‑markeringen, en slaat vervolgens het resultaat op als PPTX:

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation.pptx");
var sensitivityLabels = presentation.SensitivityLabels;

var labelIdentifier = "{11111111-2222-3333-4444-555555555555}";
var siteIdentifier = Guid.Parse("{aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee}");
var isEnabled = true;
var assignmentMethod = SensitivityLabelAssignmentType.Privileged;

var sensitivityLabel = sensitivityLabels.Add(
    labelIdentifier,
    siteIdentifier,
    isEnabled,
    assignmentMethod);

sensitivityLabel.ContentMarkTypes.Add(SensitivityLabelContentType.Footer);
sensitivityLabel.ContentMarkTypes.Add(SensitivityLabelContentType.Watermark);

presentation.Save("presentation_with_label.pptx", SaveFormat.Pptx);

Werk een gevoeligheidslabel bij

De eigenschappen van ISensitivityLabel zijn lees‑/schrijfbaar, behalve dat de collectie die door ISensitivityLabel.ContentMarkTypes wordt geretourneerd, wordt gewijzigd via de lijstbewerkingen. Nadat het gewenste label is gevonden, kun je de identificator, site‑identificator, ingeschakelde status, toewijzingsmethode, verwijderingsstatus en inhoudsmarkeringstypen bijwerken. Sla de presentatie op om de wijzigingen te behouden.

Het volgende voorbeeld werkt de ingeschakelde status en toewijzingsmethode van het eerste label bij:

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation.pptx");
var sensitivityLabels = presentation.SensitivityLabels;

if (sensitivityLabels.Count > 0)
{
    var sensitivityLabel = sensitivityLabels[0];
    sensitivityLabel.IsEnabled = true;
    sensitivityLabel.AssignmentMethodType = SensitivityLabelAssignmentType.Privileged;
}

presentation.Save("presentation_with_updated_label.pptx", SaveFormat.Pptx);

Markeer een gevoeligheidslabel als verwijderd

Om het feit te behouden dat een label is verwijderd, zoek je het label en stel je ISensitivityLabel.IsRemoved in op true. Dit behoudt de label‑vermelding terwijl de verwijderingsstatus wordt vastgelegd. Als je in plaats daarvan een vermelding uit de moderne collectie moet verwijderen, gebruik dan ISensitivityLabelCollection.RemoveAt; gebruik ISensitivityLabelCollection.Clear om elke vermelding te verwijderen.

Het volgende voorbeeld markeert een specifiek label als verwijderd en slaat de bijgewerkte presentatie op:

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation.pptx");
var sensitivityLabels = presentation.SensitivityLabels;
var targetLabelIdentifier = "{11111111-2222-3333-4444-555555555555}";

foreach (var sensitivityLabel in sensitivityLabels)
{
    var isTargetLabel = string.Equals(
        sensitivityLabel.Id,
        targetLabelIdentifier,
        StringComparison.OrdinalIgnoreCase);

    if (isTargetLabel)
    {
        sensitivityLabel.IsRemoved = true;
        break;
    }
}

presentation.Save("presentation_with_removed_label.pptx", SaveFormat.Pptx);

Lees en migreer legacy MIP gevoeligheidslabels

Ouder‑MIP‑gebaseerde workflows kunnen metadata van gevoeligheidslabels opslaan in aangepaste document‑eigenschappen in plaats van in de moderne labelcollectie. Lees die metadata met IDocumentProperties.GetSensitivityLabels. De methode parseert de legacy‑aangepaste eigenschappen en retourneert een array van ISensitivityLabel‑objecten.

Om de metadata te migreren, voeg je elk geretourneerd label toe aan de moderne ISensitivityLabelCollection via ISensitivityLabelCollection.Add. Omdat het toevoegen van een dubbele label‑identificator een uitzondering veroorzaakt, controleert het voorbeeld de bestemmingscollectie voordat elk label wordt gekopieerd. Je kunt extra validatie toevoegen om te bevestigen dat elk legacy‑label nog steeds bestaat in het huidige Purview‑beleid.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation_with_legacy_labels.pptx");
var legacySensitivityLabels = presentation.DocumentProperties.GetSensitivityLabels();
var modernSensitivityLabels = presentation.SensitivityLabels;

foreach (var legacySensitivityLabel in legacySensitivityLabels)
{
    var labelAlreadyExists = false;

    foreach (var modernSensitivityLabel in modernSensitivityLabels)
    {
        labelAlreadyExists = string.Equals(
            modernSensitivityLabel.Id,
            legacySensitivityLabel.Id,
            StringComparison.OrdinalIgnoreCase);

        if (labelAlreadyExists)
        {
            break;
        }
    }

    if (!labelAlreadyExists)
    {
        modernSensitivityLabels.Add(legacySensitivityLabel);
    }
}

presentation.Save("presentation_with_modern_labels.pptx", SaveFormat.Pptx);

De migratie kopieert de geparseerde label‑objecten naar de moderne collectie. Het is niet nodig om alle aangepaste document‑eigenschappen te wissen, zodat niet‑gerelateerde documentmetadata intact blijft. Gebruik IPresentation.Save met SaveFormat.Pptx om de moderne labelmetadata naar een PPTX‑bestand te schrijven.

Veelgestelde vragen

Voegt het toevoegen van een inhoudsmarkeringstype een zichtbaar kop‑, voet‑ of watermerk toe aan de dia’s?

Nee. De waarden die via ISensitivityLabel.ContentMarkTypes worden toegevoegd, beschrijven de markeringen die bij het gevoeligheidslabel horen. Ze creëren geen zichtbare tekst of vormen in de presentatie. Voeg de overeenkomstige dia‑inhoud apart toe als uw workflow die markeringen moet weergeven.

Wat is het verschil tussen een label markeren als verwijderd en het verwijderen uit de collectie?

Het instellen van ISensitivityLabel.IsRemoved op true behoudt de labelvermelding en registreert de verwijderingsstatus. Het aanroepen van ISensitivityLabelCollection.RemoveAt verwijdert de vermelding uit de moderne collectie. Kies de bewerking die overeenkomt met de metadata‑bewaringsvereisten van uw organisatie.

Kan een presentatie zowel legacy‑MIP‑metadata als moderne gevoeligheidslabels bevatten?

Ja. Legacy‑labels kunnen in aangepaste document‑eigenschappen blijven staan, terwijl moderne labels beschikbaar zijn via Presentation.SensitivityLabels. Gebruik IDocumentProperties.GetSensitivityLabels om de legacy‑metadata te lezen en migreer alleen de geldige labels die nog niet in de moderne collectie aanwezig zijn.

Wat gebeurt er wanneer een label met dezelfde identificator meer dan één keer wordt toegevoegd?

ISensitivityLabelCollection.Add veroorzaakt een ArgumentException wanneer de collectie al een label met dezelfde identificator bevat. Controleer bestaande ISensitivityLabel.Id‑waarden voordat u labels toevoegt of migreert.

Welk uitvoerformaat moet worden gebruikt om bijgewerkte gevoeligheidslabels te behouden?

Sla de presentatie op als PPTX door IPresentation.Save aan te roepen met SaveFormat.Pptx, zoals getoond in de voorbeelden hierboven.

Watermerken toevoegen aan presentaties in .NET