CipherData 생성자

정의

네임스페이스:

System.Security.Cryptography.Xml

어셈블리:

System.Security.Cryptography.Xml.dll

CipherData 클래스의 새 인스턴스를 초기화합니다.

오버로드

CipherData()	CipherData 클래스의 새 인스턴스를 초기화합니다.
CipherData(Byte[])	바이트 배열을 CipherData 값으로 사용하여 CipherValue 클래스의 새 인스턴스를 초기화합니다.
CipherData(CipherReference)	CipherData 개체를 사용하여 CipherReference 클래스의 새 인스턴스를 초기화합니다.

CipherData()

CipherData 클래스의 새 인스턴스를 초기화합니다.

public:
 CipherData();

public CipherData ();

Public Sub New ()

예제

다음 코드 예제에서는 CipherData 클래스의 새 인스턴스를 만드는 방법을 보여 줍니다. 전체 샘플을 찾을 수 있습니다는 CipherData 클래스 항목입니다.

// Create a new CipherData object.
CipherData^ cipher = gcnew CipherData();
// Assign a byte array to be the CipherValue. This is a
// byte array representing encrypted data.
cipher->CipherValue = gcnew array<Byte>(8);

// 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) {}

설명

이 생성자를 만듭니다는 CipherData 나타내는 개체를 <CipherData> XML 암호화의 요소입니다. <CipherData> XML 암호화의 필수 요소입니다.

CipherData(Byte[])

바이트 배열을 CipherData 값으로 사용하여 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())

매개 변수

cipherValue

Byte[]

<CipherValue> 요소에 사용할 암호화된 데이터입니다.

예외

ArgumentNullException

cipherValue 매개 변수가 null인 경우

CryptographicException

CipherValue 속성이 이미 설정되어 있는 경우

예제

다음 코드 예제에서는 CipherData 클래스의 새 인스턴스를 만드는 방법을 보여 줍니다.

// Create a new CipherData object using a byte array to represent encrypted data.
array<Byte>^sampledata = gcnew array<Byte>(8);
CipherData ^ cd = gcnew CipherData( sampledata );

// 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)

설명

이 생성자를 만듭니다는 CipherData 나타내는 개체를 <CipherData> XML 암호화의 요소입니다. 생성자를 할당 합니다 cipherValue 값을 CipherValue 실제 속성 데이터를 암호화 합니다.

참고

<CipherData> 요소 중 하나를 포함할 수 있습니다를 CipherReference 또는 CipherValue 자식 요소가 하나만 있습니다. A CryptographicException 둘 다에 할당 된 경우 throw 되는 CipherData 개체입니다.

CipherData(CipherReference)

CipherData 개체를 사용하여 CipherReference 클래스의 새 인스턴스를 초기화합니다.

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)

매개 변수

cipherReference

CipherReference

사용할 CipherReference 개체입니다.

예외

ArgumentNullException

cipherValue 매개 변수가 null인 경우

CryptographicException

CipherValue 속성이 이미 설정되어 있는 경우

예제

다음 코드 예제에는의 새 인스턴스를 만드는 방법을 보여 줍니다 합니다 CipherData 클래스를 사용 하 여 CipherReference 정보입니다.

#using <System.Xml.dll>
#using <System.Security.dll>
#using <System.dll>

using namespace System;
using namespace System::Security::Cryptography::Xml;
using namespace System::Xml;
using namespace 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.

[STAThread]
int main()
{
   
   //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 = gcnew XmlDsigBase64Transform;
   
   //Create a transform chain and add the transform to it.
   TransformChain^ tc = gcnew TransformChain;
   tc->Add( base64 );
   
   //Create <CipherReference> information.
   CipherReference ^ reference = gcnew 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 = gcnew CipherData( reference );
   
   // Create a new EncryptedData object.
   EncryptedData^ ed = gcnew EncryptedData;
   
   //Add an encryption method to the object.
   ed->Id = "ED";
   ed->EncryptionMethod = gcnew EncryptionMethod( "http://www.w3.org/2001/04/xmlenc#aes128-cbc" );
   ed->CipherData = cd;
   
   //Add key information to the object.
   KeyInfo^ ki = gcnew KeyInfo;
   ki->AddClause( gcnew 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 = gcnew XmlDocument;
   XmlElement^ encryptionPropertyElement = dynamic_cast<XmlElement^>(doc->CreateElement( "EncryptionProperty", EncryptedXml::XmlEncNamespaceUrl ));
   EncryptionProperty ^ ep = gcnew 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 );
   }

}

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

설명

이 생성자를 만듭니다는 CipherData 나타내는 개체를 <CipherData> XML 암호화 요소 할당을 cipherReference 값을 CipherReference 속성. 합니다 CipherReference 개체가 나타내는 <CipherReference> 암호화 된 데이터의 위치를 제공 하는 요소입니다.

참고

CipherData 개체 중 하나를 가질 수는 CipherReference 속성 또는 CipherValue 속성, 하지만 둘 다. A CryptographicException 둘 다에 할당 된 경우 throw 되는 CipherData 개체입니다.