XmlLicenseTransform

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

XmlLicenseTransform クラス

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

XrML ライセンスを署名用に正規化するためのライセンス変換アルゴリズムを表します。

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

Visual Basic (宣言)

Public Class XmlLicenseTransform
    Inherits Transform

Visual Basic (使用法)

Dim instance As XmlLicenseTransform

C#

public class XmlLicenseTransform : Transform

C++

public ref class XmlLicenseTransform : public
 Transform

J#

public class XmlLicenseTransform extends Transform

JScript

public class XmlLicenseTransform extends
 Transform

解説

XmlLicenseTransform クラスは、MPEG REL (MPEG Rights Extension Language) で定義されているライセンス変換アルゴリズムを表します。

XrML を署名用に変換するには、XmlLicenseTransform クラスを使用します。

XmlLicenseTransform クラスを識別する URI (Uniform Resource Identifier) は、XmlLicenseTransformUrl フィールドによって定義されます。

使用例

次のコード例は、IRelDecryptor インターフェイスと XmlLicenseTransform クラスを使用して XML デジタル署名を検証する方法を示しています。

C#

public static void CheckSignatureWithEncryptedGrant(string
 fileName, IRelDecryptor decryptor)
{
    // Create a new XML document.
    XmlDocument xmlDocument = new XmlDocument();
    XmlNamespaceManager nsManager = new XmlNamespaceManager(xmlDocument.NameTable);

    // Format using whitespaces.
    xmlDocument.PreserveWhitespace = true;

    // Load the passed XML file into the document. 
    xmlDocument.Load(fileName);
    nsManager.AddNamespace("dsig", SignedXml.XmlDsigNamespaceUrl);

    // Find the "Signature" node and create a new XmlNodeList
 object.
    XmlNodeList nodeList = xmlDocument.SelectNodes("//dsig:Signature",
 nsManager);

    for (int i = 0, count = nodeList.Count;
 i < count; i++)
    {
        XmlDocument clone = xmlDocument.Clone() as XmlDocument;
        XmlNodeList signatures = clone.SelectNodes("//dsig:Signature",
 nsManager);

        // Create a new SignedXml object and pass into it the XML document
 clone.
        SignedXml signedXml = new SignedXml(clone);

        // Load the signature node.
        signedXml.LoadXml((XmlElement)signatures[i]);

        // Set the context for license transform
        Transform trans = ((Reference)signedXml.SignedInfo.References[0]).TransformChain[0];

        if (trans is XmlLicenseTransform)
        {

            // Decryptor is used to decrypt encryptedGrant elements.
            if (decryptor != null)
                (trans as XmlLicenseTransform).Decryptor = decryptor;
        }

        // Check the signature and display the result.
        bool result = signedXml.CheckSignature();

        if (result)
            Console.WriteLine("SUCCESS: CheckSignatureWithEncryptedGrant - issuer
 index #" +
                                            i.ToString());
        else
            Console.WriteLine("FAILURE: CheckSignatureWithEncryptedGrant - issuer
 index #" +
                                            i.ToString());
    }

}

C++

void CheckSignatureWithEncryptedGrant(
    String^ fileName, IRelDecryptor^ decryptor)
{
    // Create a new XML document.
    XmlDocument^ sourceDocument = gcnew XmlDocument();
    XmlNamespaceManager^ namespaceManager =
        gcnew XmlNamespaceManager(sourceDocument->NameTable);

    // Format using whitespaces.
    sourceDocument->PreserveWhitespace = true;

    // Load the passed XML file into the document.
    sourceDocument->Load(fileName);
    namespaceManager->AddNamespace("dsig",
        SignedXml::XmlDsigNamespaceUrl);

    // Find the "Signature" node and create a new
    // XmlNodeList object.
    XmlNodeList^ nodeList = 
        sourceDocument->SelectNodes("//dsig:Signature",
 namespaceManager);

    for (int i = 0, count = nodeList->Count;
 i < count; i++)
    {
        XmlDocument^ clone = (XmlDocument^) sourceDocument->Clone();
        XmlNodeList^ signatures =
            clone->SelectNodes("//dsig:Signature", namespaceManager);

        // Create a new SignedXml object and pass into it the
        // XML document clone.
        SignedXml^ signedDocument = gcnew SignedXml(clone);

        // Load the signature node.
        signedDocument->LoadXml((XmlElement^)signatures[i]);

        // Set the context for license transform
        Transform^ licenseTransform = ((Reference^)signedDocument->
            SignedInfo->References[0])->TransformChain[0];

        if ((licenseTransform::typeid == XmlLicenseTransform::typeid)
 
            && (decryptor != nullptr))
        {
            // Decryptor is used to decrypt encryptedGrant
            // elements.
            ((XmlLicenseTransform^) licenseTransform)->Decryptor = decryptor;
        }

        // Check the signature and display the result.
        if (signedDocument->CheckSignature())
        {
            Console::WriteLine("SUCCESS: " +
                "CheckSignatureWithEncryptedGrant - issuer index #" + i);
        }
        else
        {
            Console::WriteLine("FAILURE: " +
                "CheckSignatureWithEncryptedGrant - issuer index #" + i);
        }
    }
}

継承階層

System.Object
   System.Security.Cryptography.Xml.Transform
    System.Security.Cryptography.Xml.XmlLicenseTransform

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
XmlLicenseTransform メンバ
System.Security.Cryptography.Xml 名前空間

XmlLicenseTransform コンストラクタ

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

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New XmlLicenseTransform

C#

public XmlLicenseTransform ()

C++

public:
XmlLicenseTransform ()

J#

public XmlLicenseTransform ()

JScript

public function XmlLicenseTransform ()

プラットフォーム

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

参照

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

XmlLicenseTransform プロパティ

パブリック プロパティ

	名前	説明
	Algorithm	現在の変換で実行されているアルゴリズムを識別する URI (Uniform Resource Identifier) を取得または設定します。 ( Transform から継承されます。)
	Context	現在の Transform オブジェクトが実行されているドキュメント コンテキストを表す XmlElement オブジェクトを取得または設定します。 ( Transform から継承されます。)
	Decryptor	現在の XmlLicenseTransform の 復号化機能を取得または設定します。
	InputTypes	オーバーライドされます。 現在の XmlLicenseTransform オブジェクトの OutputTypes メソッドに入力できる型の配列を取得します。
	OutputTypes	オーバーライドされます。 現在の XmlLicenseTransform オブジェクト の OutputTypes メソッドから出力できる型の配列を取得します。
	PropagatedNamespaces	署名に反映させる名前空間を格納する Hashtable オブジェクトを取得または設定します。 ( Transform から継承されます。)
	Resolver	現在の XmlResolver オブジェクトを設定します。 ( Transform から継承されます。)

参照

関連項目

XmlLicenseTransform クラス
System.Security.Cryptography.Xml 名前空間

XmlLicenseTransform メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetDigestedOutput	派生クラスでオーバーライドされた場合は、Transform オブジェクトに関連付けられているダイジェストを返します。 ( Transform から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetOutput	オーバーロードされます。 オーバーライドされます。 XmlLicenseTransform オブジェクトの出力を返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetXml	現在の Transform オブジェクトの XML 表現を返します。 ( Transform から継承されます。)
	LoadInnerXml	オーバーライドされます。 指定した XmlNodeList オブジェクトを <Transform> 要素の変換に固有な内容として解析します。XmlLicenseTransform オブジェクトは内部 XML 要素を持たないため、このメソッドはサポートされません。
	LoadInput	オーバーライドされます。 指定した入力を現在の XmlLicenseTransform オブジェクトに読み込みます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetInnerXml	オーバーライドされます。 XMLDSIG <Transform> 要素のサブ要素として含めるのに適した、XmlLicenseTransform オブジェクトのパラメータの XML 表現を返します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

XmlLicenseTransform クラス
System.Security.Cryptography.Xml 名前空間

XmlLicenseTransform メンバ

XrML ライセンスを署名用に正規化するためのライセンス変換アルゴリズムを表します。

XmlLicenseTransform データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	XmlLicenseTransform	XmlLicenseTransform クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Algorithm	現在の変換で実行されているアルゴリズムを識別する URI (Uniform Resource Identifier) を取得または設定します。(Transform から継承されます。)
	Context	現在の Transform オブジェクトが実行されているドキュメント コンテキストを表す XmlElement オブジェクトを取得または設定します。 (Transform から継承されます。)
	Decryptor	現在の XmlLicenseTransform の 復号化機能を取得または設定します。
	InputTypes	オーバーライドされます。 現在の XmlLicenseTransform オブジェクトの OutputTypes メソッドに入力できる型の配列を取得します。
	OutputTypes	オーバーライドされます。 現在の XmlLicenseTransform オブジェクト の OutputTypes メソッドから出力できる型の配列を取得します。
	PropagatedNamespaces	署名に反映させる名前空間を格納する Hashtable オブジェクトを取得または設定します。 (Transform から継承されます。)
	Resolver	現在の XmlResolver オブジェクトを設定します。(Transform から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetDigestedOutput	派生クラスでオーバーライドされた場合は、Transform オブジェクトに関連付けられているダイジェストを返します。 (Transform から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetOutput	オーバーロードされます。 オーバーライドされます。 XmlLicenseTransform オブジェクトの出力を返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetXml	現在の Transform オブジェクトの XML 表現を返します。 (Transform から継承されます。)
	LoadInnerXml	オーバーライドされます。 指定した XmlNodeList オブジェクトを <Transform> 要素の変換に固有な内容として解析します。XmlLicenseTransform オブジェクトは内部 XML 要素を持たないため、このメソッドはサポートされません。
	LoadInput	オーバーライドされます。 指定した入力を現在の XmlLicenseTransform オブジェクトに読み込みます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetInnerXml	オーバーライドされます。 XMLDSIG <Transform> 要素のサブ要素として含めるのに適した、XmlLicenseTransform オブジェクトのパラメータの XML 表現を返します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

XmlLicenseTransform クラス
System.Security.Cryptography.Xml 名前空間