Condividi tramite


Schema della descrizione della libreria

I file di descrizione della libreria sono file XML che definiscono le librerie. Le librerie aggregano elementi da posizioni di archiviazione locali e remote in una singola visualizzazione in Esplora risorse. I file di descrizione della libreria seguono lo schema Descrizione libreria e vengono salvati come file *.library-ms.

In questo argomento sono incluse le sezioni seguenti:

Panoramica dello schema della descrizione della libreria

Le librerie contengono file archiviati in uno o più percorsi di archiviazione. Le librerie non archiviano effettivamente questi file; monitorano invece le cartelle contenenti i file e consentono agli utenti di accedere e disporre i file in modi diversi. Ad esempio, un utente può avere file musicali in più cartelle su un disco rigido locale e anche su un disco rigido esterno. Usando la Libreria musicale, l'utente può accedere a tutti i file contemporaneamente e ordinarli tutti in base al nome dell'artista o al titolo dell'album come singolo gruppo.

Lo schema Descrizione libreria è costituito da tre parti principali, descritte nella tabella seguente:

Parte Descrizione
Informazioni generali sulla libreria Informazioni sulla libreria, ad esempio nome, proprietario, versione, icona, che Esplora risorse può usare quando visualizza la libreria a un utente.
Proprietà della libreria Una o più proprietà che descrivono la libreria. Queste proprietà personalizzate sono specifiche della libreria.
Posizioni della libreria Uno o più connettori di ricerca che identificano le posizioni di archiviazione da includere nella libreria. Ognuna di queste posizioni può avere anche un set univoco di proprietà.

 

I file di libreria in Windows 7 vengono archiviati nella cartella nota FOLDERID_Libraries. Per impostazione predefinita, la cartella FOLDERID_Libraries si trova in %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Libraries.

Controllo delle versioni dello spazio dei nomi

Le versioni del formato del file Descrizione libreria (*.library-ms) vengono rilevate modificando lo spazio dei nomi. Per Windows 7, il formato di file ha lo spazio dei nomi predefinito seguente: https://schemas.microsoft.com/windows/2009/library.

Le versioni del contenuto della libreria vengono tuttavia rilevate usando l'elemento <version> in un file Descrizione libreria specifico.

Esempio di un file di descrizione della libreria

Di seguito è riportato un esempio di file Descrizione libreria che definisce una raccolta per i file di documento.

<?xml version="1.0" encoding="UTF-8"?>
<libraryDescription xmlns="http://schemas.microsoft.com/windows/2009/library">
    <name>@shell32.dll,-34575</name>
    <ownerSID>S-1-5-21-379071477-2495173225-776587366-1000</ownerSID>
    <version>1</version>
    <isLibraryPinned>true</isLibraryPinned>
    <iconReference>imageres.dll,-1002</iconReference>
    <templateInfo>
        <folderType>{7d49d726-3c21-4f05-99aa-fdc2c9474656}</folderType>
    </templateInfo>
    <searchConnectorDescriptionList>
        <searchConnectorDescription publisher="Microsoft" product="Windows">
            <description>@shell32.dll,-34577</description>
            <isDefaultSaveLocation>true</isDefaultSaveLocation>
            <simpleLocation>
                <url>knownfolder:{FDD39AD0-238F-46AF-ADB4-6C85480369C7}</url>
                <serialized>MBAAAEAFCAAA...MFNVAAAAAA</serialized>
            </simpleLocation>
        </searchConnectorDescription>
        <searchConnectorDescription publisher="Microsoft" product="Windows">
            <description>@shell32.dll,-34579</description>
            <isDefaultNonOwnerSaveLocation>true</isDefaultNonOwnerSaveLocation>
            <simpleLocation>
                <url>knownfolder:{ED4824AF-DCE4-45A8-81E2-FC7965083634}</url>
                <serialized>MBAAAEAFCAAA...HJIfK9AAAAAA</serialized>
            </simpleLocation>
        </searchConnectorDescription>
    </searchConnectorDescriptionList>
</libraryDescription>

Elemento folderType (schema della libreria)

elemento iconReference (schema di libreria)

Elemento isLibraryPinned (schema della libreria)

Elemento libraryDescription (schema della libreria)

elemento name (schema della libreria)

Elemento ownerSID (schema della libreria)

elemento property (schema della libreria)

elemento propertyStore (schema della libreria)

elemento searchConnectorDescription (schema della libreria)

elemento searchConnectorDescriptionList (Schema della libreria)

Elemento templateInfo (schema della libreria)

Elemento version (schema della libreria)

Schema di descrizione del connettore di ricerca