CipherData クラス
アセンブリ: System.Security (system.security.dll 内)


CipherData クラスは、XML 暗号化の <CipherData> 要素を表します。これは、暗号化されたデータを提供する必須の要素です。この要素は、暗号化されたデータを <CipherValue> 要素の base64 でエンコードされたテキストとして格納するか、または暗号化されたデータを格納する外部の場所の参照を <CipherReference> 要素を使用して提供する必要があります。
多くの場合は、CipherData クラスの新しいインスタンスを直接作成する必要はありません。EncryptedXml クラス、EncryptedData クラス、および EncryptedKey クラスによってインスタンスが作成されます。
![]() |
---|
CipherData オブジェクトは、CipherReference または CipherValue のどちらかのプロパティを持つことができます。両方のプロパティを持つことはできません。両方が CipherData オブジェクトに割り当てられている場合は、CryptographicException がスローされます。 |

EncryptedData クラスを使用して <CipherData> 要素を含む <EncryptedData> 要素を作成した後、XML を XML ファイルに書き込むコード例を次に示します。
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. Module EncryptedDataSample1 Sub Main() ' Create a new CipherData object. Dim cd As New CipherData ' Assign a byte array to the CipherValue. cd.CipherValue = New Byte(7) {} ' 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 'Main 'Console.WriteLine(ed.GetXml().OuterXml); End Sub End Module
using System; using System.Security.Cryptography.Xml; using System.Xml; using System.IO; /// This sample used the EncryptedData class to create a EncryptedData element /// and write it to an XML file. namespace EncryptedDataSample { class Sample1 { [STAThread] static void Main(string[] args) { // 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 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. string path = @"c:\test\MyTest.xml"; File.WriteAllText(path,ed.GetXml().OuterXml); //Console.WriteLine(ed.GetXml().OuterXml); } } }
#using <System.Xml.dll> #using <System.Security.dll> using namespace System; using namespace System::Xml; using namespace System::Security::Cryptography; using namespace System::Security::Cryptography::Xml; using namespace System::IO; /// This sample used the EncryptedData class to create a EncryptedData element /// and write it to an XML file. int main() { // 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 EncryptedData object. EncryptedData^ encryptionRoot = gcnew EncryptedData(); //Add an encryption method to the object. encryptionRoot->Id = "ED"; encryptionRoot->EncryptionMethod = gcnew EncryptionMethod( "http://www.w3.org/2001/04/xmlenc#aes128-cbc"); encryptionRoot->CipherData = cipher; //Add key information to the object. KeyInfo^ keyDetails = gcnew KeyInfo(); keyDetails->AddClause(gcnew KeyInfoRetrievalMethod("#EK", "http://www.w3.org/2001/04/xmlenc#EncryptedKey")); encryptionRoot->KeyInfo = keyDetails; // Create new XML document and put encrypted data into it. XmlDocument^ doc = gcnew XmlDocument(); XmlElement^ encryptionPropertyElement = doc->CreateElement("EncryptionProperty", EncryptedXml::XmlEncNamespaceUrl); EncryptionProperty^ property = gcnew EncryptionProperty( encryptionPropertyElement); encryptionRoot->AddProperty(property); // Output the resulting XML information into a file. String^ path = "test.xml"; try { File::WriteAllText(path, encryptionRoot->GetXml()->OuterXml); } catch (IOException^ ex) { Console::WriteLine("There was an error writing to {0}", path); Console::WriteLine(ex->Message); } //Console.WriteLine(ed.GetXml().OuterXml); }

System.Security.Cryptography.Xml.CipherData


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CipherData コンストラクタ ()
アセンブリ: System.Security (system.security.dll 内)



CipherData クラスの新しいインスタンスを作成する方法を次のコード例に示します。このサンプルは、CipherData クラスのトピックにあります。
' Create a new CipherData object. Dim cd As New CipherData ' Assign a byte array to the CipherValue. cd.CipherValue = New Byte(7) {}

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CipherData コンストラクタ (CipherReference)
アセンブリ: System.Security (system.security.dll 内)



このコンストラクタは、XML 暗号化の <CipherData> 要素を表す CipherData オブジェクトを作成し、cipherReference 値を CipherReference プロパティに割り当てます。CipherReference オブジェクトは、暗号化されたデータの場所を提供する <CipherReference> 要素を表します。
![]() |
---|
CipherData オブジェクトは、CipherReference または CipherValue のどちらかのプロパティを持つことができます。両方のプロパティを持つことはできません。両方が CipherData オブジェクトに割り当てられている場合は、CryptographicException がスローされます。 |

CipherReference 情報を使用して CipherData クラスの新しいインスタンスを作成する方法を次のコード例に示します。
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
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); } } } }
#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 ); } }
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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CipherData コンストラクタ

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

CipherData コンストラクタ (Byte[])
アセンブリ: System.Security (system.security.dll 内)



このコンストラクタは、XML 暗号化の <CipherData> 要素を表す CipherData オブジェクトを作成します。このコンストラクタは、cipherValue 値を実際の暗号化されたデータとして CipherValue プロパティに割り当てます。
![]() |
---|
<CipherData> 要素は、CipherReference または CipherValue のどちらかの子要素を持つことができます。両方の子要素を持つことはできません。両方が CipherData オブジェクトに割り当てられている場合は、CryptographicException がスローされます。 |

CipherData クラスの新しいインスタンスを作成する方法を次のコード例に示します。
' Create a new CipherData object using a byte array to represent encrypted data. Dim sampledata(7) As Byte Dim cd As New 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);

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CipherData プロパティ
CipherData メソッド

名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
![]() | GetXml | CipherData オブジェクトの XML 値を取得します。 |
![]() | LoadXml | XML データを XmlElement から CipherData オブジェクトに読み込みます。 |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |

CipherData メンバ
XML 暗号化の <CipherData> 要素を表します。このクラスは継承できません。
CipherData データ型で公開されるメンバを以下の表に示します。



名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | GetXml | CipherData オブジェクトの XML 値を取得します。 |
![]() | LoadXml | XML データを XmlElement から CipherData オブジェクトに読み込みます。 |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |

Weblioに収録されているすべての辞書からCipherDataを検索する場合は、下記のリンクをクリックしてください。

- CipherDataのページへのリンク