File.SetAttributes (Método)
Ensamblado: mscorlib (en mscorlib.dll)
public static function SetAttributes ( path : String, fileAttributes : FileAttributes )
Parámetros
- path
Ruta de acceso al archivo.
- fileAttributes
Los atributos FileAttributes deseados, como por ejemplo Hidden, ReadOnly, Normal y Archive.
| Tipo de excepción | Condición |
|---|---|
| path está vacío, contiene solamente espacios en blanco, contiene caracteres no válidos o el atributo de archivo no es válido. |
|
| La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, las rutas de acceso deben ser inferiores a 248 caracteres y los nombres de archivo deben ser inferiores a 260 caracteres. |
|
| path tiene un formato no válido. |
|
| La ruta de acceso especificada no es válida (por ejemplo, se encuentra en una unidad de red no asignada). |
|
| No se puede encontrar el archivo. |
|
| path especifica un archivo que es de sólo lectura. O bien, Esta operación no es compatible con la plataforma actual. O bien, path especifica un directorio. O bien, El llamador no dispone del permiso requerido. |
El parámetro path puede especificar información de ruta de acceso relativa o absoluta. La información de ruta de acceso relativa se interpreta en relación con el directorio de trabajo actual. Para obtener el directorio de trabajo actual, vea GetCurrentDirectory.
No es posible cambiar el estado de compresión de un objeto File utilizando el método SetAttributes.
Para obtener un ejemplo de cómo utilizar este método, vea la sección Ejemplo. En la siguiente tabla se muestran ejemplos de otras tareas de E/S típicas o relacionadas.
| Para realizar esta operación... | Vea el ejemplo de este tema... |
|---|---|
| Crear un archivo de texto | |
| Escribir en un archivo de texto | |
| Leer de un archivo de texto | |
| Anexar texto a un archivo | |
| Cambiar de nombre o mover un archivo | |
| Obtener los atributos de un archivo | |
| Leer de un archivo binario | |
| Escribir en un archivo binario |
En el siguiente ejemplo se muestran los métodos GetAttributes y SetAttributes mediante la aplicación de los atributos Archive y Hidden a un archivo.
using System; using System.IO; using System.Text; class Test { public static void Main() { string path = @"c:\temp\MyTest.txt"; // Create the file if it does not exist. if (!File.Exists(path)) { File.Create(path); } if ((File.GetAttributes(path) & FileAttributes.Hidden) == FileAttributes.Hidden) { // Show the file. File.SetAttributes(path, FileAttributes.Archive); Console.WriteLine("The {0} file is no longer hidden.", path); } else { // Hide the file. File.SetAttributes(path, File.GetAttributes(path) | FileAttributes.Hidden); Console.WriteLine("The {0} file is now hidden.", path); } } }
import System.*;
import System.IO.*;
import System.Text.*;
class Test
{
public static void main(String[] args)
{
String path = "c:\\temp\\MyTest.txt";
// Create the file if it does not exist.
if (!(File.Exists(path))) {
File.Create(path);
}
if ((File.GetAttributes(path) & FileAttributes.Hidden).
Equals(FileAttributes.Hidden)) {
// Show the file.
File.SetAttributes(path, FileAttributes.Archive);
Console.WriteLine("The {0} file is no longer hidden.", path);
}
else {
// Hide the file.
File.SetAttributes(path, File.GetAttributes(path)
| FileAttributes.Hidden);
Console.WriteLine("The {0} file is now hidden.", path);
}
} //main
} //Test
- FileIOPermission para leer y escribir en archivos. Enumeración asociada: FileIOPermissionAccess.Write.
Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
