<file> , element (aplikacja ClickOnce)

  • Artykuł

Identyfikuje wszystkie pliki inne niżssembly pobrane i używane przez aplikację.

Składnia

<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

Element file jest opcjonalny. Element ma następujące atrybuty.

Atrybut opis
name Wymagane. Identyfikuje nazwę pliku.
size Wymagany. Określa rozmiar pliku w bajtach.
group Opcjonalnie, jeśli optional atrybut nie jest określony lub ustawiony na false; wymagane, jeśli optional ma wartość true. Nazwa grupy, do której należy ten plik. Nazwa może być dowolną wartością ciągu Unicode wybraną przez dewelopera i służy do pobierania plików na żądanie z klasą ApplicationDeployment .
optional Opcjonalny. Określa, czy ten plik musi zostać pobrany po pierwszym uruchomieniu aplikacji, czy plik powinien znajdować się tylko na serwerze, dopóki aplikacja nie zażąda jej na żądanie. Jeśli false plik jest niezdefiniowany lub niezdefiniowany, zostanie pobrany po pierwszym uruchomieniu lub zainstalowaniu aplikacji. Jeśli trueparametr musi group być określony, aby manifest aplikacji był prawidłowy. optional nie może mieć wartości true, jeśli writeableType jest określona z wartością applicationData.
writeableType Opcjonalny. Określa, że ten plik jest plikiem danych. Obecnie jedyną prawidłową wartością jest applicationData.

Typelib

Element typelib jest opcjonalnym elementem podrzędnym elementu pliku. Element opisuje bibliotekę typów należącą do składnika COM. Element ma następujące atrybuty.

Atrybut opis
tlbid Wymagane. Identyfikator GUID przypisany do biblioteki typów.
version Wymagany. Numer wersji biblioteki typów.
helpdir Wymagany. Katalog zawierający pliki Pomocy dla składnika. Może być zerowa długość.
resourceid Opcjonalny. Reprezentacja ciągu szesnastkowego identyfikatora ustawień regionalnych (LCID). Jest to jedna do czterech cyfr szesnastkowe bez prefiksu 0x i bez zer wiodących. Identyfikator LCID może mieć neutralny identyfikator podjęzyczności.
flags Opcjonalny. Reprezentacja ciągu flag biblioteki typów dla tej biblioteki typów. W szczególności powinno to być jedno z "OGRANICZONYch", "CONTROL", "HIDDEN" i "HASDISKIMAGE".

comClass

Element comClass jest opcjonalnym elementem podrzędnym file elementu, ale jest wymagany, jeśli aplikacja ClickOnce zawiera składnik COM, który zamierza wdrożyć przy użyciu modelu COM bez rejestracji. Element ma następujące atrybuty.

Atrybut opis
clsid Wymagane. Identyfikator klasy składnika COM wyrażony jako identyfikator GUID.
description Opcjonalny. Nazwa klasy.
threadingModel Opcjonalny. Model wątkowania używany przez klasy COM w procesie. Jeśli ta właściwość ma wartość null, nie jest używany żaden model wątkowania. Składnik jest tworzony w głównym wątku klienta, a wywołania z innych wątków są marshalowane do tego wątku. Poniższa lista zawiera prawidłowe wartości:

Apartment, Free, Both i Neutral.
tlbid Opcjonalny. Identyfikator GUID biblioteki typów dla tego składnika COM.
progid Opcjonalny. Identyfikator programowy zależny od wersji skojarzony ze składnikiem COM. Format obiektu ProgID to <vendor>.<component>.<version>.
miscStatus Opcjonalny. Duplikaty w manifeście zestawu zawierają informacje dostarczone przez MiscStatus klucz rejestru. Jeśli nie można odnaleźć wartości atrybutów miscStatusIcon, miscStatusContent, miscStatusDocprintlub miscStatusThumbnail , odpowiednia wartość domyślna wymieniona w pliku miscStatus jest używana dla brakujących atrybutów. Wartość może być rozdzielaną przecinkami listą wartości atrybutów z poniższej tabeli. Tego atrybutu można użyć, jeśli klasa COM jest klasą OCX, która wymaga MiscStatus wartości klucza rejestru.
miscStatusIcon Opcjonalny. Duplikaty w manifeście zestawu informacje dostarczone przez DVASPECT_ICON. Może on podać ikonę obiektu. Wartość może być rozdzielaną przecinkami listą wartości atrybutów z poniższej tabeli. Tego atrybutu można użyć, jeśli klasa COM jest klasą OCX, która wymaga Miscstatus wartości klucza rejestru.
miscStatusContent Opcjonalny. Duplikaty w manifeście zestawu informacje dostarczone przez DVASPECT_CONTENT. Może zapewnić dokument złożony do wyświetlania na ekranie lub drukarce. Wartość może być rozdzielaną przecinkami listą wartości atrybutów z poniższej tabeli. Tego atrybutu można użyć, jeśli klasa COM jest klasą OCX, która wymaga MiscStatus wartości klucza rejestru.
miscStatusDocPrint Opcjonalny. Duplikaty w manifeście zestawu informacje dostarczone przez DVASPECT_DOCPRINT. Może zapewnić reprezentację obiektu wyświetlaną na ekranie tak, jakby wydrukowano na drukarce. Wartość może być rozdzielaną przecinkami listą wartości atrybutów z poniższej tabeli. Tego atrybutu można użyć, jeśli klasa COM jest klasą OCX, która wymaga MiscStatus wartości klucza rejestru.
miscStatusThumbnail Opcjonalny. Duplikaty w manifeście zestawu informacje dostarczone przez DVASPECT_THUMBNAIL. Może on udostępnić miniaturę obiektu, który można wyświetlić w narzędziu przeglądania. Wartość może być rozdzielaną przecinkami listą wartości atrybutów z poniższej tabeli. Tego atrybutu można użyć, jeśli klasa COM jest klasą OCX, która wymaga MiscStatus wartości klucza rejestru.

comInterfaceExternalProxyStub

Element comInterfaceExternalProxyStub jest opcjonalnym elementem podrzędnym file elementu, ale może być wymagany, jeśli aplikacja ClickOnce zawiera składnik COM, który zamierza wdrożyć przy użyciu modelu COM bez rejestracji. Element zawiera następujące atrybuty.

Atrybut opis
iid Wymagane. Identyfikator interfejsu (IID), który jest obsługiwany przez ten serwer proxy. Identyfikator IID musi zawierać nawiasy klamrowe wokół niego.
baseInterface Opcjonalny. Identyfikator IID interfejsu, z którego pochodzi interfejs, do którego odwołuje iid się interfejs.
numMethods Opcjonalny. Liczba metod implementowanych przez interfejs.
name Opcjonalny. Nazwa interfejsu wyświetlana w kodzie.
tlbid Opcjonalny. Biblioteka typów zawierająca opis interfejsu określonego iid przez atrybut.
proxyStubClass32 Opcjonalny. Mapy identyfikator IID do identyfikatora CLSID w 32-bitowych bibliotekach DLL serwera proxy.

comInterfaceProxyStub

Element comInterfaceProxyStub jest opcjonalnym elementem podrzędnym file elementu, ale może być wymagany, jeśli aplikacja ClickOnce zawiera składnik COM, który zamierza wdrożyć przy użyciu modelu COM bez rejestracji. Element zawiera następujące atrybuty.

Atrybut opis
iid Wymagane. Identyfikator interfejsu (IID), który jest obsługiwany przez ten serwer proxy. Identyfikator IID musi zawierać nawiasy klamrowe wokół niego.
baseInterface Opcjonalny. Identyfikator IID interfejsu, z którego pochodzi interfejs, do którego odwołuje iid się interfejs.
numMethods Opcjonalny. Liczba metod implementowanych przez interfejs.
Name Opcjonalny. Nazwa interfejsu wyświetlana w kodzie.
Tlbid Opcjonalny. Biblioteka typów zawierająca opis interfejsu określonego iid przez atrybut.
proxyStubClass32 Opcjonalny. Mapy identyfikator IID do identyfikatora CLSID w 32-bitowych bibliotekach DLL serwera proxy.
threadingModel Opcjonalny. Opcjonalny. Model wątkowania używany przez klasy COM w procesie. Jeśli ta właściwość ma wartość null, nie jest używany żaden model wątkowania. Składnik jest tworzony w głównym wątku klienta, a wywołania z innych wątków są marshalowane do tego wątku. Poniższa lista zawiera prawidłowe wartości:

Apartment, Free, Both i Neutral.

windowClass

Element windowClass jest opcjonalnym elementem podrzędnym file elementu, ale może być wymagany, jeśli aplikacja ClickOnce zawiera składnik COM, który zamierza wdrożyć przy użyciu modelu COM bez rejestracji. Element odwołuje się do klasy okna zdefiniowanej przez składnik COM, który musi mieć zastosowaną wersję. Element zawiera następujące atrybuty.

Atrybut opis
versioned Opcjonalny. Określa, czy wewnętrzna nazwa klasy okien używana w rejestracji zawiera wersję zestawu, który zawiera klasę okien. Wartość tego atrybutu może mieć yes wartość lub no. Wartość domyślna to yes. Wartość no powinna być używana tylko wtedy, gdy ta sama klasa okna jest definiowana przez składnik side-by-side i równoważny składnik inny niż obok siebie i chcesz traktować je jako tę samą klasę okien. Należy pamiętać, że mają zastosowanie zwykłe reguły dotyczące rejestracji klas okien — tylko pierwszy składnik rejestrujący klasę okien będzie mógł ją zarejestrować, ponieważ nie ma do niej zastosowanej wersji.

hash

Element hash jest opcjonalnym elementem podrzędnym file elementu. Element hash nie ma atrybutów.

Funkcja ClickOnce używa algorytmowego skrótu wszystkich plików w aplikacji jako sprawdzenia zabezpieczeń, aby upewnić się, że żadne z plików nie zostało zmienione po wdrożeniu. hash Jeśli element nie zostanie uwzględniony, to sprawdzenie nie zostanie wykonane. W związku z tym pominięcie hash elementu nie jest zalecane.

Jeśli manifest zawiera plik, który nie jest skrótem, ten manifest nie może być podpisany cyfrowo, ponieważ użytkownicy nie mogą zweryfikować zawartości pliku bez skrótu.

dsig:Transforms

Element dsig:Transforms jest wymaganym elementem podrzędnym hash elementu. Element dsig:Transforms nie ma atrybutów.

dsig:Transform

Element dsig:Transform jest wymaganym elementem podrzędnym dsig:Transforms elementu. Element dsig:Transform ma następujące atrybuty.

Atrybut opis
Algorithm Algorytm używany do obliczania skrótu dla tego pliku. Obecnie jedyną wartością używaną przez ClickOnce jest urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

Element dsig:DigestMethod jest wymaganym elementem podrzędnym hash elementu. Element dsig:DigestMethod ma następujące atrybuty.

Atrybut opis
Algorithm Algorytm używany do obliczania skrótu dla tego pliku. Obecnie jedyną wartością używaną przez ClickOnce jest http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

Element dsig:DigestValue jest wymaganym elementem podrzędnym hash elementu. Element dsig:DigestValue nie ma atrybutów. Jego wartość tekstowa to obliczony skrót dla określonego pliku.

Uwagi

Ten element identyfikuje wszystkie pliki niezwiązane z aplikacją, a w szczególności wartości skrótu na potrzeby weryfikacji pliku. Ten element może również zawierać dane izolacji modelu obiektów składników (COM) skojarzone z plikiem. Jeśli plik ulegnie zmianie, należy również zaktualizować plik manifestu aplikacji, aby odzwierciedlić zmianę.

Przykład

Poniższy przykład kodu ilustruje file elementy w manifeście aplikacji wdrożonej przy użyciu technologii 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ż