Udostępnij za pośrednictwem

<InstallChecks> Element (program inicjujący)

  • Artykuł

InstallChecks Element obsługuje uruchamianie różnych testów w komputerze lokalnym, aby upewnić się, że wszystkie odpowiednie wymagania wstępne dla aplikacji jest zainstalowana.

<InstallChecks>
    <AssemblyCheck 
        Property
        Name
        PublicKeyToken
        Version
        Language
        ProcessorArchitecture
    />
    <RegistryCheck
        Property
        Key
        Value
    />
    <ExternalCheck 
        PackageFile
        Property
        Arguments
    />
    <FileCheck 
        Property
        FileName
        SearchPath
        SpecialFolder
        SearchDepth
    />
    <MsiProductCheck 
        Property
        Product
        Feature
    />
    <RegistryFileCheck 
        Property
        Key
        Value
        FileName
        SearchDepth
    />
</InstallChecks>

AssemblyCheck

Ten element jest elementem opcjonalne dziecko InstallChecks.Dla każdego wystąpienia AssemblyCheck, program inicjujący będzie upewnij się, że zgromadzenie identyfikowany przez element istnieje w globalna pamięć podręczna zestawów (GAC).Zawiera żadnych elementów i ma następujące atrybuty.

Atrybut

Opis

Property

Wymagane.Nazwa właściwości do przechowania.Właociwooć tę można odwoływać się z badania pod InstallConditions element, który jest elementem podrzędnym z Command element.Aby uzyskać więcej informacji, zobacz <Commands> Element (program inicjujący).

Name

Wymagane.Pełna nazwa zestawu do sprawdzenia.

PublicKeyToken

Wymagane.Skróconą postać klucza publicznego związane z tym silnej nazwy zestawu.Wszystkie zestawy przechowywane w pamięci podręcznej GAC musi mieć nazwę, wersję i klucz publiczny.

Version

Wymagane.Wersja zestawu.

Numer wersji ma format <wersja główna>. <wersji pomocniczej>. <Wersja kompilacji>. <wersji poprawki>.

Language

Opcjonalne.Język zestawu zlokalizowane.Wartością domyślną jest neutralne.

ProcessorArchitecture

Opcjonalne.Procesor komputera skierowane przez tę instalację.Wartością domyślną jest msil.

ExternalCheck

Ten element jest elementem opcjonalne dziecko InstallChecks.Dla każdego wystąpienia ExternalCheck, program inicjujący będzie wykonać nazwanego programu zewnętrznego w oddzielnym procesie i przechowywać jego kod wyjścia we właściwości wskazanej przez Property.ExternalCheckprzydaje się wykonywania kontroli złożonych zależności lub gdy jedyny sposób, aby sprawdzić, czy istnienie składnika jest utworzyć wystąpienia.

ExternalCheckzawiera żadnych elementów i ma następujące atrybuty.

Atrybut

Opis

Property

Wymagane.Nazwa właściwości do przechowania.Właociwooć tę można odwoływać się z badania pod InstallConditions element, który jest elementem podrzędnym z Command element.Aby uzyskać więcej informacji, zobacz <Commands> Element (program inicjujący).

PackageFile

Wymagane.Zewnętrzny program do wykonywania.Program musi być częścią instalacji pakietu dystrybucyjnego.

Arguments

Opcjonalne.Dostarcza argumentów wiersza polecenia do pliku wykonywalnego, o nazwie przez PackageFile.

FileCheck

Ten element jest elementem opcjonalne dziecko InstallChecks.Dla każdego wystąpienia FileCheck, program inicjujący ustalić, czy istnieje nazwanego pliku i zwraca numer wersji pliku.Jeśli plik nie ma numer wersji, program inicjujący ustawia właściwość o nazwie przez Property na 0.Jeśli plik nie istnieje, Property nie ustawiono żadnej wartości.

FileCheckzawiera żadnych elementów i ma następujące atrybuty.

Atrybut

Opis

Property

Wymagane.Nazwa właściwości do przechowania.Właociwooć tę można odwoływać się z badania pod InstallConditions element, który jest elementem podrzędnym z Command element.Aby uzyskać więcej informacji, zobacz <Commands> Element (program inicjujący).

FileName

Wymagane.Nazwa pliku, aby znaleźć.

SearchPath

Wymagane.Dysk lub folder, w którym wyszukać plik.Musi to być ścieżka względna SpecialFolder został przydzielony; w przeciwnym razie musi to być ścieżką bezwzględną.

SpecialFolder

Opcjonalne.Folder, który ma specjalne znaczenie w systemie Windows lub do ClickOnce.Wartością domyślną jest do interpretowania SearchPath jako ścieżkę bezwzględną.Prawidłowymi wartościami są następujące:

Folder AppDataFolder.Folder dane aplikacji w tym ClickOnce wniosku; specyficzne dla bieżącego użytkownika.

CommonAppDataFolder.Folder dane aplikacji używane przez wszystkich użytkowników.

CommonFilesFolder.Folder plików wspólnych dla bieżącego użytkownika.

LocalDataAppFolder.Folder dane aplikacji-roaming.

ProgramFilesFolder.Standard folderu Program Files aplikacje 32-bitowe.

StartUpFolder.Folder, który zawiera wszystkie aplikacje uruchamiane przy uruchamianiu systemu.

SystemFolder.Folder, który zawiera system 32-bitowe biblioteki DLL.

WindowsFolder.Folder, który zawiera instalację systemu Windows.

WindowsVolume.Dysk lub partycja zawierająca instalację systemu Windows.

SearchDepth

Opcjonalne.Głębokość, na który ma być wyszukany podfoldery dla nazwanego pliku.Wyszukiwanie jest pierwszym głębokość.Wartością domyślną jest 0, co ogranicza wyszukiwanie do folderu najwyższego poziomu, określonej przez SpecialFolder i SearchPath.

MsiProductCheck

Ten element jest elementem opcjonalne dziecko InstallChecks.Dla każdego wystąpienia MsiProductCheck, program inicjujący sprawdza, czy określony instalacji Instalator systemu Microsoft Windows zostało uruchomione, dopóki zostanie ukończona.Wartość właściwości jest ustawiona w zależności od stanu tego produktu zainstalowane.Wartość dodatnia wskazuje na produkt jest zainstalowany, 0 lub wartość -1 wskazuje, nie jest zainstalowany.(Proszę Zobacz funkcja SDK Instalator Windows MsiQueryFeatureState, aby uzyskać więcej informacji). .Jeśli Instalator Windows nie jest zainstalowany na komputerze, Property nie jest ustawiona.

MsiProductCheckzawiera żadnych elementów i ma następujące atrybuty.

Atrybut

Opis

Property

Wymagane.Nazwa właściwości do przechowania.Właociwooć tę można odwoływać się z badania pod InstallConditions element, który jest elementem podrzędnym z Command element.Aby uzyskać więcej informacji, zobacz <Commands> Element (program inicjujący).

Product

Wymagane.Identyfikator GUID dla zainstalowanego produktu.

Feature

Opcjonalne.Identyfikator GUID określoną funkcję zainstalowaną aplikację.

RegistryCheck

Ten element jest elementem opcjonalne dziecko InstallChecks.Dla każdego wystąpienia RegistryCheck, program inicjujący sprawdza, czy istnieje określony klucz rejestru lub czy ma podaną wartość.

RegistryCheckzawiera żadnych elementów i ma następujące atrybuty.

Atrybut

Opis

Property

Wymagane.Nazwa właściwości do przechowania.Właociwooć tę można odwoływać się z badania pod InstallConditions element, który jest elementem podrzędnym z Command element.Aby uzyskać więcej informacji, zobacz <Commands> Element (program inicjujący).

Key

Wymagane.Nazwa klucza rejestru.

Value

Opcjonalne.Nazwa wartości rejestru do pobrania.Wartość domyślna to zwrócić tekst wartości domyślne.Valuemusi być ciąg lub wartość typu DWORD.

RegistryFileCheck

Ten element jest elementem opcjonalne dziecko InstallChecks.Dla każdego wystąpienia RegistryFileCheck, program inicjujący pobiera wersję określonego pliku pierwszej próby pobierania ścieżki do pliku z określonego klucza rejestru.Jest to szczególnie przydatne, jeśli chcesz wyszukać plik w katalogu, określony jako wartość w rejestrze.

RegistryFileCheckzawiera żadnych elementów i ma następujące atrybuty.

Atrybut

Opis

Property

Wymagane.Nazwa właściwości do przechowania.Właociwooć tę można odwoływać się z badania pod InstallConditions element, który jest elementem podrzędnym z Command element.Aby uzyskać więcej informacji, zobacz <Commands> Element (program inicjujący).

Key

Wymagane.Nazwa klucza rejestru.Jego wartość jest interpretowana jako ścieżka do pliku, chyba że File ustawiono atrybut.Jeśli ten klucz nie istnieje, Property nie jest ustawiona.

Value

Opcjonalne.Nazwa wartości rejestru do pobrania.Wartość domyślna to zwrócić tekst wartości domyślne.Valuemusi być ciągiem.

FileName

Opcjonalne.Nazwa pliku.Jeśli określono, wartości uzyskane z klucza rejestru uznaje się ścieżki katalogu i nazwa ta jest dołączana do niego.Jeśli nie jest określony, wartość zwracana z rejestru zakłada się pełną ścieżkę do pliku.

SearchDepth

Opcjonalne.Głębokość, na który ma być wyszukany podfoldery dla nazwanego pliku.Wyszukiwanie jest pierwszym głębokość.Wartość domyślna to 0, co ogranicza wyszukiwanie do folderu najwyższego poziomu, określony przez wartość klucza rejestru.

Uwagi

Podczas gdy elementów znajdujących się pod InstallChecks definiować testy, aby uruchomić, nie realizują je.Aby wykonać testy, należy utworzyć Command elementów znajdujących się pod Commands element.

Przykład

Poniższy przykład kodu pokazuje InstallChecks element, jak jest używany w pliku produktu .NET Framework.

<InstallChecks>
    <ExternalCheck Property="DotNetInstalled" PackageFile="dotnetchk.exe" />
    <RegistryCheck Property="IEVersion" Key="HKLM\Software\Microsoft\Internet Explorer" Value="Version" />
</InstallChecks>

InstallConditions

Gdy InstallChecks są oceniane, wytwarzają właściwości.Właściwości są następnie używane przez InstallConditions czy pakiet należy zainstalować, pomijanie czy zakończyć się niepowodzeniem.Poniższej tabeli list InstallConditions:

FailIf

Ewentualne FailIf warunek ma wartość PRAWDA, pakiet nie powiedzie się.Pozostałe warunki nie będą poddane ocenie.

BypassIf

Ewentualne BypassIf warunek ma wartość PRAWDA, pakiet zostanie pominięte.Pozostałe warunki nie będą poddane ocenie.

Wstępnie zdefiniowane właściwości

Poniższej tabeli list BypassIf i FailIf elementów:

Właściwość

Notatki

Możliwe wartości

Version9X

Numer wersji systemu operacyjnego Windows 9 X.

4.10 = Windows 98

VersionNT

Numer wersji systemu operacyjnego opartych na systemie Windows NT.

Major.minor.ServicePack

5.0 = Systemu Windows 2000

5.1.0 = Systemu Windows XP

5.1.2 = Windows XP Professional z dodatkiem SP2

5.2.0 = Systemu Windows Server 2003

VersionNT64

Numer wersji 64-bitowego systemu operacyjnego opartych na systemie Windows NT.

Takie same jak wspomniano wcześniej.

VersionMsi

Numer wersji usługi Instalator Windows.

2.0 = Instalator Windows 2.0

AdminUser

Określa, czy użytkownik ma uprawnienia administratora w systemie operacyjnym dla komputerów z systemem Windows NT.

0 = nie uprawnień administratora

1 = uprawnień administratora

Na przykład zablokować instalacji na komputerze z systemem Windows 95, należy użyć kodu, takie jak:

<!-- Block install on Windows 95 -->
    <FailIf Property="Version9X" Compare="VersionLessThan" Value="4.10" String="InvalidPlatform"/>

Zobacz też

Informacje

<Commands> Element (program inicjujący)

Produkt i pakiet schematu odwołania