<element file> (aplikace ClickOnce)

Článek
08/25/2023

Identifikuje všechny neshromážděné soubory stažené a používané aplikací.

Syntaxe

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

Prvky a atributy

Prvek file je nepovinný. Element má následující atributy.

Atribut	Popis
`name`	Požadováno. Určuje název souboru.
`size`	Povinný: Určuje velikost souboru v bajtech.
`group`	Volitelné, pokud `optional` atribut není zadán nebo nastaven na `false`; požadován, pokud `optional` je `true`. Název skupiny, do které tento soubor patří. Název může být libovolná hodnota řetězce Unicode zvolená vývojářem a používá se ke stahování souborů na vyžádání s ApplicationDeployment třídou.
`optional`	Nepovinné. Určuje, zda se tento soubor musí stáhnout při prvním spuštění aplikace, nebo zda se má soubor nacházet pouze na serveru, dokud aplikace nebude požadovat na vyžádání. Pokud `false` nebo není definováno, soubor se stáhne při prvním spuštění nebo instalaci aplikace. Pokud `true`musí být zadán manifest `group` aplikace, aby byl platný. `optional` nemůže být true, pokud `writeableType` je zadána s hodnotou `applicationData`.
`writeableType`	Nepovinné. Určuje, že tento soubor je datový soubor. V současné době je `applicationData`jedinou platnou hodnotou .

Typelib

Element typelib je volitelná podřízená položka elementu souboru. Element popisuje knihovnu typů, která patří do komponenty COM. Element má následující atributy.

Atribut	Popis
`tlbid`	Požadováno. Identifikátor GUID přiřazený knihovně typů.
`version`	Povinný: Číslo verze knihovny typů.
`helpdir`	Povinný: Adresář, který obsahuje soubory nápovědy pro komponentu. Může to být nulová délka.
`resourceid`	Nepovinné. Šestnáctková řetězcová reprezentace identifikátoru národního prostředí (LCID). Je to jedna až čtyři šestnáctkové číslice bez předpony 0x a bez počátečních nul. LCID může mít neutrální podlanguage identifikátor.
`flags`	Nepovinné. Řetězcové vyjádření příznaků knihovny typů pro tuto knihovnu typů. Konkrétně by měl být jedním z "RESTRICTED", "CONTROL", "HIDDEN" a "HASDISKIMAGE".

comClass

Prvek comClass je volitelná podřízená položka file prvku, ale je vyžadována, pokud aplikace ClickOnce obsahuje komponentu COM, která hodlá nasadit pomocí modelu COM bez registrace. Element má následující atributy.

Atribut	Popis
`clsid`	Požadováno. ID třídy komponenty COM vyjádřené jako identifikátor GUID.
`description`	Nepovinné. Název třídy.
`threadingModel`	Nepovinné. Model vláken používaný třídami modelu COM v procesu. Pokud je tato vlastnost null, nepoužívá se žádný model threadingu. Komponenta je vytvořena v hlavním vlákně klienta a volání z jiných vláken jsou zařazena do tohoto vlákna. V následujícím seznamu jsou uvedeny platné hodnoty: `Apartment`, `Free`, `Both` a `Neutral`.
`tlbid`	Nepovinné. IDENTIFIKÁTOR GUID pro knihovnu typů pro tuto komponentu COM.
`progid`	Nepovinné. Programový identifikátor závislý na verzi přidružený ke komponentě COM. Formát je `ProgID<vendor>.<component>.<version>`.
`miscStatus`	Nepovinné. Duplikuje v manifestu sestavení informace poskytnuté `MiscStatus` klíčem registru. Pokud nejsou nalezeny hodnoty pro `miscStatusIcon`, `miscStatusContent`, `miscStatusDocprint`nebo `miscStatusThumbnail` atributy, odpovídající výchozí hodnota uvedená v `miscStatus` chybějící atributy. Hodnota může být čárkami oddělený seznam hodnot atributů z následující tabulky. Tento atribut můžete použít, pokud je třída COM třída OCX, která vyžaduje `MiscStatus` hodnoty klíče registru.
`miscStatusIcon`	Nepovinné. Duplikuje v manifestu sestavení informace poskytnuté DVASPECT_ICON. Může poskytnout ikonu objektu. Hodnota může být čárkami oddělený seznam hodnot atributů z následující tabulky. Tento atribut můžete použít, pokud je třída COM třída OCX, která vyžaduje `Miscstatus` hodnoty klíče registru.
`miscStatusContent`	Nepovinné. Duplikuje v manifestu sestavení informace poskytované DVASPECT_CONTENT. Může poskytovat složený dokument, který lze zobrazit pro obrazovku nebo tiskárnu. Hodnota může být čárkami oddělený seznam hodnot atributů z následující tabulky. Tento atribut můžete použít, pokud je třída COM třída OCX, která vyžaduje `MiscStatus` hodnoty klíče registru.
`miscStatusDocPrint`	Nepovinné. Duplikuje v manifestu sestavení informace poskytnuté DVASPECT_DOCPRINT. Může poskytnout reprezentaci objektu zobrazenou na obrazovce, jako by byla vytištěna na tiskárně. Hodnota může být čárkami oddělený seznam hodnot atributů z následující tabulky. Tento atribut můžete použít, pokud je třída COM třída OCX, která vyžaduje `MiscStatus` hodnoty klíče registru.
`miscStatusThumbnail`	Nepovinné. Duplikuje v manifestu sestavení informace poskytované DVASPECT_THUMBNAIL. Může poskytnout miniaturu objektu, který se dá zobrazit v nástroji pro procházení. Hodnota může být čárkami oddělený seznam hodnot atributů z následující tabulky. Tento atribut můžete použít, pokud je třída COM třída OCX, která vyžaduje `MiscStatus` hodnoty klíče registru.

comInterfaceExternalProxyStub

Prvek comInterfaceExternalProxyStub je volitelná podřízená položka file prvku, ale může být vyžadována, pokud aplikace ClickOnce obsahuje komponentu COM, která hodlá nasadit pomocí modelu COM bez registrace. Element obsahuje následující atributy.

Atribut	Popis
`iid`	Požadováno. ID rozhraní (IID), které obsluhuje tento proxy server. IiD musí obsahovat složené závorky, které ho obklopuje.
`baseInterface`	Nepovinné. IID rozhraní, ze kterého je rozhraní odkazováno, odvozeno `iid` .
`numMethods`	Nepovinné. Počet metod implementovaných rozhraním.
`name`	Nepovinné. Název rozhraní, který se zobrazí v kódu.
`tlbid`	Nepovinné. Knihovna typů, která obsahuje popis rozhraní určené atributem `iid` .
`proxyStubClass32`	Nepovinné. Mapy IDENTIFIKÁTOR IID na CLSID v 32bitových knihovnách DLL proxy.

comInterfaceProxyStub

Prvek comInterfaceProxyStub je volitelná podřízená položka file prvku, ale může být vyžadována, pokud aplikace ClickOnce obsahuje komponentu COM, která hodlá nasadit pomocí modelu COM bez registrace. Element obsahuje následující atributy.

Atribut	Popis
`iid`	Požadováno. ID rozhraní (IID), které obsluhuje tento proxy server. IiD musí obsahovat složené závorky, které ho obklopuje.
`baseInterface`	Nepovinné. IID rozhraní, ze kterého je rozhraní odkazováno, odvozeno `iid` .
`numMethods`	Nepovinné. Počet metod implementovaných rozhraním.
`Name`	Nepovinné. Název rozhraní, který se zobrazí v kódu.
`Tlbid`	Nepovinné. Knihovna typů, která obsahuje popis rozhraní určené atributem `iid` .
`proxyStubClass32`	Nepovinné. Mapy IDENTIFIKÁTOR IID na CLSID v 32bitových knihovnách DLL proxy.
`threadingModel`	Nepovinné. Nepovinné. Model vláken používaný třídami modelu COM v procesu. Pokud je tato vlastnost null, nepoužívá se žádný model threadingu. Komponenta je vytvořena v hlavním vlákně klienta a volání z jiných vláken jsou zařazena do tohoto vlákna. V následujícím seznamu jsou uvedeny platné hodnoty: `Apartment`, `Free`, `Both` a `Neutral`.

windowClass

Prvek windowClass je volitelná podřízená položka file prvku, ale může být vyžadována, pokud aplikace ClickOnce obsahuje komponentu COM, která hodlá nasadit pomocí modelu COM bez registrace. Element odkazuje na třídu okna definovanou komponentou COM, která musí mít použitou verzi. Element obsahuje následující atributy.

Atribut Popis

versioned Nepovinné. Určuje, zda název interní třídy okna použitý v registraci obsahuje verzi sestavení, která obsahuje třídu okna. Hodnota tohoto atributu může být yes nebo no. Výchozí hodnota je yes. Hodnota no by měla být použita pouze v případě, že stejná třída okna je definována souběžnou komponentou a ekvivalentní nestrannou komponentou a chcete je považovat za stejnou třídu okna. Všimněte si, že platí běžná pravidla týkající se registrace třídy okna – pouze první komponenta, která registruje třídu okna, ji bude moct zaregistrovat, protože nemá použitou verzi.

Atribut	Popis
`versioned`	Nepovinné. Určuje, zda název interní třídy okna použitý v registraci obsahuje verzi sestavení, která obsahuje třídu okna. Hodnota tohoto atributu může být `yes` nebo `no`. Výchozí hodnota je `yes`. Hodnota `no` by měla být použita pouze v případě, že stejná třída okna je definována souběžnou komponentou a ekvivalentní nestrannou komponentou a chcete je považovat za stejnou třídu okna. Všimněte si, že platí běžná pravidla týkající se registrace třídy okna – pouze první komponenta, která registruje třídu okna, ji bude moct zaregistrovat, protože nemá použitou verzi.

hash

Prvek hash je volitelná podřízená položka elementu file . Element hash nemá žádné atributy.

ClickOnce používá algoritmus hash všech souborů v aplikaci jako kontrolu zabezpečení, aby se zajistilo, že se po nasazení žádné soubory nezměnily. hash Pokud prvek není součástí, nebude tato kontrola provedena. Proto se nedoporučuje vynechat hash prvek.

Pokud manifest obsahuje soubor, který není hashován, nelze tento manifest digitálně podepsat, protože uživatelé nemohou ověřit obsah souboru bez připojení.

dsig:Transforms

Prvek dsig:Transforms je povinný podřízený prvek hash . Element dsig:Transforms nemá žádné atributy.

dsig:Transform

Prvek dsig:Transform je povinný podřízený prvek dsig:Transforms . Element dsig:Transform má následující atributy.

Atribut	Popis
`Algorithm`	Algoritmus použitý k výpočtu hodnoty hash pro tento soubor. V současné době je jediná hodnota používaná technologií ClickOnce `urn:schemas-microsoft-com:HashTransforms.Identity`.

dsig:DigestMethod

Prvek dsig:DigestMethod je povinný podřízený prvek hash . Element dsig:DigestMethod má následující atributy.

Atribut	Popis
`Algorithm`	Algoritmus použitý k výpočtu hodnoty hash pro tento soubor. V současné době je jediná hodnota používaná technologií ClickOnce `http://www.w3.org/2000/09/xmldsig#sha1`.

dsig:DigestValue

Prvek dsig:DigestValue je povinný podřízený prvek hash . Element dsig:DigestValue nemá žádné atributy. Jeho textová hodnota je vypočítaná hodnota hash pro zadaný soubor.

Poznámky

Tento prvek identifikuje všechny nesesestavné soubory, které tvoří aplikaci, a zejména hodnoty hash pro ověření souboru. Tento prvek může také zahrnovat data izolace modelu COM (Component Object Model) přidružená k souboru. Pokud se soubor změní, soubor manifestu aplikace musí být také aktualizován tak, aby odrážel změnu.

Příklad

Následující příklad kódu znázorňuje file prvky v manifestu aplikace pro aplikaci nasazenou pomocí 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é

Manifest aplikace ClickOnce

Share via