Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


CipherData Klasa

Definicja

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

<CipherData> Reprezentuje element w szyfrowaniu XML. Klasa ta nie może być dziedziczona.

C#
public sealed class CipherData
Dziedziczenie
CipherData

Przykłady

Poniższy przykład kodu używa EncryptedData klasy do utworzenia <EncryptedData> elementu zawierającego <CipherData> element, a następnie zapisuje kod XML w pliku XML.

C#
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);
        }
    }
}

Uwagi

Klasa CipherData reprezentuje <CipherData> element w szyfrowaniu XML. Jest to wymagany element, który dostarcza zaszyfrowane dane. Musi zawierać zaszyfrowane dane jako tekst <CipherValue> zakodowany w formacie base64 elementu lub podać odwołanie do lokalizacji zewnętrznej zawierającej zaszyfrowane dane przy użyciu <CipherReference> elementu .

W wielu przypadkach nie trzeba bezpośrednio tworzyć nowego wystąpienia CipherData klasy. Klasy EncryptedXml, EncryptedDatai EncryptedKey tworzą dla Ciebie wystąpienia.

Uwaga

Obiekt CipherData może mieć CipherReference właściwość lub CipherValue właściwość, ale nie obie. Obiekt CryptographicException jest zgłaszany, jeśli oba są przypisane do CipherData obiektu.

Konstruktory

CipherData()

Inicjuje nowe wystąpienie klasy CipherData.

CipherData(Byte[])

Inicjuje CipherData nowe wystąpienie klasy przy użyciu tablicy bajtów jako CipherValue wartości.

CipherData(CipherReference)

Inicjuje CipherData nowe wystąpienie klasy przy użyciu CipherReference obiektu .

Właściwości

CipherReference

Pobiera lub ustawia <CipherReference> element.

CipherValue

Pobiera lub ustawia <CipherValue> element.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
GetXml()

Pobiera wartości XML dla CipherData obiektu.

LoadXml(XmlElement)

Ładuje dane XML z obiektu XmlElement do CipherData obiektu .

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Produkt Wersje
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10