<deployment> Element (wdrażania ClickOnce)
Określa atrybuty używane do wdrażania aktualizacji i działanie systemu.
<deployment
install
minimumRequiredVersion
mapFileExtensions
disallowUrlActivation
trustUrlParameters
>
<subscription>
<update>
<beforeApplicationStartup/>
<expiration
maximumAge
unit
/>
</update>
</subscription>
<deploymentProvider
codebase
/>
</deployment>
Elementy i atrybuty
deployment Element jest wymagany i jest w urn:schemas-microsoft-com:asm.v1 obszaru nazw.Atrybuty elementu.
Atrybut |
Opis |
|---|---|
install |
Wymagane.Określa, czy ta aplikacja definiuje obecność systemu Windows uruchomić menu i w Panelu sterowania Dodaj lub usuń programy aplikacji.Prawidłowe wartości to true i false.Jeśli false, ClickOnce zawsze uruchomić najnowszą wersję tej aplikacji z sieci i nie rozpoznaje subscription element. |
minimumRequiredVersion |
Opcjonalne.Określa minimalną wersję tej aplikacji, które można uruchomić na komputerze klienckim.Jeśli numer wersji aplikacji jest mniejsza niż numer wersji dostarczanych w manifeście wdrażania, aplikacja nie będzie działać.Należy określić numery wersji w formacie N.N.N.N, gdzie n jest liczbą całkowitą bez znaku.Jeśli install atrybut jest false, minimumRequiredVersion nie może być ustawiona. |
mapFileExtensions |
Opcjonalne.Domyślne, aby false.Jeśli true, wszystkie pliki w rozmieszczeniu musi mieć rozszerzenie .deploy.ClickOncebędzie strip to rozszerzenie tych plików, tak szybko, jak pobiera je z serwera sieci Web.Jeśli opublikowaniem aplikacji za pomocą Visual Studio, automatycznie dodaje rozszerzenie do wszystkich plików.Ten parametr umożliwia wszystkie pliki znajdujące się w ClickOnce wdrażania, które mają być pobrane z serwera sieci Web, która blokuje przekazywania plików kończy się za "niebezpieczne" rozszerzeniami, takimi jak exe. |
disallowUrlActivation |
Opcjonalne.Domyślne, aby false.Jeśli true, uniemożliwia uruchomienie klikając adres URL lub wprowadzając adres URL w programie Internet Explorer zainstalowanej aplikacji.Jeśli install atrybut nie jest obecny, atrybut ten jest ignorowany. |
trustURLParameters |
Opcjonalne.Domyślne, aby false.Jeśli true, pozwala na adres URL, który zawiera parametry ciągu kwerendy, które są przekazywane do aplikacji, wiele podobnych argumentów wiersza polecenia są przekazywane do aplikacji wiersza polecenia.Aby uzyskać więcej informacji, zobacz Jak: pobieranie informacji ciąg kwerendy w aplikacji Online ClickOnce. Jeśli disallowUrlActivation atrybut jest true, trustUrlParameters musi być wyłączone z manifestu albo jawnie ustawiona na false. |
deployment Element zawiera również następujące elementy podrzędne.
Subskrypcja
Opcjonalne.Zawiera update element.subscription Element nie posiada żadnych atrybutów.Jeśli subscription element nie istnieje, ClickOnce aplikacji nigdy nie będzie skanowania w poszukiwaniu aktualizacji.Jeśli install atrybutu deployment jest elementem false, subscription element jest ignorowany, ponieważ ClickOnce aplikacji, który jest uruchamiany z sieci, zawsze używa najnowszej wersji.
Aktualizacja
Wymagane.Ten element jest elementem podrzędnym subscription element i zawiera albo beforeApplicationStartup lub expiration element.beforeApplicationStartupi expiration nie można określić w tym samym manifestu wdrażania.
update Element nie posiada żadnych atrybutów.
beforeApplicationStartup
Opcjonalne.Ten element jest elementem podrzędnym update element i posiada żadnych atrybutów.Gdy beforeApplicationStartup elementu istnieje, aplikacja będzie blokowane, gdy ClickOnce sprawdza, czy aktualizacje, jeśli klient jest w trybie online.Jeśli ten element nie istnieje, ClickOnce będzie najpierw Skanuj w poszukiwaniu aktualizacji, na podstawie wartości określonej dla expiration element.beforeApplicationStartupi expiration nie można określić w tym samym manifestu wdrażania.
wygaśnięcie
Opcjonalne.Ten element jest elementem podrzędnym update element, i nie ma elementów podrzędnych.beforeApplicationStartupi expiration nie można określić w tym samym manifestu wdrażania.Jeżeli sprawdzanie aktualizacji występuje zaktualizowanej wersji zostanie wykryte, nowa wersja buforuje podczas wykonywania istniejącej wersji.Nowa wersja instaluje na następnego uruchomienia ClickOnce aplikacji.
expiration Element obsługuje następujące atrybuty.
Atrybut |
Opis |
|---|---|
maximumAge |
Wymagane.Określa, ile starych obecna aktualizacja powinna stać się zanim aplikacja wykonuje sprawdzanie aktualizacji.Jednostki czasu jest określona przez unit atrybut. |
unit |
Wymagane.Identyfikuje jednostkę czasu dla maximumAge.Poprawnymi jednostkami są godzin, dni, i tygodni. |
deploymentProvider
Dla.NET Framework 2.0, ten element jest wymagany, jeżeli manifest rozmieszczania zawiera subscription sekcji.Dla.NET Framework 3.5 i później, element ten jest opcjonalny i jest domyślnie ustawiana na ścieżkę serwera i pliku, w którym zostało wykryte w manifeście wdrażania.
Ten element jest elementem podrzędnym deployment element i ma następujący atrybut.
Atrybut |
Opis |
|---|---|
codebase |
Wymagane.Identyfikuje lokalizację, jako identyfikator URI (Uniform Resource), manifestu wdrażania, która jest używana do aktualizacji ClickOnce aplikacji.Ten element umożliwia również przekazywanie lokalizacje aktualizacji do instalacji opartych na dysku CD.Musi być prawidłowy identyfikator URI. |
Uwagi
Można skonfigurować Twoje ClickOnce aplikacji do skanowania w poszukiwaniu aktualizacji podczas uruchamiania, Skanuj w poszukiwaniu aktualizacji po uruchomieniu systemu lub nigdy nie sprawdzaj aktualizacje.Do skanowania w poszukiwaniu aktualizacji podczas uruchamiania, zapewnić, że beforeApplicationStartup istnieje element pod update element.Do skanowania w poszukiwaniu aktualizacji po uruchomieniu systemu, zapewnić, że expiration istnieje element pod update element, i że przewidziane są interwały aktualizacji.
Aby wyłączyć sprawdzanie aktualizacji, należy usunąć subscription element.Podczas określania w manifeście wdrażania, aby nigdy nie Skanuj w poszukiwaniu aktualizacji użytkownik może nadal ręcznie sprawdzić aktualizacje za pomocą CheckForUpdate metody.
Aby uzyskać więcej informacji dotyczących sposobu deploymentProvider odnosi się do aktualizacji, zobacz Wybór strategii ClickOnce aktualizacji.
Przykłady
Poniższy przykład kodu ilustruje deployment element w ClickOnce wdrażania manifestu.W przykładzie użyto deploymentProvider element do wskazania lokalizacji preferowany aktualizacji.
<deployment install="true" minimumRequiredVersion="2.0.0.0" mapFileExtension="true" trustUrlParameters="true">
<subscription>
<update>
<expiration maximumAge="6" unit="hours" />
</update>
</subscription>
<deploymentProvider codebase="http://www.adatum.com/MyApplication.application" />
</deployment>