FileIOPermissionAttribute.PathDiscovery Property

Definition

Namespace:

System.Security.Permissions

Assembly:

System.Security.Permissions.dll

Package:

System.Security.Permissions v9.0.0-rc.2.24473.5

Source:

FileIOPermissionAttribute.cs

Gets or sets the file or directory to which to grant path discovery.

public:
 property System::String ^ PathDiscovery { System::String ^ get(); void set(System::String ^ value); };

public string PathDiscovery { get; set; }

member this.PathDiscovery : string with get, set

Public Property PathDiscovery As String

Property Value

String

The absolute path of the file or directory.

Examples

The following code example sets the PathDiscovery property to grant PathDiscovery access to files in the specified directory.

// Set the PathDiscovery property.
[FileIOPermissionAttribute(SecurityAction::PermitOnly,
PathDiscovery="C:\\Documents and Settings\\All Users")]

// Set the PathDiscovery property.
[FileIOPermissionAttribute(SecurityAction.PermitOnly,
     PathDiscovery = "C:\\Documents and Settings\\All Users")]

' Set the Read, PathDiscovery, Append, Write, and All properties.
<FileIOPermissionAttribute(SecurityAction.PermitOnly, Read:="C:\"), _
FileIOPermissionAttribute(SecurityAction.PermitOnly, _
PathDiscovery:="C:\Documents and Settings\All Users"), _
FileIOPermissionAttribute(SecurityAction.PermitOnly, _
Append:="C:\Documents and Settings\All Users\Application Data"), _
FileIOPermissionAttribute(SecurityAction.PermitOnly, _
    Write:="C:\Documents and Settings\All Users\Application Data\Microsoft"), _
FileIOPermissionAttribute(SecurityAction.PermitOnly, _
    All:="C:\Documents and Settings\All Users\Application Data\Microsoft\Network")> _
Public Shared Sub PermitOnlyMethod()

Remarks

Path discovery controls access to the information in the path itself. This helps protect sensitive information in the path, such as user names, as well as information about the directory structure revealed in the path. This value does not grant access to files or folders represented by the path.

Note

For performance reasons, PathDiscovery should be granted only to directories, not to files. For example, PathDiscovery permission should be granted to paths such as C:\test and C:\test\, not to files such as C:\test\example.txt.

This property sets access for a single file or directory. Use additional attributes to specify additional files and directories.