Skip to content

Commit b0c8135

Browse files
gewarrengewarren
authored
Update GetAccessControl/SetAccessControl docs (dotnet#10005)
1 parent 3929508 commit b0c8135

File tree

21 files changed

+542
-573
lines changed

21 files changed

+542
-573
lines changed

‎snippets/csharp/System.IO/Directory/GetAccessControl/Project.csproj‎

Lines changed: 0 additions & 8 deletions
This file was deleted.

‎snippets/csharp/System.IO/DirectoryInfo/GetAccessControl/Project.csproj‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
<Project Sdk="Microsoft.NET.Sdk">
2+
3+
<PropertyGroup>
4+
<OutputType>Exe</OutputType>
5+
<TargetFramework>net8.0-windows</TargetFramework>
6+
</PropertyGroup>
7+
8+
</Project>

snippets/csharp/System.IO/Directory/GetAccessControl/sample.cs renamed to snippets/csharp/System.IO/DirectoryInfo/GetAccessControl/sample.cs

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -34,10 +34,15 @@ public static void Main()
3434
}
3535

3636
// Adds an ACL entry on the specified directory for the specified account.
37-
public static void AddDirectorySecurity(string DirectoryName, string Account, FileSystemRights Rights, AccessControlType ControlType)
37+
public static void AddDirectorySecurity(
38+
string DirectoryName,
39+
string Account,
40+
FileSystemRights Rights,
41+
AccessControlType ControlType
42+
)
3843
{
3944
// Create a new DirectoryInfo object.
40-
DirectoryInfo dInfo = new DirectoryInfo(DirectoryName);
45+
DirectoryInfo dInfo = new(DirectoryName);
4146

4247
// Get a DirectorySecurity object that represents the
4348
// current security settings.
@@ -53,10 +58,15 @@ public static void AddDirectorySecurity(string DirectoryName, string Account, Fi
5358
}
5459

5560
// Removes an ACL entry on the specified directory for the specified account.
56-
public static void RemoveDirectorySecurity(string DirectoryName, string Account, FileSystemRights Rights, AccessControlType ControlType)
61+
public static void RemoveDirectorySecurity(
62+
string DirectoryName,
63+
string Account,
64+
FileSystemRights Rights,
65+
AccessControlType ControlType
66+
)
5767
{
5868
// Create a new DirectoryInfo object.
59-
DirectoryInfo dInfo = new DirectoryInfo(DirectoryName);
69+
DirectoryInfo dInfo = new(DirectoryName);
6070

6171
// Get a DirectorySecurity object that represents the
6272
// current security settings.

‎snippets/csharp/System.IO/FileInfo/GetAccessControl/Project.csproj‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<Project Sdk="Microsoft.NET.Sdk">
22

33
<PropertyGroup>
4-
<OutputType>Library</OutputType>
5-
<TargetFramework>net6.0</TargetFramework>
4+
<OutputType>Exe</OutputType>
5+
<TargetFramework>net8.0-windows</TargetFramework>
66
</PropertyGroup>
77

88
</Project>

‎snippets/csharp/System.IO/FileInfo/GetAccessControl/sample.cs‎

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -38,10 +38,15 @@ public static void Main()
3838
}
3939

4040
// Adds an ACL entry on the specified file for the specified account.
41-
public static void AddFileSecurity(string FileName, string Account, FileSystemRights Rights, AccessControlType ControlType)
41+
public static void AddFileSecurity(
42+
string FileName,
43+
string Account,
44+
FileSystemRights Rights,
45+
AccessControlType ControlType
46+
)
4247
{
4348
// Create a new FileInfo object.
44-
FileInfo fInfo = new FileInfo(FileName);
49+
FileInfo fInfo = new(FileName);
4550

4651
// Get a FileSecurity object that represents the
4752
// current security settings.
@@ -57,10 +62,15 @@ public static void AddFileSecurity(string FileName, string Account, FileSystemRi
5762
}
5863

5964
// Removes an ACL entry on the specified file for the specified account.
60-
public static void RemoveFileSecurity(string FileName, string Account, FileSystemRights Rights, AccessControlType ControlType)
65+
public static void RemoveFileSecurity(
66+
string FileName,
67+
string Account,
68+
FileSystemRights Rights,
69+
AccessControlType ControlType
70+
)
6171
{
6272
// Create a new FileInfo object.
63-
FileInfo fInfo = new FileInfo(FileName);
73+
FileInfo fInfo = new(FileName);
6474

6575
// Get a FileSecurity object that represents the
6676
// current security settings.
@@ -83,4 +93,4 @@ public static void RemoveFileSecurity(string FileName, string Account, FileSyste
8393
//Removing access control entry from c:\test.xml
8494
//Done.
8595
//
86-
//</SNIPPET1>
96+
//</SNIPPET1>

‎snippets/csharp/System.IO/FileSystemAclExtensions/GetAccessControl/Project.csproj‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
<Project Sdk="Microsoft.NET.Sdk">
2+
3+
<PropertyGroup>
4+
<OutputType>Exe</OutputType>
5+
<TargetFramework>net8.0-windows</TargetFramework>
6+
</PropertyGroup>
7+
8+
</Project>

snippets/csharp/System.IO/File/GetAccessControl/sample.cs renamed to snippets/csharp/System.IO/FileSystemAclExtensions/GetAccessControl/sample.cs

Lines changed: 9 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,13 @@ public static void Main()
1313
{
1414
string fileName = "test.xml";
1515

16-
Console.WriteLine("Adding access control entry for "
17-
+ fileName);
16+
Console.WriteLine($"Adding access control entry for {fileName}");
1817

1918
// Add the access control entry to the file.
2019
AddFileSecurity(fileName, @"DomainName\AccountName",
2120
FileSystemRights.ReadData, AccessControlType.Allow);
2221

23-
Console.WriteLine("Removing access control entry from "
24-
+ fileName);
22+
Console.WriteLine($"Removing access control entry from {fileName}");
2523

2624
// Remove the access control entry from the file.
2725
RemoveFileSecurity(fileName, @"DomainName\AccountName",
@@ -39,35 +37,31 @@ public static void Main()
3937
public static void AddFileSecurity(string fileName, string account,
4038
FileSystemRights rights, AccessControlType controlType)
4139
{
42-
43-
// Get a FileSecurity object that represents the
44-
// current security settings.
45-
FileSecurity fSecurity = File.GetAccessControl(fileName);
40+
FileInfo fileInfo = new(fileName);
41+
FileSecurity fSecurity = fileInfo.GetAccessControl();
4642

4743
// Add the FileSystemAccessRule to the security settings.
4844
fSecurity.AddAccessRule(new FileSystemAccessRule(account,
4945
rights, controlType));
5046

5147
// Set the new access settings.
52-
File.SetAccessControl(fileName, fSecurity);
48+
fileInfo.SetAccessControl(fSecurity);
5349
}
5450

5551
// Removes an ACL entry on the specified file for the specified account.
5652
public static void RemoveFileSecurity(string fileName, string account,
5753
FileSystemRights rights, AccessControlType controlType)
5854
{
59-
60-
// Get a FileSecurity object that represents the
61-
// current security settings.
62-
FileSecurity fSecurity = File.GetAccessControl(fileName);
55+
FileInfo fileInfo = new(fileName);
56+
FileSecurity fSecurity = fileInfo.GetAccessControl();
6357

6458
// Remove the FileSystemAccessRule from the security settings.
6559
fSecurity.RemoveAccessRule(new FileSystemAccessRule(account,
6660
rights, controlType));
6761

6862
// Set the new access settings.
69-
File.SetAccessControl(fileName, fSecurity);
63+
fileInfo.SetAccessControl(fSecurity);
7064
}
7165
}
7266
}
73-
//</SNIPPET1>
67+
//</SNIPPET1>

snippets/fsharp/System.IO/Directory/GetAccessControl/fs.fsproj renamed to snippets/fsharp/System.IO/DirectoryInfo/GetAccessControl/fs.fsproj

File renamed without changes.

snippets/fsharp/System.IO/Directory/GetAccessControl/sample.fs renamed to snippets/fsharp/System.IO/DirectoryInfo/GetAccessControl/sample.fs

File renamed without changes.

‎snippets/visualbasic/System.IO/FileSystemAclExtensions/GetAccessControl/Project.vbproj‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
<Project Sdk="Microsoft.NET.Sdk">
2+
3+
<PropertyGroup>
4+
<OutputType>Exe</OutputType>
5+
<TargetFramework>net8.0-windows</TargetFramework>
6+
</PropertyGroup>
7+
8+
</Project>

0 commit comments

Comments
 (0)