Określanie plików publikowanych za pomocą technologii ClickOnce

Podczas publikowania aplikacji ClickOnce wszystkie pliki inne niż kod w projekcie są wdrażane wraz z aplikacją. W niektórych przypadkach możesz nie chcieć lub opublikować określone pliki lub chcieć zainstalować określone pliki na podstawie warunków. Program Visual Studio zapewnia możliwości wykluczania plików, oznaczania plików jako plików danych lub wymagań wstępnych oraz tworzenia grup plików na potrzeby instalacji warunkowej.

Pliki aplikacji ClickOnce są zarządzane w oknie dialogowym Pliki aplikacji dostępne na stronie Publikowanie Projektant projektu.

Początkowo istnieje jedna grupa plików o nazwie (wymagane). Możesz utworzyć dodatkowe grupy plików i przypisać do nich pliki. Nie można zmienić grupy pobierania dla plików, które są wymagane do uruchomienia aplikacji. Na przykład plik exe lub pliki aplikacji oznaczone jako pliki danych muszą należeć do grupy (Wymagane).

Domyślna wartość stanu publikowania pliku jest oznaczona tagiem (Auto). Na przykład plik .exe aplikacji ma domyślnie stan publikowania Include (Auto).

Pliki z właściwością Akcja kompilacji ustawioną na Zawartość są oznaczone jako pliki aplikacji i będą domyślnie oznaczone jako dołączone. Można je uwzględnić, wykluczyć lub oznaczyć jako pliki danych. Wyjątki są następujące:

  • Pliki danych, takie jak pliki usługi SQL Database (mdf i mdb) oraz pliki XML, będą domyślnie oznaczone jako pliki danych.

  • Odwołania do zestawów (pliki dll ) są wyznaczone w następujący sposób podczas dodawania odwołania: Jeśli pole Kopiuj lokalnie ma wartość False, jest domyślnie oznaczone jako zestaw wymagań wstępnych (wymaganie wstępne (auto)), który musi znajdować się w GAC przed zainstalowaniem aplikacji. Jeśli wartość Copy Local ma wartość True, zestaw jest domyślnie oznaczony jako zestaw aplikacji (Dołączanie (auto)) i zostanie skopiowany do folderu aplikacji podczas instalacji. Odwołanie COM zostanie wyświetlone w oknie dialogowym Pliki aplikacji (jako plik ocx ) tylko wtedy, gdy jego właściwość Izolowana ma wartość True. Domyślnie zostanie ona dołączona.

Aby dodać pliki do okna dialogowego Pliki aplikacji

  1. Wybierz plik danych w Eksplorator rozwiązań.

  2. W okno Właściwości zmień właściwość Akcja kompilacji na wartość Zawartość.

Aby wykluczyć pliki z publikowania technologii ClickOnce

  1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

  2. Kliknij kartę Publikuj .

    Uwaga

    W technologii ClickOnce dla platformy .NET Core 3.1 i .NET 5 lub nowszej można ustawić właściwości wdrożenia przy użyciu narzędzia Publikuj zamiast kreatora Publikowanie i strony Publikowanie w programie Project Projektant. Aby uzyskać więcej informacji, zobacz Deploy a .NET Windows application using ClickOnce and ClickOnce for .NET (Wdrażanie aplikacji .NET przy użyciu technologii ClickOnce i ClickOnce dla platformy .NET).

  3. Kliknij przycisk Pliki aplikacji, aby otworzyć okno dialogowe Pliki aplikacji.

  4. W oknie dialogowym Pliki aplikacji wybierz plik, który chcesz wykluczyć.

  5. W polu Stan publikowania wybierz pozycję Wyklucz z listy rozwijanej.

Aby oznaczyć pliki jako pliki danych

  1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

  2. Kliknij kartę Publikuj .

  3. Kliknij przycisk Pliki aplikacji, aby otworzyć okno dialogowe Pliki aplikacji.

  4. W oknie dialogowym Pliki aplikacji wybierz plik, który chcesz oznaczyć jako dane.

  5. W polu Stan publikowania wybierz pozycję Plik danych z listy rozwijanej.

Aby oznaczyć pliki jako wymagania wstępne

  1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

  2. Kliknij kartę Publikuj .

  3. Kliknij przycisk Pliki aplikacji, aby otworzyć okno dialogowe Pliki aplikacji.

  4. W oknie dialogowym Pliki aplikacji wybierz zestaw aplikacji (plik dll), który chcesz oznaczyć jako wymaganie wstępne. Należy pamiętać, że aplikacja musi mieć odwołanie do zestawu aplikacji, aby była wyświetlana na liście.

  5. W polu Stan publikowania wybierz pozycję Wymagania wstępne z listy rozwijanej.

Aby dodać nową grupę plików

  1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

  2. Kliknij kartę Publikuj .

  3. Kliknij przycisk Pliki aplikacji, aby otworzyć okno dialogowe Pliki aplikacji.

  4. W oknie dialogowym Pliki aplikacji wybierz pole Grupa dla pliku, który chcesz uwzględnić w nowej grupie.

    Uwaga

    Pliki muszą mieć właściwość Akcja kompilacji ustawioną na Zawartość, zanim nazwy plików pojawią się w oknie dialogowym Pliki aplikacji.

  5. W polu Pobierz grupę wybierz pozycję <Nowy...> z listy rozwijanej.

  6. W oknie dialogowym Nowa grupa wprowadź nazwę grupy, a następnie kliknij przycisk OK.

Aby dodać plik do grupy

  1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

  2. Kliknij kartę Publikuj .

  3. Kliknij przycisk Pliki aplikacji, aby otworzyć okno dialogowe Pliki aplikacji.

  4. W oknie dialogowym Pliki aplikacji wybierz pole Grupa dla pliku, który chcesz uwzględnić w nowej grupie.

  5. W polu Pobierz grupę wybierz grupę z listy rozwijanej.

    Uwaga

    Nie można zmienić grupy pobierania dla plików, które są wymagane do uruchomienia aplikacji.