summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorFlorian Schweiger <husker@dzdm.de>2022-04-08 11:01:57 (GMT)
committerFlorian Schweiger <husker@dzdm.de>2022-04-12 13:35:17 (GMT)
commitd89af11f89fe1a76e3c48e3320a541c58b794c72 (patch)
tree30f41de30f97d4ca3c3a5bbb51bf5fe8a54e1e63 /Help
parent359d7c19e522465b7ceadcfc69a25ffc799d344f (diff)
downloadCMake-d89af11f89fe1a76e3c48e3320a541c58b794c72.zip
CMake-d89af11f89fe1a76e3c48e3320a541c58b794c72.tar.gz
CMake-d89af11f89fe1a76e3c48e3320a541c58b794c72.tar.bz2
VS: Add StartupObject property for managed .NET projects
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/cmake-properties.7.rst1
-rw-r--r--Help/prop_tgt/VS_DOTNET_STARTUP_OBJECT.rst21
-rw-r--r--Help/release/dev/vs_dotnet_startup_object_support.rst8
3 files changed, 30 insertions, 0 deletions
diff --git a/Help/manual/cmake-properties.7.rst b/Help/manual/cmake-properties.7.rst
index fbddd8b..8c2f8c4 100644
--- a/Help/manual/cmake-properties.7.rst
+++ b/Help/manual/cmake-properties.7.rst
@@ -394,6 +394,7 @@ Properties on Targets
/prop_tgt/VS_DOTNET_REFERENCEPROP_refname_TAG_tagname
/prop_tgt/VS_DOTNET_REFERENCES
/prop_tgt/VS_DOTNET_REFERENCES_COPY_LOCAL
+ /prop_tgt/VS_DOTNET_STARTUP_OBJECT
/prop_tgt/VS_DOTNET_TARGET_FRAMEWORK_VERSION
/prop_tgt/VS_DPI_AWARE
/prop_tgt/VS_GLOBAL_KEYWORD
diff --git a/Help/prop_tgt/VS_DOTNET_STARTUP_OBJECT.rst b/Help/prop_tgt/VS_DOTNET_STARTUP_OBJECT.rst
new file mode 100644
index 0000000..5212293
--- /dev/null
+++ b/Help/prop_tgt/VS_DOTNET_STARTUP_OBJECT.rst
@@ -0,0 +1,21 @@
+VS_DOTNET_STARTUP_OBJECT
+------------------------
+
+.. versionadded:: 3.24
+
+Sets the startup object property in Visual Studio .NET targets.
+The property value defines a full qualified class name (including package
+name), for example: ``MyCompany.Package.MyStarterClass``.
+
+If the property is unset, Visual Studio uses the first matching
+``static void Main(string[])`` function signature by default. When more
+than one ``Main()`` method is available in the current project, the property
+becomes mandatory for building the project.
+
+This property only works for Visual Studio 2010 and above;
+it is ignored on other generators.
+
+.. code-block:: cmake
+
+ set_property(TARGET ${TARGET_NAME} PROPERTY
+ VS_DOTNET_STARTUP_OBJECT "MyCompany.Package.MyStarterClass")
diff --git a/Help/release/dev/vs_dotnet_startup_object_support.rst b/Help/release/dev/vs_dotnet_startup_object_support.rst
new file mode 100644
index 0000000..1f0672f
--- /dev/null
+++ b/Help/release/dev/vs_dotnet_startup_object_support.rst
@@ -0,0 +1,8 @@
+vs_dotnet_startup_object_support
+--------------------------------
+
+* The :prop_tgt:`VS_DOTNET_STARTUP_OBJECT` target property was added to
+ tell :ref:`Visual Studio Generators` which startup class shall be used
+ when the program or project is executed. This is necessary when more
+ than one ``static void Main(string[])`` function signature is available
+ in a managed .NET project.