CipherData.CipherReference プロパティ

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

CipherData.CipherReference プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

<CipherReference> 要素を取得または設定します。

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

Visual Basic (宣言)

Public Property CipherReference As
 CipherReference

Visual Basic (使用法)

Dim instance As CipherData
Dim value As CipherReference

value = instance.CipherReference

instance.CipherReference = value

C#

public CipherReference CipherReference { get;
 set; }

C++

public:
property CipherReference^ CipherReference {
    CipherReference^ get ();
    void set (CipherReference^ value);
}

J#

/** @property */
public CipherReference get_CipherReference ()

/** @property */
public void set_CipherReference (CipherReference
 value)

JScript

public function get CipherReference
 () : CipherReference

public function set CipherReference
 (value : CipherReference)

プロパティ値
CipherReference オブジェクト。

例外

例外の種類	条件
ArgumentNullException	CipherReference プロパティが null 参照 (Visual Basic では Nothing) に設定されました。
CryptographicException	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 名前空間