RegistryPermission.AddPathList Metode

Definisi

Ruang nama:

System.Security.Permissions

Rakitan:

System.Security.Permissions.dll

Paket:

System.Security.Permissions v9.0.0-preview.3.24172.9

Menambahkan akses untuk variabel registri yang ditentukan ke status izin yang ada.

Overload

AddPathList(RegistryPermissionAccess, String)	Menambahkan akses untuk variabel registri yang ditentukan ke status izin yang ada.
AddPathList(RegistryPermissionAccess, AccessControlActions, String)	Menambahkan akses untuk variabel registri yang ditentukan ke status izin yang ada, menentukan akses izin registri dan tindakan kontrol akses.

Keterangan

Gunakan metode ini untuk mengubah akses ke variabel registri dengan menambahkan kumpulan jalurnya ke status objek izin saat ini.

AddPathList(RegistryPermissionAccess, String)

Sumber:

RegistryPermission.cs

Menambahkan akses untuk variabel registri yang ditentukan ke status izin yang ada.

public:
 void AddPathList(System::Security::Permissions::RegistryPermissionAccess access, System::String ^ pathList);

public void AddPathList (System.Security.Permissions.RegistryPermissionAccess access, string pathList);

member this.AddPathList : System.Security.Permissions.RegistryPermissionAccess * string -> unit

Public Sub AddPathList (access As RegistryPermissionAccess, pathList As String)

Parameter

access

RegistryPermissionAccess

Salah RegistryPermissionAccess satu nilai.

pathList

String

Daftar variabel registri (dipisahkan titik koma).

Pengecualian

ArgumentException

Parameter access bukan nilai yang valid dari RegistryPermissionAccess.

-atau-

Parameter pathList bukan string yang valid.

Contoh

Contoh kode berikut menunjukkan penggunaan AddPathList(RegistryPermissionAccess, String) metode .

// AddPathList adds access for the specified registry variables to the existing state of the permission.
// SetPathList sets new access for the specified registry variable names to the existing state of the permission.
// GetPathList gets paths for all registry variables with the specified RegistryPermissionAccess.
private static bool SetGetPathListDemo()
{
    try
    {
        Console.WriteLine("********************************************************\n");
        RegistryPermission readPerm1;
        Console.WriteLine("Creating RegistryPermission with AllAccess rights for 'HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\CentralProcessor\\0'");
        readPerm1 = new RegistryPermission(RegistryPermissionAccess.AllAccess, "HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\CentralProcessor\\0");
        Console.WriteLine("Adding 'HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION' to the write access list, "
            + "and \n 'HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\FloatingPointProcessor\\0' "
            + "to the read access list.");
        readPerm1.AddPathList(RegistryPermissionAccess.Write, "HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION");
        readPerm1.AddPathList(RegistryPermissionAccess.Read,
            "HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\FloatingPointProcessor\\0");
        Console.WriteLine("Read access list before SetPathList = " +
            readPerm1.GetPathList(RegistryPermissionAccess.Read));
        Console.WriteLine("Setting read access rights to \n'HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\CentralProcessor\\0'");
        readPerm1.SetPathList(RegistryPermissionAccess.Read,
            "HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\CentralProcessor\\0");
        Console.WriteLine("Read access list after SetPathList = \n" +
            readPerm1.GetPathList(RegistryPermissionAccess.Read));
        Console.WriteLine("Write access = \n" +
            readPerm1.GetPathList(RegistryPermissionAccess.Write));
        Console.WriteLine("Write access Registry variables = \n" +
            readPerm1.GetPathList(RegistryPermissionAccess.AllAccess));
    }
    catch (ArgumentException e)
    {
        // RegistryPermissionAccess.AllAccess can not be used as a parameter for GetPathList.
        Console.WriteLine("An ArgumentException occurred as a result of using AllAccess. "
            + "AllAccess cannot be used as a parameter in GetPathList because it represents more than one "
            + "type of registry variable access : \n" + e);
    }

    return true;
}

' AddPathList adds access for the specified registry variables to the existing state of the permission.
' SetPathList sets new access for the specified registry variable names to the existing state of the permission.
' GetPathList gets paths for all registry variables with the specified RegistryPermissionAccess.
Private Shared Function SetGetPathListDemo() As Boolean
    Try
        Console.WriteLine("********************************************************" + vbLf)
        Dim readPerm1 As RegistryPermission
        Console.WriteLine("Creating RegistryPermission with AllAccess rights for 'HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\CentralProcessor\0'")
        readPerm1 = New RegistryPermission(RegistryPermissionAccess.AllAccess, "HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\CentralProcessor\0")
        Console.WriteLine("Adding 'HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION' to the write access list, " + "and " + vbLf + " 'HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\FloatingPointProcessor\0' " + "to the read access list.")
        readPerm1.AddPathList(RegistryPermissionAccess.Write, "HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION")
        readPerm1.AddPathList(RegistryPermissionAccess.Read, "HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\FloatingPointProcessor\0")
        Console.WriteLine("Read access list before SetPathList = " + readPerm1.GetPathList(RegistryPermissionAccess.Read))
        Console.WriteLine("Setting read access rights to " + vbLf + "'HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\CentralProcessor\0'")
        readPerm1.SetPathList(RegistryPermissionAccess.Read, "HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\CentralProcessor\0")
        Console.WriteLine("Read access list after SetPathList = " + vbLf + readPerm1.GetPathList(RegistryPermissionAccess.Read))
        Console.WriteLine("Write access = " + vbLf + readPerm1.GetPathList(RegistryPermissionAccess.Write))
        Console.WriteLine("Write access Registry variables = " + vbLf + readPerm1.GetPathList(RegistryPermissionAccess.AllAccess))
    Catch e As ArgumentException
        ' RegistryPermissionAccess.AllAccess can not be used as a parameter for GetPathList.
        Console.WriteLine("An ArgumentException occurred as a result of using AllAccess. " + _
        "AllAccess cannot be used as a parameter in GetPathList because it represents more than one " + _
        "type of registry variable access : " + vbLf + e.Message)
    End Try

    Return True

End Function 'SetGetPathListDemo

Keterangan

Gunakan metode ini untuk mengubah akses ke variabel registri dengan menambahkan ke status objek izin saat ini.

AddPathList(RegistryPermissionAccess, AccessControlActions, String)

Sumber:

RegistryPermission.cs

Menambahkan akses untuk variabel registri yang ditentukan ke status izin yang ada, menentukan akses izin registri dan tindakan kontrol akses.

public:
 void AddPathList(System::Security::Permissions::RegistryPermissionAccess access, System::Security::AccessControl::AccessControlActions actions, System::String ^ pathList);

public void AddPathList (System.Security.Permissions.RegistryPermissionAccess access, System.Security.AccessControl.AccessControlActions actions, string pathList);

member this.AddPathList : System.Security.Permissions.RegistryPermissionAccess * System.Security.AccessControl.AccessControlActions * string -> unit

Public Sub AddPathList (access As RegistryPermissionAccess, actions As AccessControlActions, pathList As String)

Parameter

access

RegistryPermissionAccess

Salah RegistryPermissionAccess satu nilai.

actions

AccessControlActions

Salah AccessControlActions satu nilai.

pathList

String

Daftar variabel registri (dipisahkan oleh titik koma).

Pengecualian

ArgumentException

Parameter access bukan nilai yang valid dari RegistryPermissionAccess.

-atau-

Parameter pathList bukan string yang valid.

Keterangan

Gunakan metode ini untuk mengubah akses ke variabel registri dengan menambahkan kumpulan jalurnya ke status objek izin saat ini. Kelebihan beban ini memungkinkan Anda menentukan tindakan kontrol akses seperti halnya akses izin registri.

Parameter control menentukan apakah daftar kontrol akses (ACL) untuk kunci registri yang ditentukan pathList dapat diubah, dilihat, atau tidak dapat diakses.

Penting

Daftar kontrol akses (ACL) menjelaskan individu atau grup yang memiliki, atau tidak memiliki, hak atas tindakan tertentu pada kunci registri yang ditentukan. Kemampuan untuk mengubah atau melihat ACL adalah izin penting dan harus diberikan dengan hati-hati.