<file> Prvek (aplikace ClickOnce)

Článek
08/11/2011

Identifikuje všechny nesestavené soubory stažené a používané aplikací.

<file
    name
    size
    group
    optional
    writeableType
>
    <typelib
        tlbid
        version
        helpdir
        resourceid
        flags
    />
    <comClass
        clsid
        description
        threadingModel
        tlbid
        progid
        miscStatus
        miscStatusIcon
        miscStatusContent
        miscStatusDocPrint
        miscStatusThumbnail
    />
    <comInterfaceExternalProxyStub
        iid
        baseInterface
        numMethods
        name
        tlbid
        proxyStubClass32
    />
    <comInterfaceProxyStub
        iid
        baseInterface
        numMethods
        name
        tlbid
        proxyStubClass32
    />
    <windowClass
        versioned
    />
</file>

Atributy a prvky

file Prvkem je volitelný. Prvek má následující atributy.

Atribut	Popis
name	Povinné. Označuje název souboru.
size	Povinné. Určuje velikost souboru v bajtech.
group	Volitelné, pokud není atribut optional zadán nebo nastaven na false; požadováno pokud optional je true. Název skupiny, do které tento soubor náleží. Název může být libovolný Unicode řetězec zvolený vývojářem a používán pro stahování souborů na požádání s třídou ApplicationDeployment.
optional	Nepovinné. Určuje, zda tento soubor musí být stažen při prvním spuštění aplikace nebo zda by se měl soubor nacházet pouze na serveru, dokud si jej aplikace nevyžádá. Pokud je hodnota false nebo undefined, soubor je stažen při prvním spuštění nebo instalaci aplikace. Pokud je hodnota true, group musí být určena pro manifest aplikace, aby byl platný. optional nemůže být true, pokud writeableType není zadán s hodnotou applicationData.
writeableType	Nepovinné. Určuje, že tento soubor je datový soubor. Aktuálně jediná platná hodnota je applicationData.

typelib

Prvek typelib je volitelným podřízeným prvku souboru. Prvek popisuje knihovnu typů, která patří do součásti modelu COM. Prvek má následující atributy.

Atribut	Popis
tlbid	Povinné. Identifikátor GUID přiřazený knihovně typů.
version	Povinné. Číslo verze knihovny typů.
helpdir	Povinné. Adresář, který obsahuje soubory nápovědy pro součást. Může být nulové délky.
resourceid	Nepovinné. Reprezentace šestnáctkového řetězce identifikátoru národního prostředí (LCID). Od jedné do čtyř šestnáctkových číslic bez předpony 0x a nezačínajících nulou. Identifikátor LCID může mít neutrální identifikátor dílčího jazyka.
flags	Nepovinné. Řetězcové vyjádření příznaků knihovny typů pro tuto knihovnu typů. Konkrétně by to měl být jeden z "RESTRICTED", "CONTROL", "HIDDEN" a "HASDISKIMAGE".

comClass

Prvek comClass je volitelným podřízeným prvku file, ale je povinný, pokud aplikace ClickOnce obsahuje součást modelu COM, který hodlá nasadit pomocí bez-registračního modelu COM. Prvek má následující atributy.

Atribut	Popis
clsid	Povinné. ID třídy komponenty modelu COM, vyjádřené jako identifikátor GUID.
description	Nepovinné. Název třídy.
threadingModel	Nepovinné. Model podprocesu používaný třídami COM v průběhu výrobního procesu. Pokud tato vlastnost má hodnotu null, není použit žádný model podprocesu. Komponenta je vytvořena v hlavním vlákně klienta a volání z ostatních podprocesů jsou zařazena do tohoto vlákna. Následující seznam uvádí platné hodnoty: Apartment, Free, Both a Neutral.
tlbid	Nepovinné. Identifikátor GUID pro knihovnu typů pro tuto komponentu modelu COM.
progid	Nepovinné. Programový identifikátor závislý na verzi přidružený komponentě modelu COM. Formát ProgID je <vendor>.<component>.<version>.
miscStatus	Nepovinné. V manifestu sestavení duplikuje informaci poskytnutou klíčem registru MiscStatus. Pokud hodnoty atributů miscStatusIcon, miscStatusContent, miscStatusDocprint nebo miscStatusThumbnail nejsou nalezeny, odpovídající výchozí hodnota uvedena v miscStatus se použita pro chybějící atributy. Hodnota může být seznam čárkami oddělených hodnot atributů z následující tabulky. Tento atribut můžete použít v případě, že třída modelu COM je třídou OCX, která vyžaduje hodnoty klíče registru MiscStatus.
miscStatusIcon	Nepovinné. V manifestu sestavení duplikuje informaci poskytovanou DVASPECT ICON. Může poskytnout ikonu objektu. Hodnota může být seznam čárkami oddělených hodnot atributů z následující tabulky. Tento atribut můžete použít v případě, že třída modelu COM je třídou OCX, která vyžaduje hodnoty klíče registru Miscstatus.
miscStatusContent	Nepovinné. V manifestu sestavení duplikuje informaci poskytovanou DVASPECT_CONTENT. Může poskytovat složený dokument zobrazitelný na obrazovce nebo tiskárně. Hodnota může být seznam čárkami oddělených hodnot atributů z následující tabulky. Tento atribut můžete použít v případě, že třída modelu COM je třídou OCX, která vyžaduje hodnoty klíče registru MiscStatus.
miscStatusDocPrint	Nepovinné. V manifestu sestavení duplikuje informaci poskytovanou DVASPECT_DOCPRINT. Může poskytnout reprezentaci objektu zobrazitelnou na obrazovce, jako by byl tištěn na tiskárně . Hodnota může být seznam čárkami oddělených hodnot atributů z následující tabulky. Tento atribut můžete použít v případě, že třída modelu COM je třídou OCX, která vyžaduje hodnoty klíče registru MiscStatus.
miscStatusThumbnail	Nepovinné. V manifestu sestavení duplikuje informaci poskytovanou DVASPECT_THUMBNAIL. Může poskytnout miniaturu objektu zobrazitelnou v procházecím nástroji. Hodnota může být seznam čárkami oddělených hodnot atributů z následující tabulky. Tento atribut můžete použít v případě, že třída modelu COM je třídou OCX, která vyžaduje hodnoty klíče registru MiscStatus.

comInterfaceExternalProxyStub

Prvek comInterfaceExternalProxyStub je volitelným podřízeným prvku file, ale může být povinný, pokud aplikace ClickOnce obsahuje komponentu modelu COM, kterou hodlá nasadit pomocí bez-registračního modelu COM. Prvek obsahuje následující atributy.

Atribut	Popis
iid	Povinné. ID rozhraní (IID), který je poskytovaný tímto serverem proxy. IID musí mít okolo sebe závorky.
baseInterface	Nepovinné. IID rozhraní, ze kterého je odvozeno rozhraní, na které odkazuje iid.
numMethods	Nepovinné. Počet metod implementovaných rozhraním.
name	Nepovinné. Název rozhraní tak, jak se zobrazí v kódu.
tlbid	Nepovinné. Knihovna typů, která obsahuje popis rozhraní zadaný atributem iid.
proxyStubClass32	Nepovinné. Mapuje IID na identifikátor CLSID v 32bitových proxy knihovnách DLL.

comInterfaceProxyStub

Prvek comInterfaceProxyStub je volitelným podřízeným prvku file, ale může být povinný, pokud aplikace ClickOnce obsahuje komponentu modelu COM, kterou hodlá nasadit pomocí bez-registračního modelu COM. Prvek obsahuje následující atributy.

Atribut	Popis
iid	Povinné. ID rozhraní (IID), který je poskytovaný tímto serverem proxy. IID musí mít okolo sebe závorky.
baseInterface	Nepovinné. IID rozhraní, ze kterého je odvozeno rozhraní, na které odkazuje iid.
numMethods	Nepovinné. Počet metod implementovaných rozhraním.
Name	Nepovinné. Název rozhraní tak, jak se zobrazí v kódu.
Tlbid	Nepovinné. Knihovna typů, která obsahuje popis rozhraní zadaný atributem iid.
proxyStubClass32	Nepovinné. Mapuje IID na identifikátor CLSID v 32bitových proxy knihovnách DLL.
threadingModel	Nepovinné. Nepovinné. Model podprocesu používaný třídami COM v průběhu výrobního procesu. Pokud tato vlastnost má hodnotu null, není použit žádný model podprocesu. Komponenta je vytvořena v hlavním vlákně klienta a volání z ostatních podprocesů jsou zařazena do tohoto vlákna. Následující seznam uvádí platné hodnoty: Apartment, Free, Both a Neutral.

windowClass

Prvek windowClass je volitelným podřízeným prvku file, ale může být povinný, pokud aplikace ClickOnce obsahuje komponentu modelu COM, kterou hodlá nasadit pomocí bez-registračního modelu COM. Prvek odkazuje na třídu okna definovanou komponentou modelu COM, která musí mít verzi na ní aplikovanou. Prvek obsahuje následující atributy.

Atribut	Popis
versioned	Nepovinné. Kontroluje, zda interní název třídy oken použitý v registraci obsahuje verzi sestavení, která obsahuje třídu oken. Hodnota tohoto atribut může být yes nebo no. Výchozí je 'yes. Hodnota no by měla být použíta pouze v případě, že je stejná třída oken definována souběžnou komponentou a obdobnou nesouběžnou komponentou a chcete je považovat za stejnou třídu oken. Všimněte si, že obvyklá pravidla o registraci třídy oken uvádí, že pouze první komponenta, která registruje třídu oken, ji budete moci zaregistrovat, protože nemá aplikovanou verzi.

versioned

Nepovinné. Kontroluje, zda interní název třídy oken použitý v registraci obsahuje verzi sestavení, která obsahuje třídu oken. Hodnota tohoto atribut může být yes nebo no. Výchozí je 'yes. Hodnota no by měla být použíta pouze v případě, že je stejná třída oken definována souběžnou komponentou a obdobnou nesouběžnou komponentou a chcete je považovat za stejnou třídu oken. Všimněte si, že obvyklá pravidla o registraci třídy oken uvádí, že pouze první komponenta, která registruje třídu oken, ji budete moci zaregistrovat, protože nemá aplikovanou verzi.

hodnota hash

Prvek hash je volitelným podřízeným prvku file. Prvek hash neobsahuje žádné atributy.

ClickOnce aplikace používá algorithmickou hodnotu hash všech souborů v aplikaci jako kontrolu zabezpečení, aby žádný ze souborů nebyl změněn po nasazení. Pokud prvek hash není zahrnut, nebude provedena kontrola. Proto není vynechání prvku hash doporučeno.

Obsahuje-li manifest soubor, který nemá vytvořen otisk, tento manifest nelze digitálně podepsat, protože uživatelé nemohou ověřit obsah souboru bez otisku.

dsig:Transforms

Prvek dsig:Transforms je vyžadovaným podřízeným prvku hash. Prvek dsig:Transforms neobsahuje žádné atributy.

dsig:Transform

Prvek dsig:Transform je vyžadovaným podřízeným prvku dsig:Transforms. dsig:Transform Prvek má následující atributy.

Atribut	Popis
Algorithm	Algoritmus použitý pro výpočet algoritmu Digest pro tento soubor. Aktuálně jedinou používanou hodnotou ClickOnce je pouze urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

Prvek dsig:DigestMethod je vyžadovaným podřízeným prvku hash. dsig:DigestMethod Prvek má následující atributy.

Atribut	Popis
Algorithm	Algoritmus použitý pro výpočet algoritmu Digest pro tento soubor. Aktuálně jedinou používanou hodnotou ClickOnce je pouze http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

Prvek dsig:DigestValue je vyžadovaným podřízeným prvku hash. Prvek dsig:DigestValue neobsahuje žádné atributy. Jeho textová hodnota je vypočítanou hodnotou hash pro zadaný soubor.

Poznámky

Tento prvek identifikuje všechny soubory nonassembly, které tvoří aplikace a zejména hodnoty hash pro ověření souboru. Tento prvek však může obsahovat také izolační data modelu COM přiřazené k souboru. Pokud se soubor změní, soubor manifestu aplikace musí být rovněž aktualizován tak, aby odrážel změny.

Příklad

Následující příklad kódu ukazuje prvky file v manifestu aplikace nasazené pomocí aplikace ClickOnce.

  <file name="Icon.ico" size="9216">
    <hash>
      <dsig:Transforms>
        <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
      </dsig:Transforms>
      <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
      <dsig:DigestValue>lVoj+Rh6RQ/HPNLOdayQah5McrI=</dsig:DigestValue>
    </hash>
  </file>

Viz také

Odkaz

Manifest aplikace ClickOnce

Sdílet prostřednictvím