You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: wpf/Visual-Studio-Integration/Template-Studio.md
+49-37Lines changed: 49 additions & 37 deletions
Original file line number
Diff line number
Diff line change
@@ -50,74 +50,86 @@ Create the Syncfusion WPF project using the Visual Studio Project Template by fo
50
50
51
51
5. Click **Next** or navigate to the **Type** tab, then select the desired Syncfusion WPF application type. When selecting the type of template for your application, you have two options:
52
52
53
-
53
+
54
54
55
55
**Predefined template:** Choose this option to select from 5 predefined templates, including Calendar, Contact, Outlook, Docking Manager, Spreadsheet, Tile view, and Word. By choosing one of these templates, you can create your application without needing to follow any further steps.
To unselect the added control(s), Click ‘x’ for the corresponding control in the control list from the Project Details.
66
-
67
-
N> The Control Features option is not accessible for Blank Pages.
68
-
69
-
2. Click **Next** or navigate to the **Control Features** tab to view the listed features for the selected controls. From here, choose the features needed.
65
+
To unselect the added control(s), Click ‘x’ for the corresponding control in the control list from the Project Details.
72
66
73
-
3. Click **Next** or navigate the **App Features** tab to select the desired application features.
67
+
N> The Control Features option is not accessible for Blank, Settings, and Master Detail Pages.
74
68
75
-
69
+
7. Click **Next** or navigate to the **Control Features** tab to view the listed features for the selected controls. From here, choose the features needed.
76
70
77
-
N> The App Features option is not accessible for .NET Framework.
71
+
78
72
79
-
**Project Details Section**
73
+
8. Click **Next** or navigate the **App Features** tab to select the desired application features.
80
74
81
-
In the **Project Details** section, modify configurations and project types. Additionally, you can remove one or more controls from the selected list and remove the chosen application feature.
75
+
82
76
83
-
77
+
**Project Details Section**
84
78
85
-
4. Click **Next** or navigate to the **Pages** tab to access a list of available Syncfusion WPF components you can add to the application.
79
+
In the **Project Details**section, you can modify configurations and project types. Additionally, you can remove one or more controls from the selected list and remove the chosen application feature.
88
82
89
-
To unselect the added control(s), Click ‘x’ for the corresponding control in the control list from the Project Details.
83
+
9. Click **Create** to generate the Syncfusion WPF application. Once you've created the project, the relevant Syncfusion NuGet packages will be automatically added to your project for the chosen components. For example, if you add an **DataGrid** control, the corresponding Syncfusion NuGet packages required for that control will be installed.
90
84
91
-
N> The Control Features option is not accessible for Blank, Settings, and Master Detail Pages.
85
+
92
86
93
-
5. Click **Next** or navigate to the **Control Features** tab to view the listed features for the selected controls. From here, choose the features needed.
89
+
To find out which NuGet packages are needed for other WPF controls, please refer to this [documentation link](https://help.syncfusion.com/wpf/control-dependencies) for detailed information on the required NuGet packages for each control.
96
90
97
-
6. Click **Next** or navigate the **App Features** tab to select the desired application features.
91
+
10. When you create a WPF project, the following Dependency Injection (DI) setup is added to the **App.xaml.cs** file. This setup registers services, view models, and views with the DI container, ensuring proper functionality for the selected components and service management within your application. Below, the **ConfigureServices** method in **App.xaml.cs** sets up Dependency Injection (DI) in a WPF project to manage the application's services, view models, and views. Here's a simple breakdown:
92
+
98
93
99
-
94
+
*I. Application Host:*
95
+
- Registers **ApplicationHostService** to manage the app's lifecycle.
100
96
101
-
**Project Details Section**
97
+
*II. Specific Services:*
98
+
- Registers **PageService** and **NavigationService** for handling page navigation.
102
99
103
-
In the **Project Details** section, you can modify configurations and project types. Additionally, you can remove one or more controls from the selected list and remove the chosen application feature.
100
+
*III. Views and ViewModels:*
101
+
- Registers ShellWindow and ShellViewModel for the main application window.
102
+
- Registers **DataGridViewModel** and **DataGridPage** for the added component DataGrid UI.
103
+
- Registers MainViewModel and MainPage for the main page of the app.
104
104
105
-
105
+
*IV. Configuration:*
106
+
- Binds the app's configuration settings to the **AppConfig** class using the settings from the configuration file.
106
107
107
-
7. Click **Create** to initiate the process. This action generates the Syncfusion WPF application. The resulting Syncfusion WPF app has the necessary Syncfusion NuGet packages, styles, and rendering code specific to the chosen Syncfusion component.
110
+
11. In a WPF MVVM application, the **PageService.cs** class helps manage navigation and page creation. For instance, it facilitates registering and navigating to pages associated with specific view models. Here's a simple explanation:
110
111
111
-
8. The Syncfusion WPF application is configured with the latest versions of Syncfusion WPF NuGet packages, complete with the appropriate namespaces and component render code for seamless integration of Syncfusion components.
112
+
*I. Initialization:*
113
+
- The constructor of PageService takes a serviceProvider to access registered services.
112
114
113
-
N> The .Net 6.0, .Net 7.0, and .Net 8.0 option will be listed in Select a framework version when only the .Net 6.0, .Net 7.0, and .Net 8.0 SDK setup has been installed.
115
+
*II. Registering Pages:*
116
+
-**Configure `<DataGridPage>()`:** Registers DataGridPage with the service provider.
117
+
-**Configure `<MainPage>()`:** Registers MainPage with the service provider.
> .NET 6.0 version is available from v19.4.0.38 and it support from Visual Studio 2022.
121
+
12. Some components require additional resource files, such as images and other necessary files, to function correctly. For example, if you add the **PDFViewer**and **Carousel** component to your WPF project, the respective images and PDF files will be added to the Images and Assets folder in your project.
116
122
117
-
> .NET 7.0 version is available from v20.4.0.38 and it support from Visual Studio 2022.
> .NET 8.0 version is available from v23.2.4 and it support from Visual Studio 2022.
125
+
126
+
> The .NET 6.0, .NET 7.0, and .NET 8.0 options will be available in the Select a framework version dropdown only if the respective .NET SDKs are installed on your system. The table below outlines the .NET versions, the specific product versions from which they are available, and the Visual Studio versions that support them:
127
+
> | .NET Version | Available From Version | Supported from Visual Studio |
9. Then, Syncfusion licensing registration required message box will be shown if you installed the trial setup or NuGet packages since Syncfusion introduced the licensing system from 2018 Volume 2 (v16.2.0.41) Essential Studio release. Navigate to the [help topic](https://help.syncfusion.com/common/essential-studio/licensing/overview#how-to-generate-syncfusion-license-key), which is shown in the licensing message box to generate and register the Syncfusion license key to your project. Refer to this [blog](https://www.syncfusion.com/blogs/post/whats-new-in-2018-volume-2.aspx) post for understanding the licensing changes introduced in Essential Studio.
133
+
13. Then, Syncfusion licensing registration required message box will be shown if you installed the trial setup or NuGet packages since Syncfusion introduced the licensing system from 2018 Volume 2 (v16.2.0.41) Essential Studio release. Navigate to the [help topic](https://help.syncfusion.com/common/essential-studio/licensing/overview#how-to-generate-syncfusion-license-key), which is shown in the licensing message box to generate and register the Syncfusion license key to your project. Refer to this [blog](https://www.syncfusion.com/blogs/post/whats-new-in-2018-volume-2.aspx) post for understanding the licensing changes introduced in Essential Studio.
122
134
123
-
135
+
0 commit comments