CipherData Konstruktoren

Definition

Initialisiert eine neue Instanz der CipherData-Klasse.

Überlädt

CipherData()

Initialisiert eine neue Instanz der CipherData-Klasse.

CipherData(Byte[])

Initialisiert eine neue Instanz der CipherData-Klasse unter Verwendung eines Bytearrays als CipherValue-Wert.

CipherData(CipherReference)

Initialisiert eine neue Instanz der CipherData-Klasse unter Verwendung eines CipherReference-Objekts.

CipherData()

Quelle:
CipherData.cs
Quelle:
CipherData.cs
Quelle:
CipherData.cs

Initialisiert eine neue Instanz der CipherData-Klasse.

public CipherData ();

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie eine neue Instanz der CipherData-Klasse erstellt wird. Das gesamte Beispiel finden Sie im CipherData Klassenthema.

// 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];

Hinweise

Dieser Konstruktor erstellt ein CipherData -Objekt, das das -Element in der <CipherData> XML-Verschlüsselung darstellt. Das <CipherData> -Element ist ein erforderliches Element in der XML-Verschlüsselung.

Gilt für:

.NET 9 (package-provided) und andere Versionen
Produkt Versionen
.NET 8 (package-provided), 9 (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 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

CipherData(Byte[])

Quelle:
CipherData.cs
Quelle:
CipherData.cs
Quelle:
CipherData.cs

Initialisiert eine neue Instanz der CipherData-Klasse unter Verwendung eines Bytearrays als CipherValue-Wert.

public CipherData (byte[] cipherValue);

Parameter

cipherValue
Byte[]

Die für das <CipherValue>-Element zu verwendenden verschlüsselten Daten.

Ausnahmen

Der cipherValue-Parameter ist null.

Die CipherValue-Eigenschaft wurde bereits festgelegt.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie eine neue Instanz der CipherData-Klasse erstellt wird.

// Create a new CipherData object using a byte array to represent encrypted data.
Byte[] sampledata = new byte[8];
CipherData cd = new CipherData(sampledata);

Hinweise

Dieser Konstruktor erstellt ein CipherData -Objekt, das das -Element in der <CipherData> XML-Verschlüsselung darstellt. Der Konstruktor weist der -Eigenschaft den cipherValueCipherValue Wert als tatsächlich verschlüsselte Daten zu.

Hinweis

Das <CipherData> Element kann entweder ein oder ein CipherReference untergeordnetes CipherValue Element haben, aber nicht beides. Ein CryptographicException wird ausgelöst, wenn beide einem CipherData -Objekt zugewiesen sind.

Gilt für:

.NET 9 (package-provided) und andere Versionen
Produkt Versionen
.NET 8 (package-provided), 9 (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 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

CipherData(CipherReference)

Quelle:
CipherData.cs
Quelle:
CipherData.cs
Quelle:
CipherData.cs

Initialisiert eine neue Instanz der CipherData-Klasse unter Verwendung eines CipherReference-Objekts.

public CipherData (System.Security.Cryptography.Xml.CipherReference cipherReference);

Parameter

cipherReference
CipherReference

Das zu verwendende CipherReference-Objekt.

Ausnahmen

Der cipherValue-Parameter ist null.

Die CipherValue-Eigenschaft wurde bereits festgelegt.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie mithilfe CipherReference von Informationen eine neue instance der CipherData -Klasse erstellen.

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

/// This sample used the EncryptedData class to create an encrypted data element
/// and write it to an XML file. It demonstrates the use of CipherReference.
namespace EncryptedDataSample
{
    class Example
    {
        [STAThread]
        static void Main(string[] args)
        {
            //Create a URI string.
            String uri = "http://www.woodgrovebank.com/document.xml";
            // Create a Base64 transform. The input content retrieved from the
            // URI should be Base64-decoded before other processing.
            Transform base64 = new XmlDsigBase64Transform();
            //Create a transform chain and add the transform to it.
            TransformChain tc = new TransformChain();
            tc.Add(base64);
            //Create <CipherReference> information.
            CipherReference reference = new CipherReference(uri, tc);

            // Create a new CipherData object using the CipherReference information.
            // Note that you cannot assign both a CipherReference and a CipherValue
            // to a CipherData object.
            CipherData cd = new CipherData(reference);

            // 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.
            try
            {
                string path = @"c:\test\MyTest.xml";

                File.WriteAllText(path, ed.GetXml().OuterXml);
            }
            catch (IOException e)
            {
                Console.WriteLine("File IO error. {0}", e);
            }
        }
    }
}

Hinweise

Dieser Konstruktor erstellt ein CipherData -Objekt, das das -Element in der <CipherData> XML-Verschlüsselung darstellt und den cipherReference Wert der CipherReference -Eigenschaft zuweist. Das CipherReference -Objekt stellt das <CipherReference> -Element dar, das den Speicherort der verschlüsselten Daten bereitstellt.

Hinweis

Ein CipherData Objekt kann entweder eine CipherReference Eigenschaft oder eine CipherValue Eigenschaft haben, aber nicht beides. Ein CryptographicException wird ausgelöst, wenn beide einem CipherData -Objekt zugewiesen sind.

Gilt für:

.NET 9 (package-provided) und andere Versionen
Produkt Versionen
.NET 8 (package-provided), 9 (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 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9