Udostępnij za pośrednictwem


Właściwości pliku

Właściwości pliku można użyć, aby wskazać, jakie działania systemu projektu należy wykonać na plikach.Na przykład można ustawić właściwości pliku, aby wskazać czy skompilowany lub osadzony w danych wyjściowych kompilacji jako zasób pliku.

Można wybrać dowolny plik w oknie Solution Explorer, a następnie sprawdź jego właściwości w oknie dialogowym właściwości.Pliki programu Visual Basic i Visual C# mają cztery właściwości: Nazwę pliku, Build Action, Niestandardowego narzędzia, i Niestandardowe narzędzie nazw.

[!UWAGA]

Build Action, Niestandardowego narzędzia, i Niestandardowe narzędzie nazw właściwości są przewidziane w zaawansowanych scenariuszach.Wartości domyślne są zwykle wystarczające i nie muszą być zmienione.

Właściwości Nazwa pliku

Można zmienić nazwę pliku, klikając Nazwę pliku właściwości w oknie dialogowym właściwości i wpisując nową nazwę.Należy zauważyć, że jeśli zmienisz nazwę pliku, program Visual Studio automatycznie zostaną zmienione nazwy .vb lub .resx pliki, które są skojarzone z nim.

Tworzenie właściwości Akcja

Build Action właściwość wskazuje, co Visual Studio działa z pliku po wykonaniu kompilacji.Tworzenie akcji może mieć jeden z kilku wartości:

  • Brak -plik nie znajduje się w grupie wyjście projektu i nie jest skompilowany w procesie kompilacji.Przykładem jest plik tekstowy, który zawiera dokumentacja, takich jak plik Readme.

  • Skompiluj -plik jest skompilowany w danych wyjściowych kompilacji.To ustawienie jest używane dla plików kodu.

  • Zawartość -plik nie jest skompilowany, ale znajduje się w grupie wyjście zawartości.Na przykład ustawienie wartość domyślna dla .htm lub innego rodzaju pliku sieci Web.

  • Osadzonego zasobu -ten plik jest osadzony w danych wyjściowych budowania projektu głównego jako biblioteki DLL lub plik wykonywalny.Jest ona zwykle używana dla plików zasobów.

    [!UWAGA]

    Build Action właściwość jest rozszerzalny.W rezultacie mogą być widoczne dodatkowe opcje wymienione dla tej właściwości, które zostały dodane przez inne produkty i funkcje.

Wartość domyślna dla Build Action zależy od rozszerzenia pliku, który można dodać do roztworu.Na przykład, jeśli dodasz Visual Basic project Solution Explorer wartości domyślne dla Build Action jest skompilować.Wynika to z .vb rozszerzenie wskazuje plik kod, który może zostać skompilowany.Nazwy plików i rozszerzenia są wyświetlane w oknie Solution Explorer.

Uwaga nazwy plików w projekcie nie będzie identyfikator zasobu zarządzanego w manifeście zestawu (zobacz Manifest zestawu Aby uzyskać więcej informacji).Identyfikator będzie namespace.filename.extension, gdzie obszaru nazw jest wartością DefaultNamespace właściwość w projekcie Visual C# lub RootNamespace właściwość w Visual Basic projektu.Nazwa pliku i rozszerzenie pozostają takie same, jak ich oryginalne nazwy.Jeśli plik jest w pliku .resx, projektu system uruchomi resgen.exe pliku, tworząc plik .resource.Plik .resource zostanie osadzony w zestawie.W związku z tym manifestu zestawu będzie można znaleźć w pliku .resources, a nie pliku .resx.

Na przykład dodać plik MyFile.bmp do projektu, którego domyślny obszar nazw jest MyProj i ustawić akcję build Zasobów osadzonych, MyProj.MyFile.bmp będzie identyfikator w manifeście zestawu.Jeśli plik MyFile.resx jest następnie dodany do projektu, będzie domyślna akcja build Zasobów osadzonych i MyProj.MyFile.resources będzie identyfikator w manifeście zestawu.

Należy zauważyć, że gdy Edytor zasobu dodaje obrazu, ustawia Build Action do Brak, ponieważ w pliku .resx odwołuje się do pliku obrazu.W czasie kompilacji obraz jest przyciągany do utworzone z pliku .resx w pliku .resources.Obraz następnie łatwo jest możliwy z klasy jednoznacznie określony automatycznie wygenerowana dla pliku .resx.W związku z tym, nie należy zmienić to ustawienie, aby Zasobów osadzonych, ponieważ w ten sposób mogłyby zawierać obraz dwa razy w zestawie.

Aby uzyskać więcej informacji dotyczących sposobu uzyskiwania dostępu do zasobów plików (skompilowany z plikami .resx) w czasie wykonywania, zobacz ResourceManager.Aby uzyskać więcej informacji dotyczących uzyskiwania dostępu do wszystkich innych do osadzonych plików i zasobów w czasie wykonywania, GetManifestResourceStream.

Kopiowanie do danych wyjściowych katalogu właściwości

Właściwość ta określa warunki, na jakich plik źródłowy wybranego zostanie skopiowana do katalogu dane wyjściowe.Wybierz nie należy kopiować , jeśli plik nigdy nie ma zostać skopiowany do katalogu dane wyjściowe.Wybierz kopiowania zawsze , jeśli plik jest zawsze mają być kopiowane do katalogu dane wyjściowe.Wybierz Kopiuj jeśli nowszy , jeśli plik jest mają być kopiowane tylko wtedy, gdy jest nowsza niż istniejący plik o tej samej nazwie w katalogu dane wyjściowe.

Informacji o zmienianiu katalog wyjściowy, zobacz Kompilacja strony, Project Designer (C#) lub Skompiluj strony, Project Designer (Visual Basic).

[!UWAGA]

W projektach urządzeń inteligentnych mają pliku DLL lub exe, jest określana przez porównywanie wersji systemu Win32 w następujący sposób:

Jeśli wersja po stronie urządzenia jest mniejsza niż pulpit, plik jest kopiowany.

Jeśli wersja urządzenia po stronie jest większa niż pulpit, plik nie zostanie skopiowany.

Jeśli wersje są takie same, wykonywane jest porównanie sumy kontrolnej.Jeśli sum kontrolnych są takie same, plik nie zostanie skopiowany.Jeśli sum kontrolnych są różne, plik jest kopiowany.

Nowość plików innych niż .dll i .exe jest oparta tylko na sumy kontrolnej.

[!UWAGA]

Pliki danych zostaną skopiowane do podfolderu o nazwie dane plików w katalogu dane wyjściowe.

Niestandardowe właściwości narzędzia

Narzędzia niestandardowe są składnikami, które mogą być używane do przekształcania plików z jednego typu na etapie projektowania.Na przykład niestandardowe narzędzie może być dataset generatora kodu, który czyta w pliku schematu XML (XSD) i generuje klas w pliku kod, który programowo udostępnia jej tabel i kolumn.Wstępnie zdefiniowane listy niestandardowych narzędzi jest dostępny w produkcie; Właściwość ta umożliwia Zobacz niestandardowe narzędzie, które jest stosowane do pliku.W rzadkich okolicznościach może trzeba zmienić wartość tej właściwości.Wartość tej właściwości musi być pusty lub jednego z wbudowanych narzędzi niestandardowych.

Aby ustawić lub zmienić narzędzia niestandardowe, kliknij przycisk CustomTool właściwość w oknie właściwości i wpisz nazwę niestandardowego narzędzia.

Właściwości niestandardowych nazw narzędzia

Jeśli niestandardowe narzędzie przypisany do projektu, Niestandardowe narzędzie obszaru nazw właściwość umożliwia określenie obszaru nazw, które chcesz przypisać kod generowany przez narzędzie niestandardowe.Kiedy określ wartość dla Niestandardowe narzędzie nazw właściwość, kod generowany przez narzędzie jest umieszczana w określonym obszarze nazw.Jeśli właściwość jest pusta, wygenerowany kod jest umieszczana w domyślny obszar nazw dla folderu, w którym znajduje się konwertowanego pliku.Dla programu Visual Basic jest to obszar nazw katalogu głównego projektu i dla Visual C# odpowiada ustawieniu DefaultNamespace właściwości folderu.

Zobacz też

Informacje

Program Debug i Release projektu konfiguracje

Koncepcje

Domyślne szablony projektu w programie Visual Studio

Typy plików i rozszerzeń nazw plików w języku Visual Basic i Visual C#

Inne zasoby

Zarządzanie rozwiązań, projektów i plików