CSharpUtilities — CMake 3.24.2 Documentation

# CSharpUtilities

New in version 3.8.

Functions to make configuration of CSharp/.NET targets easier.

A collection of CMake utility functions useful for dealing with CSharp targets for Visual Studio generators from version 2010 and later.

The following functions are provided by this module:

Main functions

- `csharp_set_windows_forms_properties()`

- `csharp_set_designer_cs_properties()`

- `csharp_set_xaml_cs_properties()`

Helper functions

- `csharp_get_filename_keys()`

- `csharp_get_filename_key_base()`

- `csharp_get_dependentupon_name()`

## Main functions provided by the module

csharp_set_windows_forms_properties

  Sets source file properties for use of Windows Forms. Use this, if your CSharp target uses Windows Forms:

      csharp_set_windows_forms_properties([<file1> [<file2> [...]]])

  `<fileN>`

    List of all source files which are relevant for setting the `VS_CSHARP_<tagname>` properties (including `.cs`, `.resx` and `.Designer.cs` extensions).

  In the list of all given files for all files ending with `.Designer.cs` and `.resx` is searched. For every designer or resource file a file with the same base name but only `.cs` as extension is searched. If this is found, the `VS_CSHARP_<tagname>` properties are set as follows:

  for the .cs file:

    - VS_CSHARP_SubType "Form"

  for the .Designer.cs file (if it exists):

    - VS_CSHARP_DependentUpon <cs-filename>

    - VS_CSHARP_DesignTime "" (delete tag if previously defined)

    - VS_CSHARP_AutoGen ""(delete tag if previously defined)

  for the .resx file (if it exists):

    - VS_RESOURCE_GENERATOR "" (delete tag if previously defined)

    - VS_CSHARP_DependentUpon <cs-filename>

    - VS_CSHARP_SubType "Designer"

csharp_set_designer_cs_properties

  Sets source file properties of `.Designer.cs` files depending on sibling filenames. Use this, if your CSharp target does not use Windows Forms (for Windows Forms use `csharp_set_designer_cs_properties()` instead):

      csharp_set_designer_cs_properties([<file1> [<file2> [...]]])

  `<fileN>`

    List of all source files which are relevant for setting the `VS_CSHARP_<tagname>` properties (including `.cs`, `.resx`, `.settings` and `.Designer.cs` extensions).

  In the list of all given files for all files ending with `.Designer.cs` is searched. For every designer file all files with the same base name but different extensions are searched. If a match is found, the source file properties of the designer file are set depending on the extension of the matched file:

  if match is .resx file:

    - VS_CSHARP_AutoGen "True"

    - VS_CSHARP_DesignTime "True"

    - VS_CSHARP_DependentUpon <resx-filename>

  if match is .cs file:

    - VS_CSHARP_DependentUpon <cs-filename>

  if match is .settings file:

    - VS_CSHARP_AutoGen "True"

    - VS_CSHARP_DesignTimeSharedInput "True"

    - VS_CSHARP_DependentUpon <settings-filename>

Note

Because the source file properties of the `.Designer.cs` file are set according to the found matches and every match sets the VS_CSHARP_DependentUpon property, there should only be one match for each `Designer.cs` file.

csharp_set_xaml_cs_properties

  Sets source file properties for use of Windows Presentation Foundation (WPF) and XAML. Use this, if your CSharp target uses WPF/XAML:

      csharp_set_xaml_cs_properties([<file1> [<file2> [...]]])

  `<fileN>`

    List of all source files which are relevant for setting the `VS_CSHARP_<tagname>` properties (including `.cs`, `.xaml`, and `.xaml.cs` extensions).

  In the list of all given files for all files ending with `.xaml.cs` is searched. For every xaml-cs file, a file with the same base name but extension `.xaml` is searched. If a match is found, the source file properties of the `.xaml.cs` file are set:

  > - VS_CSHARP_DependentUpon <xaml-filename>

## Helper functions which are used by the above ones

csharp_get_filename_keys

  Helper function which computes a list of key values to identify source files independently of relative/absolute paths given in cmake and eliminates case sensitivity:

      csharp_get_filename_keys(OUT [<file1> [<file2> [...]]])

  `OUT`

    Name of the variable in which the list of keys is stored

  `<fileN>`

    filename(s) as given to to CSharp target using `add_library()` or `add_executable()`

  In some way the function applies a canonicalization to the source names. This is necessary to find file matches if the files have been added to the target with different directory prefixes:

      add_library(lib
        myfile.cs
        ${CMAKE_CURRENT_SOURCE_DIR}/myfile.Designer.cs)

      set_source_files_properties(myfile.Designer.cs PROPERTIES
        VS_CSHARP_DependentUpon myfile.cs)

      # this will fail, because in cmake
      #  - ${CMAKE_CURRENT_SOURCE_DIR}/myfile.Designer.cs
      #  - myfile.Designer.cs
      # are not the same source file. The source file property is not set.

csharp_get_filename_key_base

  Returns the full filepath and name without extension of a key. KEY is expected to be a key from csharp_get_filename_keys. In BASE the value of KEY without the file extension is returned:

      csharp_get_filename_key_base(BASE KEY)

  `BASE`

    Name of the variable with the computed "base" of `KEY`.

  `KEY`

    The key of which the base will be computed. Expected to be a upper case full filename.

csharp_get_dependentupon_name

  Computes a string which can be used as value for the source file property `VS_CSHARP_<tagname>` with target being `DependentUpon`:

      csharp_get_dependentupon_name(NAME FILE)

  `NAME`

    Name of the variable with the result value

  `FILE`

    Filename to convert to `<DependentUpon>` value

  Actually this is only the filename without any path given at the moment.