Compartir a través de


BasicProperties Clase

Definición

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

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.

Se aplica a

Consulte también