Прочитать на английском

Поделиться через


CipherData Конструкторы

Определение

Инициализирует новый экземпляр класса CipherData.

Перегрузки

CipherData()

Инициализирует новый экземпляр класса CipherData.

CipherData(Byte[])

Инициализирует новый экземпляр класса CipherData массивом байтов в виде значения свойства CipherValue.

CipherData(CipherReference)

Инициализирует новый экземпляр класса CipherData с помощью объекта CipherReference.

CipherData()

Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs

Инициализирует новый экземпляр класса CipherData.

C#
public CipherData();

Примеры

В следующем примере кода демонстрируется создание нового экземпляра класса CipherData. Весь пример можно найти в разделе класса CipherData .

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

Комментарии

Этот конструктор создает CipherData объект , представляющий <CipherData> элемент в xml-шифровании. Элемент <CipherData> является обязательным элементом в xml-шифровании.

Применяется к

.NET 10 (package-provided) и другие версии
Продукт Версии
.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

CipherData(Byte[])

Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs

Инициализирует новый экземпляр класса CipherData массивом байтов в виде значения свойства CipherValue.

C#
public CipherData(byte[] cipherValue);

Параметры

cipherValue
Byte[]

Зашифрованные данные, используемые для элемента <CipherValue>.

Исключения

Параметр cipherValue имеет значение null.

Свойство CipherValue уже задано.

Примеры

В следующем примере кода демонстрируется создание нового экземпляра класса CipherData.

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

Комментарии

Этот конструктор создает CipherData объект , представляющий <CipherData> элемент в xml-шифровании. Конструктор присваивает cipherValue значение свойству в CipherValue качестве фактических зашифрованных данных.

Примечание

Элемент <CipherData> может иметь либо дочерний CipherReference элемент, либо дочерний CipherValue элемент, но не оба элемента. Если CryptographicException объекту CipherData назначены оба объекта, возникает исключение .

Применяется к

.NET 10 (package-provided) и другие версии
Продукт Версии
.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

CipherData(CipherReference)

Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs
Исходный код:
CipherData.cs

Инициализирует новый экземпляр класса CipherData с помощью объекта CipherReference.

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

Параметры

cipherReference
CipherReference

Используемый объект CipherReference.

Исключения

Параметр cipherValue имеет значение null.

Свойство CipherValue уже задано.

Примеры

В следующем примере кода показано, как создать новый экземпляр класса с помощью CipherReference сведенийCipherData.

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

Комментарии

Этот конструктор создает CipherData объект , представляющий <CipherData> элемент в XML-шифровании, и присваивает cipherReference значение свойству CipherReference . Объект CipherReference представляет <CipherReference> элемент , который предоставляет расположение зашифрованных данных.

Примечание

Объект CipherData может иметь либо свойство, CipherReference либо CipherValue свойство, но не оба свойства. Если CryptographicException объекту CipherData назначены оба объекта, возникает исключение .

Применяется к

.NET 10 (package-provided) и другие версии
Продукт Версии
.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