File.SetAccessControl(String, FileSecurity) Yöntem

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kod:
mscorlib.dll

Bir nesne tarafından FileSecurity açıklanan erişim denetimi listesi (ACL) girdilerini belirtilen dosyaya uygular.

public:
 static void SetAccessControl(System::String ^ path, System::Security::AccessControl::FileSecurity ^ fileSecurity);
public static void SetAccessControl(string path, System.Security.AccessControl.FileSecurity fileSecurity);
static member SetAccessControl : string * System.Security.AccessControl.FileSecurity -> unit
Public Shared Sub SetAccessControl (path As String, fileSecurity As FileSecurity)

Parametreler

path
String

Erişim denetimi listesi (ACL) girdilerinin ekleneceği veya kaldırılacağı bir dosya.

fileSecurity
FileSecurity

FileSecurity parametresi tarafından açıklanan dosyaya uygulanacak bir ACL girdisini path açıklayan nesne.

Özel durumlar

IOException

Dosya açılırken bir G/Ç hatası oluştu.

SEHException

path parametresi null'dir.

SystemException

Dosya bulunamadı.

UnauthorizedAccessException

path parametresi salt okunur bir dosya belirtti.

-veya-

Bu işlem geçerli platformda desteklenmiyor.

-veya-

path parametresi bir dizin belirtti.

-veya-

Çağıranın gerekli izni yok.

ArgumentNullException

fileSecurity parametresi null'dir.

Açıklamalar

yöntemi, SetAccessControl erişim denetimi listesi (ACL) girdilerini, doğası olmayan ACL listesini temsil eden bir dosyaya uygular.

Caution

parametresi için fileSecurity belirtilen ACL, dosyanın mevcut ACL'sinin yerini alır. Yeni bir kullanıcının izinlerini eklemek için yöntemini kullanarak GetAccessControl mevcut ACL'yi alın, değiştirin ve ardından dosyaya geri uygulamak için kullanın SetAccessControl .

ACL, belirli bir dosya üzerinde belirli eylemlere sahip olan veya olmayan kişileri ve grupları açıklar. Daha fazla bilgi için bkz . Nasıl yapılır: Erişim Denetimi Listesi Girdileri Ekleme veya Kaldırma.

SetAccessControl yöntemi yalnızca FileSecurity nesne oluşturulduktan sonra değiştirilmiş nesneleri kalıcı hale döndürür. Bir FileSecurity nesne değiştirilmediyse, bir dosyada kalıcı olmaz. Bu nedenle, bir dosyadan nesne almak ve aynı nesneyi başka bir FileSecurity dosyaya yeniden uygulamak mümkün değildir.

ACL bilgilerini bir dosyadan diğerine kopyalamak için:

  1. GetAccessControl Nesnesini kaynak dosyadan almak FileSecurity için yöntemini kullanın.

  2. Hedef dosya için yeni FileSecurity bir nesne oluşturun.

  3. GetSecurityDescriptorBinaryForm ACL bilgilerini almak için kaynak GetSecurityDescriptorSddlForm nesnenin veya FileSecurity yöntemini kullanın.

  4. SetSecurityDescriptorBinaryForm 3. adımda alınan bilgileri hedef SetSecurityDescriptorSddlForm nesneye kopyalamak için or FileSecurity yöntemini kullanın.

  5. yöntemini kullanarak hedef FileSecurity nesneyi hedef dosyaya SetAccessControl ayarlayın.

NTFS ortamlarında ReadAttributes ve ReadExtendedAttributes kullanıcının üst klasörde hakları varsa kullanıcıya ListDirectory verilir. ve ReadAttributes'yi reddetmek ReadExtendedAttributes için üst dizinde reddedinListDirectory.

Şunlara uygulanır

Ayrıca bkz.