BasicProperties Clase

Definición

Espacio de nombres:

Windows.Storage.FileProperties

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 : IStorageItemExtraProperties

Public NotInheritable Class BasicProperties
Implements IStorageItemExtraProperties

Herencia

Object Platform::Object IInspectable BasicProperties

Atributos

ContractVersionAttribute

Implementaciones

IStorageItemExtraProperties

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.

Consulte también

• IStorageItemExtraProperties
• GetBasicPropertiesAsync()
• GetBasicPropertiesAsync()
• GetBasicPropertiesAsync()
• BasicProperties
• BasicProperties
• BasicProperties