<file> , element (aplikacja ClickOnce)

Artykuł
08/25/2023

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 `true`parametr 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`, `miscStatusDocprint`lub `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.

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ż

Manifest aplikacji ClickOnce

Udostępnij za pośrednictwem