CipherData Classe

Définition

Espace de noms:

System.Security.Cryptography.Xml

Assembly:

System.Security.Cryptography.Xml.dll

Source:

CipherData.cs

Représente l’élément dans le <CipherData> chiffrement XML. Cette classe ne peut pas être héritée.

public ref class CipherData sealed

public sealed class CipherData

type CipherData = class

Public NotInheritable Class CipherData

Héritage

Object

CipherData

Exemples

L’exemple de code suivant utilise la EncryptedData classe pour créer un <EncryptedData> élément qui contient un <CipherData> élément, puis écrit le code XML dans un fichier XML.

using System;
using System.Security.Cryptography.Xml;
using System.Xml;
using System.IO;

/// This sample used the EncryptedData class to create a EncryptedData element
/// and write it to an XML file.
namespace EncryptedDataSample
{
    class Sample1
    {
        [STAThread]
        static void Main(string[] args)
        {
            // Create a new CipherData object.
            CipherData cd = new CipherData();
            // Assign a byte array to be the CipherValue. This is a byte array representing encrypted data.
            cd.CipherValue = new byte[8];
            // Create a new EncryptedData object.
            EncryptedData ed = new EncryptedData();
            //Add an encryption method to the object.
            ed.Id = "ED";
            ed.EncryptionMethod = new EncryptionMethod("http://www.w3.org/2001/04/xmlenc#aes128-cbc");
            ed.CipherData = cd;

            //Add key information to the object.
            KeyInfo ki = new KeyInfo();
            ki.AddClause(new KeyInfoRetrievalMethod("#EK", "http://www.w3.org/2001/04/xmlenc#EncryptedKey"));
            ed.KeyInfo = ki;

            // Create new XML document and put encrypted data into it.
            XmlDocument doc = new XmlDocument();
            XmlElement encryptionPropertyElement = (XmlElement)doc.CreateElement("EncryptionProperty", EncryptedXml.XmlEncNamespaceUrl);
            EncryptionProperty ep = new EncryptionProperty(encryptionPropertyElement);
            ed.AddProperty(ep);

            // Output the resulting XML information into a file.
            string path = @"c:\test\MyTest.xml";
            File.WriteAllText(path,ed.GetXml().OuterXml);
            //Console.WriteLine(ed.GetXml().OuterXml);
        }
    }
}

Imports System.Security.Cryptography.Xml
Imports System.Xml
Imports System.IO


'/ This sample used the EncryptedData class to create a EncryptedData element
'/ and write it to an XML file.
Module EncryptedDataSample1

    Sub Main()
        ' Create a new CipherData object.
        Dim cd As New CipherData
        ' Assign a byte array to the CipherValue.
        cd.CipherValue = New Byte(7) {}
        ' Create a new EncryptedData object.
        Dim ed As New EncryptedData
        'Add an encryption method to the object.
        ed.Id = "ED"
        ed.EncryptionMethod = New EncryptionMethod("http://www.w3.org/2001/04/xmlenc#aes128-cbc")
        ed.CipherData = cd

        'Add key information to the object.
        Dim ki As New KeyInfo
        ki.AddClause(New KeyInfoRetrievalMethod("#EK", "http://www.w3.org/2001/04/xmlenc#EncryptedKey"))
        ed.KeyInfo = ki

        ' Create new XML document and put encrypted data into it.
        Dim doc As New XmlDocument
        Dim encryptionPropertyElement As XmlElement = CType(doc.CreateElement("EncryptionProperty", EncryptedXml.XmlEncNamespaceUrl), XmlElement)
        Dim ep As New EncryptionProperty(encryptionPropertyElement)
        ed.AddProperty(ep)

        ' Output the resulting XML information into a file.
        Dim path As String = "c:\test\MyTest.xml"
        File.WriteAllText(path, ed.GetXml().OuterXml)
        'End Sub
    End Sub

End Module

Remarques

La CipherData classe représente l’élément dans le <CipherData> chiffrement XML. Il s’agit d’un élément requis qui fournit les données chiffrées. Il doit contenir les données chiffrées sous forme de texte codé en base64 de l’élément <CipherValue> , ou fournir une référence à un emplacement externe contenant les données chiffrées à l’aide de l’élément <CipherReference> .

Dans de nombreux cas, vous n’avez pas besoin de créer directement une instance de la CipherData classe. Les EncryptedXmlclasses et EncryptedKey les instances EncryptedDatacréent des instances pour vous.

Note

Un CipherData objet peut avoir une CipherReference propriété ou une CipherValue propriété, mais pas les deux. A CryptographicException est levée si les deux sont affectés à un CipherData objet.

Constructeurs

Nom	Description
CipherData()	Initialise une nouvelle instance de la classe CipherData.
CipherData(Byte[])	Initialise une nouvelle instance de la classe à l’aide CipherData d’un tableau d’octets comme CipherValue valeur.
CipherData(CipherReference)	Initialise une nouvelle instance de la classe à l’aide CipherData d’un CipherReference objet.

Propriétés

Nom	Description
CipherReference	Obtient ou définit l’élément <CipherReference> .
CipherValue	Obtient ou définit l’élément <CipherValue> .

Méthodes

Nom	Description
GetXml()	Obtient les valeurs XML de l’objet CipherData .
LoadXml(XmlElement)	Charge des données XML à partir d’un XmlElementCipherData objet.