CipherData 類別

定義

命名空間:

System.Security.Cryptography.Xml

組件:

System.Security.Cryptography.Xml.dll

來源:

CipherData.cs

表示 XML 加密中的 <CipherData> 項目。 此類別無法獲得繼承。

public ref class CipherData sealed

public sealed class CipherData

type CipherData = class

Public NotInheritable Class CipherData

繼承

Object

CipherData

範例

下列程式代碼範例會 EncryptedData 使用 類別來建立 <EncryptedData> 包含 <CipherData> 元素的專案，然後將 XML 寫入 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

備註

類別 CipherData 代表 <CipherData> XML 加密中的專案。 這是提供加密數據的必要元素。 它必須包含加密的數據做為元素的 <CipherValue> base64編碼文字，或使用 元素提供包含加密數據 <CipherReference> 的外部位置參考。

在許多情況下，您不需要直接建立 類別的新實例 CipherData 。 EncryptedXml、 EncryptedData和 EncryptedKey 類別會為您建立實例。

注意

CipherData物件可以有屬性或CipherValue屬性，但不能同時擁有CipherReference兩者。 CryptographicException如果兩者都指派給 CipherData 物件，則會擲回 。

建構函式

CipherData()	初始化 CipherData 類別的新執行個體。
CipherData(Byte[])	使用位元組陣列做為 CipherData 值，初始化 CipherValue 類別的新執行個體。
CipherData(CipherReference)	使用 CipherData 物件初始化 CipherReference 類別的新執行個體。

屬性

CipherReference	取得或設定 <CipherReference> 項目。
CipherValue	取得或設定 <CipherValue> 項目。

方法

GetXml()	取得 CipherData 物件的 XML 值。
LoadXml(XmlElement)	從 XmlElement 將 XML 資料載入 CipherData 物件內。