RegistryKeyPermissionCheck 列挙型

定義

レジストリ キーを開いて名前/値ペアにアクセスするときに、セキュリティ チェックを行うかどうかを指定します。

public enum class RegistryKeyPermissionCheck
public enum RegistryKeyPermissionCheck
type RegistryKeyPermissionCheck = 
Public Enum RegistryKeyPermissionCheck
継承
RegistryKeyPermissionCheck

フィールド

Default 0

レジストリ キーは親のモードを継承します。 親が ReadSubTree モードまたは ReadWriteSubTree モードで開かれていない限り、サブキーまたは値にアクセスしようしたときにセキュリティ チェックが行われます。

ReadSubTree 1

サブキーまたは値にアクセスしようしたときにセキュリティ チェックは行われません。 親が ReadSubTree または ReadWriteSubTree で開かれていない限り、現在のキーを開こうとしたときにセキュリティ チェックが行われます。

ReadWriteSubTree 2

サブキーまたは値にアクセスしようしたときにセキュリティ チェックは行われません。 親が ReadWriteSubTree で開かれていない限り、現在のキーを開こうとしたときにセキュリティ チェックが行われます。

次のコード例では、100 個のキーと値のペアを含むサブキーを作成して閉じます。 次の使用例は、Default でサブキーを開き、すべての値の読み取りにかかる時間を記録します。 次に、ReadSubTree でサブキーを開き、すべての値の読み取りにかかる時間を記録します。 最後に、この例では改善率を計算して表示します。

using System;
using Microsoft.Win32;
using System.Diagnostics;

public class Example
{
    public static void Main()
    {
        const int LIMIT = 100;
        RegistryKey cu = Registry.CurrentUser;
        const string testKey = "RegistryKeyPermissionCheckExample";

        Console.WriteLine("Generating {0} key/value pairs.", LIMIT);
        RegistryKey rk = cu.CreateSubKey(testKey);
        for (int i = 0; i < LIMIT; i++)
        {
            rk.SetValue("Key" + i, i);
        }

        rk.Close();

        Stopwatch s = new Stopwatch();

        // On the default setting, security is checked every time
        // a key/value pair is read.
        rk = cu.OpenSubKey(testKey, RegistryKeyPermissionCheck.Default);

        s.Start();
        for (int i = 0; i < LIMIT; i++)
        {
            rk.GetValue("Key" + i, i);
        }
        s.Stop();
        rk.Close();
        long delta1 = s.ElapsedTicks;

        s.Reset();

        // When the key is opened with ReadSubTree, security is
        // not checked when the values are read.
        rk = cu.OpenSubKey(testKey, RegistryKeyPermissionCheck.ReadSubTree);

        s.Start();
        for (int i = 0; i < LIMIT; i++)
        {
            rk.GetValue("Key" + i, i);
        }
        s.Stop();
        rk.Close();
        long delta2 = s.ElapsedTicks;

        double faster = (double) (delta1 - delta2) / (double) delta1;
        Console.WriteLine("ReadSubTree is {0}% faster for {1} values.",
            (faster * 100).ToString("0.0"), LIMIT);

        cu.DeleteSubKey(testKey);
    }
}

/* This code example produces output similar to the following:

Generating 100 key/value pairs.
ReadSubTree is 23.4% faster for 100 values.
 */
Imports Microsoft.Win32
Imports System.Diagnostics

Public Class Example
    
    Public Shared Sub Main() 

        Const LIMIT As Integer = 100
        Dim cu As RegistryKey = Registry.CurrentUser
        Const testKey As String = "RegistryKeyPermissionCheckExample"
        
        Console.WriteLine("Generating {0} key/value pairs.", LIMIT)
        Dim rk As RegistryKey = cu.CreateSubKey(testKey)

        For i As Integer = 0 To LIMIT
            rk.SetValue("Key" & i, i)
        Next i
        
        rk.Close()
        
        Dim s As New Stopwatch()
        
        ' On the default setting, security is checked every time
        ' a key/value pair is read.
        rk = cu.OpenSubKey(testKey, _
            RegistryKeyPermissionCheck.Default)
        
        s.Start()
        For i As Integer = 0 To LIMIT
            rk.GetValue("Key" & i, i)
        Next i
        s.Stop()
        rk.Close()
        Dim delta1 As Long = s.ElapsedTicks
        
        s.Reset()
        
        ' When the key is opened with ReadSubTree, security is 
        ' not checked when the values are read.
        rk = cu.OpenSubKey(testKey, _
            RegistryKeyPermissionCheck.ReadSubTree)
        
        s.Start()
        For i As Integer = 0 To LIMIT
            rk.GetValue("Key" & i, i)
        Next i
        s.Stop()
        rk.Close()
        Dim delta2 As Long = s.ElapsedTicks
        
        Dim faster As Double = _
            CDbl(delta1 - delta2) * 100.0 / CDbl(delta1)
        Console.WriteLine("ReadSubTree is {0}% faster for {1} values.", _
            faster.ToString("0.0"), LIMIT)
        
        cu.DeleteSubKey(testKey)
    
    End Sub 
End Class 

' This code example produces output similar to the following:
'
'Generating 100 key/value pairs.
'ReadSubTree is 23.4% faster for 100 values.
'

注釈

アプリケーションが一連のサブキーから多数のレジストリ設定を保存または取得すると、多数の冗長なセキュリティ チェックが実行されます。 この列挙型は、キーのセキュリティ チェックを省略するタイミングを指定します。

次の表は、親キーと現在のキーを開く方法に基づいて、セキュリティ チェックが実行されるタイミングを示しています。

で開いた親キー で開かれた現在のキー 結果
Default Default セキュリティ チェックは、現在のキーの値にアクセスするとき、またはサブキーにアクセスしようとしたときに実行されます。 これは、.NET Framework バージョン 1.0 と 1.1 の動作です。
Default ReadSubTree 現在のキーを開こうとすると、セキュリティ チェックが実行されます。
Default ReadWriteSubTree 現在のキーを開こうとすると、セキュリティ チェックが実行されます。
ReadSubTree Default または ReadSubTree 現在のキーまたはその値を開くときにセキュリティ チェックは実行されません。
ReadSubTree ReadWriteSubTree 現在のキーを開こうとすると、セキュリティ チェックが実行されます。
ReadWriteSubTree Any 現在のキーまたはその値を開くときにセキュリティ チェックは実行されません。

適用対象