Ustawianie atrybutów zestawu

Atrybuty zestawu są wartościami, które zawierają informacje o zestawie. Atrybuty są podzielone na następujące zestawy informacji:

  • Atrybuty tożsamości zestawu

  • Atrybuty informacyjne

  • Atrybuty manifestu zestawu

  • Atrybuty silnej nazwy

Atrybuty tożsamości zestawu

Trzy atrybuty wraz z silną nazwą (jeśli dotyczy) określają tożsamość zestawu: nazwę, wersję i kulturę. Te atrybuty tworzą pełną nazwę zestawu i są wymagane podczas odwoływania się do zestawu w kodzie. Można użyć atrybutów, aby ustawić wersję i kulturę zestawu. Kompilator lub konsolidator zestawu (Al.exe) ustawia wartość nazwy podczas tworzenia zestawu, na podstawie pliku zawierającego manifest zestawu.

W poniższej tabeli opisano atrybuty wersji i kultury.

Atrybut tożsamości zestawu Opis
AssemblyCultureAttribute Pole wyliczane wskazujące kulturę obsługiwaną przez zestaw. Zestaw może również określać niezależność kultury, wskazując, że zawiera zasoby dla kultury domyślnej. Uwaga: Środowisko uruchomieniowe traktuje dowolny zestaw, który nie ma atrybutu kultury ustawionego na wartość null jako zestaw satelicki. Takie zestawy podlegają regułom powiązania zestawu satelickiego. Aby uzyskać więcej informacji, zobacz jak środowisko uruchomieniowe lokalizuje zestawy.
AssemblyFlagsAttribute Wartość, która ustawia atrybuty zestawu, na przykład czy zestaw może być uruchamiany obok siebie.
AssemblyVersionAttribute Wartość liczbowa w formacie głównym . pomocnicze . kompilacja . poprawka (na przykład 2.4.0.0). Środowisko uruchomieniowe języka wspólnego używa tej wartości do wykonywania operacji powiązań w zestawach o silnej nazwie. Uwaga: Jeśli AssemblyInformationalVersionAttribute atrybut nie jest stosowany do zestawu, numer wersji określony przez AssemblyVersionAttribute atrybut jest używany przez Application.ProductVersion , Application.UserAppDataPath i Application.UserAppDataRegistry właściwości.

Poniższy przykład kodu pokazuje, jak zastosować wersję i atrybuty kultury do zestawu.

// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")];
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")];
// Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")]
// Set culture as German.
[assembly:AssemblyCultureAttribute("de")]
' Set version number for the assembly.
<Assembly:AssemblyVersionAttribute("4.3.2.1")>
' Set culture as German.
<Assembly:AssemblyCultureAttribute("de")>

Atrybuty informacyjne

Można użyć atrybutów informacyjnych w celu podania dodatkowych informacji o firmie lub produkcie dla zestawu. W poniższej tabeli opisano atrybuty informacyjne, które można zastosować do zestawu.

Atrybut informacyjny Opis
AssemblyCompanyAttribute Wartość ciągu określająca nazwę firmy.
AssemblyCopyrightAttribute Wartość ciągu określająca informacje o prawach autorskich.
AssemblyFileVersionAttribute Wartość ciągu określająca numer wersji pliku Win32. Zwykle jest to domyślna wersja zestawu.
AssemblyInformationalVersionAttribute Wartość ciągu określająca informacje o wersji, które nie są używane przez środowisko uruchomieniowe języka wspólnego, takie jak pełny numer wersji produktu. Uwaga: Jeśli ten atrybut jest stosowany do zestawu, ciąg, który określa, można uzyskać w czasie wykonywania przy użyciu Application.ProductVersion właściwości. Ten ciąg jest również używany w ścieżce i klucz rejestru dostarczonych przez Application.UserAppDataPath i Application.UserAppDataRegistry właściwości.
AssemblyProductAttribute Wartość ciągu określająca informacje o produkcie.
AssemblyTrademarkAttribute Wartość ciągu określająca informacje o znakach towarowych.

Te atrybuty mogą być wyświetlane na stronie właściwości systemu Windows zestawu lub można je zastąpić przy użyciu opcji kompilatora /win32res , aby określić własny plik zasobów Win32.

Atrybuty manifestu zestawu

Można użyć atrybutów manifestu zestawu, aby podać informacje w manifeście zestawu, w tym tytuł, opis, alias domyślny i konfigurację. W poniższej tabeli opisano atrybuty manifestu zestawu.

Atrybut manifestu zestawu Opis
AssemblyConfigurationAttribute Wartość ciągu określająca konfigurację zestawu, na przykład detaliczną lub debug. Środowisko uruchomieniowe nie używa tej wartości.
AssemblyDefaultAliasAttribute Wartość ciągu określająca domyślny alias, który będzie używany przez odwołania do zestawów. Ta wartość zapewnia przyjazną nazwę, gdy nazwa samego zestawu nie jest przyjazna (na przykład wartość identyfikatora GUID). Ta wartość może być również używana jako krótka forma pełnej nazwy zestawu.
AssemblyDescriptionAttribute Wartość ciągu określająca Krótki opis, który podsumowuje charakter i cel zestawu.
AssemblyTitleAttribute Wartość ciągu określająca przyjazną nazwę zestawu. Na przykład zestaw o nazwie comdlg może mieć tytuł Microsoft Common Dialogs Control.

Atrybuty silnej nazwy

Aby ustawić silną nazwę zestawu, można użyć atrybutów silnej nazwy. W poniższej tabeli opisano atrybuty silnej nazwy.

Atrybut silnej nazwy Opis
AssemblyDelaySignAttribute Wartość logiczna wskazująca, że jest używane podpisywanie opóźnienia.
AssemblyKeyFileAttribute Wartość ciągu wskazująca nazwę pliku, który zawiera klucz publiczny (w przypadku korzystania z opóźnienia podpisywania) lub klucze publiczny i prywatny przekazanie jako parametr do konstruktora tego atrybutu. Należy pamiętać, że nazwa pliku jest względna w stosunku do ścieżki pliku wyjściowego ( . exe lub . dll ), a nie ścieżki pliku źródłowego.
AssemblyKeyNameAttribute Wskazuje kontener kluczy, który zawiera parę kluczy przekazaną jako parametr do konstruktora tego atrybutu.

Poniższy przykład kodu pokazuje atrybuty do zastosowania podczas korzystania z opóźnienia podpisywania w celu utworzenia zestawu o silnej nazwie z plikiem klucza publicznego o nazwie klucze. snk .

[assembly:AssemblyKeyFileAttribute("myKey.snk")];
[assembly:AssemblyDelaySignAttribute(true)];
[assembly:AssemblyKeyFileAttribute("myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]
<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>

Zobacz także