StorageItemContentProperties Clase

Definición

Espacio de nombres:

Windows.Storage.FileProperties

Proporciona acceso a las propiedades relacionadas con el contenido de un elemento (como un archivo o carpeta).

public ref class StorageItemContentProperties sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemContentProperties final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemContentProperties

Public NotInheritable Class StorageItemContentProperties

Herencia

Object Platform::Object IInspectable StorageItemContentProperties

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

En este ejemplo se muestra cómo recuperar propiedades de contenido o propiedades especificadas de un archivo mediante StorageFile.Properties.

try
{
    StorageFile file = rootPage.sampleFile;
    if (file != null)
    {
        StringBuilder outputText = new StringBuilder();

        // Get image properties
        ImageProperties imageProperties = await file.Properties.GetImagePropertiesAsync();
        outputText.AppendLine("Date taken: " + imageProperties.DateTaken);
        outputText.AppendLine("Rating: " + imageProperties.Rating);

        // 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 completado GetImagePropertiesAsync , imageProperties obtiene un objeto ImageProperties . Además, después de completar RetrievePropertiesAsync , extraProperties obtiene un objeto que contiene las propiedades especificadas (la lista de propiedades admitidas se puede encontrar en la página Propiedades principales).

En el ejemplo, el archivo contiene un storageFile que representa el archivo para el que se van a recuperar las propiedades.

Comentarios

Puede obtener un objeto StorageItemContentProperties mediante la propiedad Properties que está disponible en los objetos siguientes:

• Propiedad StorageFile.Properties
• Propiedad StorageFolder.Properties
• Propiedad FileInformation.Properties
• Propiedad FolderInformation.Properties

Nota:

Es posible que no se pueda acceder a las propiedades que se obtienen o establecen mediante un controlador de propiedades definido por otra aplicación (como Microsoft Word). En su lugar, puede intentar obtener estas propiedades mediante una consulta de archivo respaldada por el índice del sistema. Para obtener más información, vea QueryOptions.

Para obtener más ejemplos de código sobre el acceso a propiedades, consulte el ejemplo de acceso a archivos.

Métodos

GetDocumentPropertiesAsync()	Recupera las propiedades del documento del elemento (como un archivo de carpeta).
GetImagePropertiesAsync()	Recupera las propiedades de imagen del elemento (como un archivo de carpeta).
GetMusicPropertiesAsync()	Recupera las propiedades de música del elemento (como un archivo de carpeta).
GetVideoPropertiesAsync()	Recupera las propiedades de vídeo del elemento (como un archivo de carpeta).
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

• Página de propiedades principales