BasicProperties Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona acceso a las propiedades básicas, como el tamaño del elemento o la fecha en que se modificó por última vez el elemento, del elemento (como un archivo o una carpeta).
public ref class BasicProperties sealed : IStorageItemExtraProperties/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class BasicProperties final : IStorageItemExtraProperties[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class BasicProperties : IStorageItemExtraPropertiesPublic NotInheritable Class BasicProperties
Implements IStorageItemExtraProperties- Herencia
- Atributos
- Implementaciones
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Ejemplos
El ejemplo de acceso a archivos muestra cómo recuperar propiedades de un archivo, incluidas las propiedades básicas, como Size y DateModified.
try
{
StorageFile file = rootPage.sampleFile;
if (file != null)
{
StringBuilder outputText = new StringBuilder();
// Get basic properties
BasicProperties basicProperties = await file.GetBasicPropertiesAsync();
outputText.AppendLine("File size: " + basicProperties.Size + " bytes");
outputText.AppendLine("Date modified: " + basicProperties.DateModified);
// Specify more properties to retrieve
readonly string dateAccessedProperty = "System.DateAccessed";
readonly string fileOwnerProperty = "System.FileOwner";
List<string> propertiesName = new List<string>();
propertiesName.Add(dateAccessedProperty);
propertiesName.Add(fileOwnerProperty);
// Get the specified properties through StorageFile.Properties
IDictionary<string, object> extraProperties = await file.Properties.RetrievePropertiesAsync(propertiesName);
var propValue = extraProperties[dateAccessedProperty];
if (propValue != null)
{
outputText.AppendLine("Date accessed: " + propValue);
}
propValue = extraProperties[fileOwnerProperty];
if (propValue != null)
{
outputText.AppendLine("File owner: " + propValue);
}
}
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
// For example, handle a file not found error
}
Una vez completada GetBasicPropertiesAsync , basicProperties obtiene un objeto BasicProperties.
En el ejemplo, file contiene un storageFile que representa el archivo para el que se van a recuperar las propiedades.
Comentarios
Puede acceder a un objeto BasicProperties de forma asincrónica mediante el método GetBasicPropertiesAsync de un elemento (como un archivo de carpeta) o mediante la propiedad BasicProperties de forma sincrónica si está disponible.
Puede obtener un objeto BasicProperties mediante cualquiera de los métodos y propiedades siguientes:
- Método storageFile.getBasicPropertiesAsync
- método storageFolder.getBasicPropertiesAsync
- Propiedad FileInformation.basicProperties
- Propiedad FolderInformation.basicProperties
Propiedades
| DateModified |
Obtiene la marca de tiempo de la última vez que se modificó el archivo. |
| ItemDate |
Obtiene la fecha más relevante para el elemento. |
| Size |
Obtiene el tamaño del archivo en bytes. |
Métodos
| RetrievePropertiesAsync(IIterable<String>) |
Recupera las propiedades especificadas asociadas al elemento. |
| SavePropertiesAsync() |
Guarda todas las propiedades asociadas al elemento. |
| SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
Guarda las propiedades y valores especificados asociados al elemento. |