CipherData Constructores

Definición

Espacio de nombres:

System.Security.Cryptography.Xml

Ensamblado:

System.Security.Cryptography.Xml.dll

Inicializa una nueva instancia de la clase CipherData.

Sobrecargas

Nombre	Description
CipherData()	Inicializa una nueva instancia de la clase CipherData.
CipherData(Byte[])	Inicializa una nueva instancia de la CipherData clase utilizando una matriz de bytes como valor CipherValue .
CipherData(CipherReference)	Inicializa una nueva instancia de la CipherData clase mediante un CipherReference objeto .

CipherData()

Source:

CipherData.cs

Inicializa una nueva instancia de la clase CipherData.

public:
 CipherData();

public CipherData();

Public Sub New ()

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una nueva instancia de la CipherData clase . El ejemplo completo se puede encontrar en el tema de clase CipherData .

// 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 CipherData object.
Dim cd As New CipherData
' Assign a byte array to the CipherValue.
cd.CipherValue = New Byte(7) {}

Comentarios

Este constructor crea un CipherData objeto que representa el elemento en el <CipherData> cifrado XML. El <CipherData> elemento es un elemento necesario en el cifrado XML.

CipherData(Byte[])

Source:

CipherData.cs

Inicializa una nueva instancia de la CipherData clase utilizando una matriz de bytes como valor CipherValue .

public:
 CipherData(cli::array <System::Byte> ^ cipherValue);

public CipherData(byte[] cipherValue);

new System.Security.Cryptography.Xml.CipherData : byte[] -> System.Security.Cryptography.Xml.CipherData

Public Sub New (cipherValue As Byte())

Parámetros

cipherValue

Byte[]

Datos cifrados que se van a usar para el <CipherValue> elemento .

Excepciones

ArgumentNullException

El cipherValue parámetro es null.

CryptographicException

La CipherValue propiedad ya se ha establecido.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una nueva instancia de la CipherData clase .

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

    ' Create a new CipherData object using a byte array to represent encrypted data.
Dim sampledata(7) As Byte
    Dim cd As New CipherData(sampledata)

Comentarios

Este constructor crea un CipherData objeto que representa el elemento en el <CipherData> cifrado XML. El constructor asigna el cipherValue valor a la CipherValue propiedad como los datos cifrados reales.

Nota:

El <CipherData> elemento puede tener un CipherReference elemento secundario o CipherValue , pero no ambos. Se produce una CryptographicException excepción si ambos se asignan a un CipherData objeto .

CipherData(CipherReference)

Source:

CipherData.cs

Inicializa una nueva instancia de la CipherData clase mediante un CipherReference objeto .

public:
 CipherData(System::Security::Cryptography::Xml::CipherReference ^ cipherReference);

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

new System.Security.Cryptography.Xml.CipherData : System.Security.Cryptography.Xml.CipherReference -> System.Security.Cryptography.Xml.CipherData

Public Sub New (cipherReference As CipherReference)

Parámetros

cipherReference

CipherReference

Objeto CipherReference que se va a usar.

Excepciones

ArgumentNullException

El cipherReference parámetro es null.

CryptographicException

La CipherValue propiedad ya se ha establecido.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una nueva instancia de la CipherData clase mediante CipherReference información.

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

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. It demonstrates the use of CipherReference.
Module Module1

    Sub Main()
        ' Create a URI string.
        Dim uri As String = "http://www.woodgrovebank.com/document.xml"
        ' Create a Base64 transform. The input content retrieved from the
        ' URI should be Base64-decoded before other processing.
        Dim base64 As Transform = New XmlDsigBase64Transform
        Dim tc As New TransformChain
        tc.Add(base64)
        ' Create <CipherReference> information.
        Dim reference As CipherReference = New CipherReference(uri, tc)

        ' Create a new CipherData object.
        ' Note that you cannot assign both a CipherReference and a CipherValue
        ' to a CipherData object.
        Dim cd As CipherData = New CipherData(Reference)

        ' 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 Module

Comentarios

Este constructor crea un CipherData objeto que representa el <CipherData> elemento en el cifrado XML y asigna el cipherReference valor a la CipherReference propiedad . El CipherReference objeto representa el <CipherReference> elemento , que proporciona la ubicación de los datos cifrados.

Nota:

Un CipherData objeto puede tener una CipherReference propiedad o una CipherValue propiedad, pero no ambas. Se produce una CryptographicException excepción si ambos se asignan a un CipherData objeto .