CipherData コンストラクタ

.NET Framework クラス ライブラリ リファレンス

CipherData コンストラクタ (CipherReference)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

CipherReference オブジェクトを使用して CipherData クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Cryptography.Xml
アセンブリ: System.Security (system.security.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    cipherReference As CipherReference _
)

Visual Basic (使用法)

Dim cipherReference As CipherReference

Dim instance As New CipherData(cipherReference)

C#

public CipherData (
    CipherReference cipherReference
)

C++

public:
CipherData (
    CipherReference^ cipherReference
)

J#

public CipherData (
    CipherReference cipherReference
)

JScript

public function CipherData (
    cipherReference : CipherReference
)

パラメータ

cipherReference

使用する CipherReference オブジェクト。

例外

例外の種類	条件
ArgumentNullException	cipherValue パラメータが null 参照 (Visual Basic では Nothing) です。
CryptographicException	CipherValue プロパティが既に設定されています。

解説

このコンストラクタは、XML 暗号化の <CipherData> 要素を表す CipherData オブジェクトを作成し、cipherReference 値を CipherReference プロパティに割り当てます。CipherReference オブジェクトは、暗号化されたデータの場所を提供する <CipherReference> 要素を表します。

メモ
CipherData オブジェクトは、CipherReference または CipherValue のどちらかのプロパティを持つことができます。両方のプロパティを持つことはできません。両方が CipherData オブジェクトに割り当てられている場合は、CryptographicException がスローされます。

使用例

CipherReference 情報を使用して CipherData クラスの新しいインスタンスを作成する方法を次のコード例に示します。

Visual Basic

Imports System
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

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 Sample1
    {
        [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);
            }

        }
    }
}

C++

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

}

J#

package EncryptedDataSample;

import System.*;
import System.Security.Cryptography.Xml.*;
import System.Xml.*;
import 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.
class Sample1
{
    /** @attribute STAThread()
     */
    public 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.set_Id("ED");
        ed.set_EncryptionMethod(new EncryptionMethod(
            "http://www.w3.org/2001/04/xmlenc#aes128-cbc"));
        ed.set_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.set_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().get_OuterXml());
        }
        catch (IOException e) {
            Console.WriteLine("File IO error. {0}", e);
        }
    } //main
} //Sample1

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
CipherData クラス
CipherData メンバ
System.Security.Cryptography.Xml 名前空間

CipherData コンストラクタ

CipherData クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
CipherData ()	CipherData クラスの新しいインスタンスを初期化します。
CipherData (Byte[])	バイト配列を CipherValue 値として使用して、CipherData クラスの新しいインスタンスを初期化します。
CipherData (CipherReference)	CipherReference オブジェクトを使用して CipherData クラスの新しいインスタンスを初期化します。

参照

関連項目

CipherData クラス
CipherData メンバ
System.Security.Cryptography.Xml 名前空間

CipherData コンストラクタ (Byte[])

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

バイト配列を CipherValue 値として使用して、CipherData クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Cryptography.Xml
アセンブリ: System.Security (system.security.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    cipherValue As Byte() _
)

Visual Basic (使用法)

Dim cipherValue As Byte()

Dim instance As New CipherData(cipherValue)

C#

public CipherData (
    byte[] cipherValue
)

C++

public:
CipherData (
    array<unsigned char>^ cipherValue
)

J#

public CipherData (
    byte[] cipherValue
)

JScript

public function CipherData (
    cipherValue : byte[]
)

パラメータ

cipherValue

<CipherValue> 要素に対して使用する暗号化されたデータ。

例外

例外の種類	条件
ArgumentNullException	cipherValue パラメータが null 参照 (Visual Basic では Nothing) です。
CryptographicException	CipherValue プロパティが既に設定されています。

解説

このコンストラクタは、XML 暗号化の <CipherData> 要素を表す CipherData オブジェクトを作成します。このコンストラクタは、cipherValue 値を実際の暗号化されたデータとして CipherValue プロパティに割り当てます。

メモ
<CipherData> 要素は、CipherReference または CipherValue のどちらかの子要素を持つことができます。両方の子要素を持つことはできません。両方が CipherData オブジェクトに割り当てられている場合は、CryptographicException がスローされます。

使用例

CipherData クラスの新しいインスタンスを作成する方法を次のコード例に示します。

Visual Basic

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

C#

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

C++

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

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
CipherData クラス
CipherData メンバ
System.Security.Cryptography.Xml 名前空間

CipherData コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

CipherData クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Cryptography.Xml
アセンブリ: System.Security (system.security.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New CipherData

C#

public CipherData ()

C++

public:
CipherData ()

J#

public CipherData ()

JScript

public function CipherData ()

解説

このコンストラクタは、XML 暗号化の <CipherData> 要素を表す CipherData オブジェクトを作成します。<CipherData> 要素は XML 暗号化の必須の要素です。

使用例

CipherData クラスの新しいインスタンスを作成する方法を次のコード例に示します。このサンプルは、CipherData クラスのトピックにあります。

Visual Basic

' Create a new CipherData object.
Dim cd As New CipherData
' Assign a byte array to the CipherValue.
cd.CipherValue = New Byte(7) {}

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

C++

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
CipherData クラス
CipherData メンバ
System.Security.Cryptography.Xml 名前空間