CSharpUtilities

From Get docs
Cmake/docs/3.21/module/csharputilities


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

Helper functions

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_ 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_ properties are set as follows:

for the .cs file:
  • VS_CSHARP_SubType "Form"
for the .Designer.cs file (if it exists):
  • VS_CSHARP_DependentUpon
  • 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
  • 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_ 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
if match is .cs file:
  • VS_CSHARP_DependentUpon
if match is .settings file:
  • VS_CSHARP_AutoGen "True"
  • VS_CSHARP_DesignTimeSharedInput "True"
  • VS_CSHARP_DependentUpon

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_ 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

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_ 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.

© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.21/module/CSharpUtilities.html