<file> — Element (Aplikacja ClickOnce)

Artykuł
06/10/2015

Identyfikuje wszystkie pliki nonassembly pobrane i używane przez aplikację.

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

Elementy i atrybuty

file Element jest opcjonalne.Atrybuty elementu.

Atrybut	Opis
name	Wymagane.Identyfikuje nazwę pliku.
size	Wymagane.Określa rozmiar, w bajtach, w pliku.
group	Opcjonalne, jeśli optional atrybut nie jest określony lub ustawiona na false; required if optional is true.Nazwa grupy, do której należy ten plik.Nazwa może być dowolną wartością ciągu Unicode, wybranego przez autora i jest używany do pobierania plików na żądanie z ApplicationDeployment klasy.
optional	Opcjonalne.Określa, czy ten plik musi uruchomić pobierania, gdy aplikacja jest pierwszym, lub czy plik powinien zamieszkują tylko na serwerze, dopóki aplikacja żąda on na żądanie.Jeśli false lub undefined, plik jest pobierany, gdy aplikacja jest najpierw uruchomić lub zainstalowany.Jeśli true, group musi być podany dla manifest aplikacji mają obowiązywać.optionalnie może być wartość true Jeśli writeableType jest określona wartość applicationData.
writeableType	Opcjonalne.Określa, że ten plik jest plikiem danych.Obecnie jest jedyną prawidłową wartością applicationData.

sekcji TypeLib.

typelib Element jest opcjonalny element podrzędny elementu pliku.Element opisuje biblioteki typów, należącej do składnika COM.Atrybuty elementu.

Atrybut	Opis
tlbid	Wymagane.Identyfikator GUID jest przypisany do biblioteki typów.
version	Wymagane.Numer wersji biblioteki typów.
helpdir	Wymagane.Katalog zawierający pliki pomocy dla składnika.Może być o zerowej długości.
resourceid	Opcjonalne.Reprezentacja ciąg szesnastkowy identyfikator ustawień regionalnych (LCID).Jest jednej do czterech cyfr szesnastkowych bez prefiksu 0 x i bez zer.Identyfikator LCID może mieć identyfikator odmianą neutralny.
flags	Opcjonalne.Reprezentacja ciąg flagi biblioteki typów dla tej biblioteki typów.W szczególności należy, jeden z "RESTRICTED", "Kontrola", "UKRYTE" i "HASDISKIMAGE".

comClass

comClass Element jest opcjonalne dziecko file element, ale jest wymagane, jeśli ClickOnce aplikacji zawiera składnik COM, zamierza wdrożyć za pomocą wolne rejestracji modelu COM.Atrybuty elementu.

Atrybut	Opis
clsid	Wymagane.Identyfikator klasy składnika COM, wyrażone jako identyfikator GUID.
description	Opcjonalne.Nazwa klasy.
threadingModel	Opcjonalne.Model wątka używany przez wewnątrzprocesowe klasy COM.Jeśli ta właściwość ma wartość null, jest używany żaden model wątków.Składnik jest tworzony w głównym wątku klienta i wywołania z innych wątków są przekazywane międzyprocesowo do tego wątku.Na poniższej liście przedstawiono prawidłowe wartości: Apartament, wolnego, zarówno, i Neutral.
tlbid	Opcjonalne.Identyfikator GUID dla biblioteki typów dla tego składnika COM..
progid	Opcjonalne.Skojarzone ze składnikiem COM identyfikatorów programowych zależne od wersji.The format of a ProgID is <vendor>.<component>.<version>.
miscStatus	Opcjonalne.Duplikaty w zgromadzeniu manifest informacji dostarczonych przez MiscStatus klucza rejestru.Jeśli wartości dla miscStatusIcon, miscStatusContent, miscStatusDocprint, lub miscStatusThumbnail atrybuty nie zostaną znalezione, odpowiadające im wartości domyślne są wymienione w miscStatus jest używana dla brakujących atrybutach.Wartość może być rozdzielane przecinkami listę wartości atrybutu z poniższej tabeli.Atrybutu tego można użyć, jeśli klasy COM jest klasa OCX, który wymaga MiscStatus wartości kluczy rejestru.
miscStatusIcon	Opcjonalne.Duplikaty w zgromadzeniu manifest informacji dostarczonych przez DVASPECT_ICON.Umożliwia ona ikona obiektu.Wartość może być rozdzielane przecinkami listę wartości atrybutu z poniższej tabeli.Atrybutu tego można użyć, jeśli klasy COM jest klasa OCX, który wymaga Miscstatus wartości kluczy rejestru.
miscStatusContent	Opcjonalne.Duplikaty w zgromadzeniu manifest informacji dostarczonych przez DVASPECT_CONTENT.Zapewnia dokument złożony wyświetlanej na ekranie lub drukarce.Wartość może być rozdzielane przecinkami listę wartości atrybutu z poniższej tabeli.Atrybutu tego można użyć, jeśli klasy COM jest klasa OCX, który wymaga MiscStatus wartości kluczy rejestru.
miscStatusDocPrint	Opcjonalne.Duplikaty w zgromadzeniu manifest informacji dostarczonych przez DVASPECT_DOCPRINT.Umożliwia ona reprezentacja obiektu wyświetlanej na ekranie, jak gdyby drukowany na drukarce.Wartość może być rozdzielane przecinkami listę wartości atrybutu z poniższej tabeli.Atrybutu tego można użyć, jeśli klasy COM jest klasa OCX, który wymaga MiscStatus wartości kluczy rejestru.
miscStatusThumbnail	Opcjonalne.Duplikaty w zestawie manifest informacji dostarczonych przez DVASPECT_THUMBNAIL.Umożliwia ona miniaturkę obiektu wyświetlane w narzędziu przeglądania.Wartość może być rozdzielane przecinkami listę wartości atrybutu z poniższej tabeli.Atrybutu tego można użyć, jeśli klasy COM jest klasa OCX, który wymaga MiscStatus wartości kluczy rejestru.

comInterfaceExternalProxyStub

comInterfaceExternalProxyStub Element jest opcjonalne dziecko file element, ale mogą być wymagane, jeżeli ClickOnce aplikacji zawiera składnik COM, zamierza wdrożyć za pomocą wolne rejestracji modelu COM.Element zawiera następujące atrybuty.

Atrybut	Opis
iid	Wymagane.Interfejs identyfikator (IID), która jest obsługiwana przez ten serwer proxy.Identyfikator IID musi mieć otaczających go w nawiasy klamrowe.
baseInterface	Opcjonalne.Identyfikator IID interfejsu, z którego odwołuje się interfejs iid pochodzi.
numMethods	Opcjonalne.Liczba metody implementowane przez interfejs.
name	Opcjonalne.Nazwa interfejsu w postaci, w jakiej pojawi się w kodzie.
tlbid	Opcjonalne.Biblioteki typów, która zawiera opis interfejsu określonego z iid atrybut.
proxyStubClass32	Opcjonalne.Odwzorowuje identyfikator IID identyfikatora CLSID serwera proxy 32-bitowe biblioteki DLL.

comInterfaceProxyStub

comInterfaceProxyStub Element jest opcjonalne dziecko file element, ale mogą być wymagane, jeżeli ClickOnce aplikacji zawiera składnik COM, zamierza wdrożyć za pomocą wolne rejestracji modelu COM.Element zawiera następujące atrybuty.

Atrybut	Opis
iid	Wymagane.Interfejs identyfikator (IID), która jest obsługiwana przez ten serwer proxy.Identyfikator IID musi mieć otaczających go w nawiasy klamrowe.
baseInterface	Opcjonalne.Identyfikator IID interfejsu, z którego odwołuje się interfejs iid pochodzi.
numMethods	Opcjonalne.Liczba metody implementowane przez interfejs.
Name	Opcjonalne.Nazwa interfejsu w postaci, w jakiej pojawi się w kodzie.
Tlbid	Opcjonalne.Biblioteki typów, która zawiera opis interfejsu określonego z iid atrybut.
proxyStubClass32	Opcjonalne.Odwzorowuje identyfikator IID identyfikatora CLSID serwera proxy 32-bitowe biblioteki DLL.
threadingModel	Opcjonalne.Opcjonalne.Model wątka używany przez wewnątrzprocesowe klasy COM.Jeśli ta właściwość ma wartość null, jest używany żaden model wątków.Składnik jest tworzony w głównym wątku klienta i wywołania z innych wątków są przekazywane międzyprocesowo do tego wątku.Na poniższej liście przedstawiono prawidłowe wartości: Apartament, wolnego, zarówno, i Neutral.

windowClass

windowClass Element jest opcjonalne dziecko file element, ale mogą być wymagane, jeżeli ClickOnce aplikacji zawiera składnik COM, zamierza wdrożyć za pomocą wolne rejestracji modelu COM.Element odnosi się do klasy okna, określonych przez składnik COM, który musi mieć wersję, stosowane do niego.Element zawiera następujące atrybuty.

Atrybut	Opis
versioned	Opcjonalne.Kontroluje, czy wewnętrznego okno klasy nazwa używana w rejestracji zawiera wersję zestawu, który zawiera klasy okna.Wartość tego atrybutu może być Tak lub nie.Wartością domyślną jest Tak.Wartość nie można używać tylko jeśli w tej samej klasy okna jest definiowane przez składnik side-by-side i równoważnych składnika non-side-by-side i chcesz je traktować jako tej samej klasy okna.Należy zauważyć, że stosuje się zwykłe zasady dotyczące rejestracji klasy okna — tylko pierwszego składnika, który rejestruje klasy okna będą mogli zarejestrować go, ponieważ nie ma wersji, stosowane do niego.

versioned

Opcjonalne.Kontroluje, czy wewnętrznego okno klasy nazwa używana w rejestracji zawiera wersję zestawu, który zawiera klasy okna.Wartość tego atrybutu może być Tak lub nie.Wartością domyślną jest Tak.Wartość nie można używać tylko jeśli w tej samej klasy okna jest definiowane przez składnik side-by-side i równoważnych składnika non-side-by-side i chcesz je traktować jako tej samej klasy okna.Należy zauważyć, że stosuje się zwykłe zasady dotyczące rejestracji klasy okna — tylko pierwszego składnika, który rejestruje klasy okna będą mogli zarejestrować go, ponieważ nie ma wersji, stosowane do niego.

hash

hash Element jest opcjonalne dziecko file element.hash Element nie posiada żadnych atrybutów.

ClickOnceużywa algorytmiczny mieszania wszystkie pliki w aplikacji w celu sprawdzenia zabezpieczeń, aby zapewnić, że żaden z plików zostały zmienione po wdrożeniu.Jeśli hash element nie jest włączone, nie można wykonać tego wyboru. W związku z tym, pomijając hash element nie jest zalecane.

Jeśli manifest zawiera plik, który nie jest mieszany, że manifest nie może być cyfrowo podpisane, ponieważ użytkownicy nie może sprawdzić zawartość pliku bez haszowania.

DSIG:TRANSFORMS

dsig:Transforms Element jest wymagany dziecko hash element.dsig:Transforms Element nie posiada żadnych atrybutów.

DSIG:Transform

dsig:Transform Element jest wymagany dziecko dsig:Transforms element.dsig:Transform Element ma następujące atrybuty.

Atrybut	Opis
Algorithm	Algorytm używany do obliczania szyfrowanego dla tego pliku.Obecnie tylko wartość używana przez ClickOnce jest urn: schemas-microsoft-com:HashTransforms.Identity.

DSIG:DigestMethod

dsig:DigestMethod Element jest wymagany dziecko hash element.dsig:DigestMethod Element ma następujące atrybuty.

Atrybut	Opis
Algorithm	Algorytm używany do obliczania szyfrowanego dla tego pliku.Obecnie tylko wartość używana przez ClickOnce jest http://www.w3.org/2000/09/xmldsig#sha1.

DSIG:DigestValue

dsig:DigestValue Element jest wymagany dziecko hash element.dsig:DigestValue Element nie posiada żadnych atrybutów.Jego wartość tekstowa jest obliczony skrót dla określonego pliku.

Uwagi

Element ten identyfikuje wszystkie pliki nonassembly, wchodzące w skład aplikacji, a w szczególności wartości mieszania dla pliku weryfikacji.Ten element może także zawierać dane izolacji hosta skryptów systemu Windows (COM, Component Object Model) skojarzonego z danym plikiem.Jeżeli zmiany w pliku, plik manifestu aplikacji również muszą być uaktualnione w celu odzwierciedlenia zmian.

Przykład

Poniższy przykład kodu ilustruje file elementów w aplikacji manifest aplikacji wdrożyć za 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>

Zobacz też

Informacje

Manifest aplikacji ClickOnce

Udostępnij za pośrednictwem