Skip to content

Repo sync for protected CLA branch #8542

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 34 commits into from
Oct 10, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
4d683f7
get rid of mindaro in bridge docs
qpetraroia Sep 21, 2022
749c1cc
Add MSBuildFrameworkToolsPath
ghogen Oct 4, 2022
c6b9884
separate table by moniker, add properties, add C++ section
ghogen Oct 5, 2022
53b46ad
overriding caution
ghogen Oct 5, 2022
0ac33a7
add Windows 8 SDK path description
ghogen Oct 5, 2022
feb85cd
alphabetical order
ghogen Oct 7, 2022
82c319b
fix redirected links
ghogen Oct 7, 2022
6169496
Merge pull request #10481 from ghogen/broken-links-oct22
prmerger-automator[bot] Oct 7, 2022
0c6c06c
Merge pull request #10478 from ghogen/issue-8510
JamesJBarnett Oct 7, 2022
a184cf1
Merge pull request #10436 from qpetraroia/patch-1
prmerger-automator[bot] Oct 7, 2022
42b2fd5
update for VS 2022
ghogen Oct 7, 2022
3e7c9ef
update for VS 2022
ghogen Oct 7, 2022
a517404
Merge pull request #10484 from ghogen/connection-strings-oct22
prmerger-automator[bot] Oct 7, 2022
13bb377
Update docs/data-tools/create-and-configure-datasets-in-visual-studio.md
19BMG00 Oct 7, 2022
8d0e5f1
Merge pull request #10482 from ghogen/data-tools-fresh-oct22
19BMG00 Oct 7, 2022
367c3ff
update MSBuild top-level article
ghogen Oct 8, 2022
05767fd
use code fence for .props and .targets
ghogen Oct 8, 2022
7ab6718
update date
ghogen Oct 8, 2022
acaacfe
update some text and ms.date
ghogen Oct 8, 2022
886d5b2
update date
ghogen Oct 8, 2022
41f964e
update ms.date
ghogen Oct 8, 2022
3d8b3c5
update ms.date
ghogen Oct 8, 2022
83cb0eb
update date
ghogen Oct 8, 2022
49acef8
Merge pull request #10485 from ghogen/refresh-dates
prmerger-automator[bot] Oct 8, 2022
78c0e79
update ms.date
ghogen Oct 8, 2022
1d3c14a
Merge pull request #10486 from ghogen/refresh-dates-compile-build
prmerger-automator[bot] Oct 8, 2022
8e187ab
update date
ghogen Oct 8, 2022
efb4e13
Merge pull request #10487 from ghogen/fresh-run-program
prmerger-automator[bot] Oct 8, 2022
ab7cc9c
update date
ghogen Oct 8, 2022
d651bba
Merge pull request #10488 from ghogen/update-container-tools-dates
prmerger-automator[bot] Oct 8, 2022
73881b1
update date
ghogen Oct 8, 2022
8549dab
update date
ghogen Oct 8, 2022
0fbbbb0
Merge pull request #10489 from ghogen/update-date-access
prmerger-automator[bot] Oct 8, 2022
5bff8c1
Merging changes synced from https://github.com/MicrosoftDocs/visualst…
opbld16 Oct 8, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion bridge/articles/bridge-to-kubernetes-sample.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ minikube start --vm-driver hyperv --hyperv-virtual-switch "Primary Virtual Switc

## Deploy the application

Clone the [mindaro repo](https://github.com/Microsoft/mindaro) and open a command window with the current working folder to *samples/todo-app*.
Clone the [Bridge to Kubernetes repo](https://github.com/Azure/Bridge-To-Kubernetes) and open a command window with the current working folder to *samples/todo-app*.

Create a namespace for the sample.

Expand Down
2 changes: 1 addition & 1 deletion docs/containers/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: Get to know the tools available in Visual Studio for working with D
author: ghogen
ms.author: ghogen
ms.topic: overview
ms.date: 10/27/2021
ms.date: 10/07/2022
ms.technology: vs-container-tools
---
# Visual Studio Container Tools for Docker
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Connect to data in an Access database
description: Understand how to connect to data in an Access database (either an .mdb file or an .accdb.file) in Visual Studio.
ms.custom: SEO-VS-2020
ms.date: 11/02/2021
ms.date: 10/07/2022
ms.topic: how-to
helpviewer_keywords:
- data [Visual Studio], connecting
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Create a simple data application by using ADO.NET
description: Learn to create a simple forms-to-data application by using Windows Forms and ADO.NET in Visual Studio.
ms.custom: SEO-VS-2020
ms.date: 12/03/2021
ms.date: 10/07/2022
ms.topic: conceptual
dev_langs:
- VB
Expand Down
56 changes: 32 additions & 24 deletions docs/data-tools/create-and-configure-datasets-in-visual-studio.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Create and configure datasets
description: Create and configure datasets in Visual Studio. A dataset is a set of objects that store data from a DB in memory and supports CRUD operations on that data.
ms.custom: SEO-VS-2020
ms.date: 11/21/2018
ms.date: 10/07/2022
ms.topic: how-to
helpviewer_keywords:
- typed datasets, creating
Expand All @@ -27,39 +27,47 @@ You can create a typed <xref:System.Data.DataSet> class in Visual Studio at desi

1. Open your project in Visual Studio, and then choose **Project** > **Add New Data Source** to start the **Data Source Configuration Wizard**.

2. Choose the type of data source to which you'll be connecting.
1. Choose the type of data source to which you'll be connecting.

![Data Source Configuration Wizard](../data-tools/media/data-source-configuration-wizard.png)
![Screenshot showing Data Source Configuration Wizard.](../data-tools/media/vs-2022/data-source-configuration-wizard.png)

3. Choose the database or databases that will be the data source for your dataset.
1. Choose `DataSet` from the list of options.

![Data source choose a connection](../data-tools/media/data-source-choose-a-connection.png)
![Screenshot showing choosing DataSet as the database model.](./media/vs-2022/data-source-configuration-wizard-2.png)

4. Choose the tables (or individual columns), stored procedures, functions, and views from the database that you want to be represented in the dataset.
1. Choose the database or databases that will be the data source for your dataset.

![Choose database objects](../data-tools/media/raddata-chose-objects.png)
![Screenshot showing how to choose a connection.](../data-tools/media/data-source-choose-a-connection.png)

5. Click **Finish**.
1. Choose whether to save the connection string in *app.config*.

![Screenshot showing option to save connection string to the application configuration file.](./media/vs-2022/save-connection-string-to-app-config.png)

1. Choose the tables (or individual columns), stored procedures, functions, and views from the database that you want to be represented in the dataset.

![Screenshot showing how to choose your database objects.](../data-tools/media/vs-2022/choose-your-database-objects.png)

1. Click **Finish**.

The dataset appears as a node in **Solution Explorer**.

![DataSet in Solution Explorer](../data-tools/media/dataset-in-solution-explorer.png)
![Screenshot showing DataSet in Solution Explorer.](../data-tools/media/vs-2022/dataset-in-solution-explorer.png)

6. Click the dataset node in **Solution Explorer** to open the dataset in the **DataSet Designer**. Each table in the dataset has an associated `TableAdapter` object, which is represented at the bottom. The table adapter is used to populate the dataset and optionally to send commands to the database.
1. Click the dataset node in **Solution Explorer** to open the dataset in the **DataSet Designer**. Each table in the dataset has an associated `TableAdapter` object, which is represented at the bottom. The table adapter is used to populate the dataset and optionally to send commands to the database.

![DataSet Designer](../data-tools/media/dataset-designer.png)
![Screenshot showing data tables in DataSet Designer.](../data-tools/media/vs-2022/dataset-in-dataset-designer.png)

7. The relation lines that connect the tables represent table relationships, as defined in the database. By default, foreign-key constraints in a database are represented as a relation only, with the update and delete rules set to none. Typically, that is what you want. However, you can click the lines to bring up the **Relation** dialog, where you can change the behavior of hierarchical updates. For more information, see [Relationships in datasets](../data-tools/relationships-in-datasets.md) and [Hierarchical update](../data-tools/hierarchical-update.md).
1. The relation lines that connect the tables represent table relationships, as defined in the database. By default, foreign-key constraints in a database are represented as a relation only, with the update and delete rules set to none. Typically, that is what you want. However, you can click the lines to bring up the **Relation** dialog, where you can change the behavior of hierarchical updates. For more information, see [Relationships in datasets](../data-tools/relationships-in-datasets.md) and [Hierarchical update](../data-tools/hierarchical-update.md).

![Dataset Relation dialog](../data-tools/media/raddata-relation-dialog.png)
![Dataset Relation dialog](../data-tools/media/vs-2022/dataset-relation-dialog.png)

8. Click a table, table adapter, or column name in a table to see its properties in the **Properties** window. You can modify some of the values here. Just remember that you are modifying the dataset, not the source database.
1. Click a table, table adapter, or column name in a table to see its properties in the **Properties** window. You can modify some of the values here. Just remember that you are modifying the dataset, not the source database.

![DataSet column properties](../data-tools/media/dataset-column-properties.png)
![Screenshot showing DataSet column properties.](../data-tools/media/vs-2022/data-column-properties.png)

9. You can add new tables or table adapters to the dataset, or add new queries for existing table adapters, or specify new relations between tables by dragging those items from the **Toolbox** tab. This tab appears when the **DataSet Designer** is in focus.
1. You can add new tables or table adapters to the dataset, or add new queries for existing table adapters, or specify new relations between tables by dragging those items from the **Toolbox** tab. This tab appears when the **DataSet Designer** is in focus.

![Dataset Toolbox](../data-tools/media/raddata-dataset-toolbox.png)
![Screenshot showing Dataset Toolbox.](../data-tools/media/vs-2022/dataset-designer-toolbox.png)

Next, you might want to specify how to populate the dataset with data. For that, you use the **TableAdapter Configuration Wizard**. For more information, see [Fill datasets by using TableAdapters](../data-tools/fill-datasets-by-using-tableadapters.md).

Expand All @@ -69,23 +77,23 @@ This procedure shows how to add a table from the same database that you used to

1. Click the dataset node in **Solution Explorer** to bring the **DataSet Designer** into focus.

2. Click the **Data Sources** tab in the left margin of Visual Studio, or type **data sources** in the search box.
1. Click the **Data Sources** tab in the left margin of Visual Studio, or type **data sources** in the search box.

3. Right-click the dataset node and select **Configure Data Source with Wizard**.
1. Right-click the dataset node and select **Configure Data Source with Wizard**.

![Data Source context menu](../data-tools/media/data-source-context-menu.png)
![Screenshot showing Data Source context menu.](../data-tools/media/vs-2022/configure-data-source-with-wizard-context-menu.png)

4. Use the wizard to specify which additional tables, stored procedures, or other database objects to add to the dataset.
1. Use the wizard to specify which additional tables, stored procedures, or other database objects to add to the dataset.

## Add a stand-alone data table to a dataset

1. Open your dataset in the **Dataset Designer**.

2. Drag a <xref:System.Data.DataTable> class from the **DataSet** tab of the **Toolbox** onto the **Dataset Designer**.
1. Drag a <xref:System.Data.DataTable> class from the **DataSet** tab of the **Toolbox** onto the **Dataset Designer**.

3. Add columns to define your data table. Right-click on the table and choose **Add** > **Column**. Use the **Properties** window to set the data type of the column and a key if necessary.
1. Add columns to define your data table. Right-click on the table and choose **Add** > **Column**. Use the **Properties** window to set the data type of the column and a key if necessary.

Stand-alone tables need to Implement `Fill` logic in stand-alone tables so that you can fill them with data. For information on filling stand-alone data tables, see [Populating a DataSet from a DataAdapter](/dotnet/framework/data/adonet/populating-a-dataset-from-a-dataadapter).
Stand-alone tables need to implement `Fill` logic so that you can fill them with data. For information on filling data tables, see [Populating a DataSet from a DataAdapter](/dotnet/framework/data/adonet/populating-a-dataset-from-a-dataadapter).

## See also

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Add, update, or remove a WCF data service reference
description: Review how to add, update, or remove a Windows Communication Foundation (WCF) data service reference.
ms.date: 11/22/2021
ms.date: 10/07/2022
ms.custom: SEO-VS-2020
ms.topic: how-to
helpviewer_keywords:
Expand Down
13 changes: 10 additions & 3 deletions docs/data-tools/how-to-save-and-edit-connection-strings.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: 'How to: Save and Edit Connection Strings'
description: Know how to save and edit connection strings in Visual Studio applications. Save or edit a connection string directly in application settings.
ms.custom: SEO-VS-2020
ms.date: 11/04/2016
ms.date: 10/07/2022
ms.topic: how-to
ms.assetid: f8ef3a2c-029c-423b-9d9e-a4f1add4f640
author: ghogen
Expand All @@ -15,11 +15,18 @@ ms.workload:
# How to: Save and edit connection strings

[!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
Connection strings in Visual Studio applications are saved in the application configuration file (also referred to as application settings), or hard-coded directly in your application. Saving connection strings in the application configuration file simplifies the task of maintaining your application. If the connection string needs to be changed, you can update it in the application settings file (as opposed to having to change it in the source code and recompile the application).

Storing sensitive information (such as the password) within the connection string can affect the security of your application. Connection strings saved to the application configuration file are not encrypted or obfuscated, so it may be possible for someone to access the file and view its contents. Using Windows integrated security is a more secure way to control access to a database.
> [!NOTE]
> This article provides guidance for handling connection strings in Windows applications; for cloud and web applications, more secure techniques are available. You can use [Connected Services](../azure/overview-connected-services.md) to add support for Secrets.json for local development, and then migrate to Azure Key Vault for secrets storage when you deploy to Azure. See [Protect secrets during development.](/aspnet/core/security/app-secrets?tabs=windows).

Properly handling the connection string in a Visual Studio application requires care to avoid presenting security risks. Connection strings in Visual Studio applications are often saved in the application configuration file (also referred to as application settings), or hard-coded directly in your application. Hard-coding directly into the application is not recommended, because the sensitive information in the connection string, such as the database credentials, can be read directly from the unencrypted binaries. Saving connection strings in the application configuration file simplifies the task of maintaining your application. If the connection string needs to be changed, you can update it in the application settings file (as opposed to having to change it in the source code and recompile the application).

Storing sensitive information (such as the password) within the connection string can affect the security of your application. Connection strings saved to the application configuration file are not encrypted or obfuscated, so it may be possible for someone to access the file and view its contents.

For databases that support it, using Windows integrated security is a more secure way to control access to a database.

If you do not choose to use Windows integrated security and your database requires a user name and password, you can omit them from the connection string, but your application will need to provide this information to successfully connect to the database. For example, you can create a dialog box that prompts the user for this information and dynamically builds the connection string at run time. Security can still be an issue if the information is intercepted on the way to the database.

For more information, see [Protecting connection information](/dotnet/framework/data/adonet/protecting-connection-information).

## To save a connection string from within the Data Source Configuration Wizard
Expand Down
Binary file modified docs/data-tools/media/vs-2022/choose-your-database-objects.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/get-started/csharp/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ metadata:
description: Create C# apps by using Visual Studio.
ms.custom: vs-acquisition
ms.topic: landing-page
ms.date: 10/25/2021
ms.date: 10/07/2022
author: ghogen
ms.author: ghogen
manager: jmartens
Expand Down
2 changes: 1 addition & 1 deletion docs/get-started/csharp/run-program.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "How to run a program (C#)"
description: "Beginner's guide on how to run a C# program in Visual Studio."
ms.custom: "vs-acquisition, get-started"
ms.date: 09/14/2021
ms.date: 10/07/2022
ms.technology: vs-ide-general
ms.prod: visual-studio-windows
ms.topic: tutorial
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Building and Cleaning Projects and Solutions
description: Learn how you can build, rebuild, or clean all or some of the projects or project items in a solution.
ms.custom: SEO-VS-2020
ms.date: 09/14/2021
ms.date: 10/07/2022
ms.technology: vs-ide-compile
ms.topic: conceptual
f1_keywords:
Expand Down
4 changes: 2 additions & 2 deletions docs/ide/compiling-and-building-in-visual-studio.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Compiling building
description: Learn how you use the Visual Studio IDE build method, the MSBuild command-line tools build method, or Azure Pipelines build method to build an application.
ms.custom: SEO-VS-2020
ms.date: 09/14/2021
ms.date: 10/07/2022
ms.technology: vs-ide-compile
ms.topic: conceptual
helpviewer_keywords:
Expand All @@ -26,7 +26,7 @@ You can use any of the following methods to build an application: the Visual Stu
| Build Method | Benefits |
| --- |--- | --- |
| IDE |- Create builds immediately and test them in a debugger.<br />- Run multi-processor builds for C++ and C# projects.<br />- Customize different aspects of the build system. |
| CMake | - Build projects using the CMake tool<br />- Use the same build system across Linux and Windows platforms. |
| CMake | - Build C++ projects using the CMake tool<br />- Use the same build system across Linux and Windows platforms. |
| MSBuild command line| - Build projects without installing Visual Studio.<br />- Run multi-processor builds for all project types.<br />- Customize most areas of the build system.|
| Azure Pipelines | - Automate your build process as part of a continuous integration/continuous delivery pipeline.<br />- Apply automated tests with every build.<br />- Employ virtually unlimited cloud-based resources for build processes.<br />- Modify the build workflow and create build activities to perform deeply customized tasks.|

Expand Down
2 changes: 1 addition & 1 deletion docs/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ productDirectory:
- title: GitHub Codespaces
imageSrc: /media/logos/logo_octokitty.svg
links:
- url: https://docs.github.com/github/developing-online-with-codespaces/
- url: https://docs.github.com/codespaces
text: Documentation
- url: https://code.visualstudio.com/docs/remote/codespaces/
text: Use with Visual Studio Code
Expand Down
2 changes: 1 addition & 1 deletion docs/msbuild/customize-your-build.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Customize your build | Microsoft Docs
description: Learn about several extensibility hooks you can use to customize MSBuild projects that use the standard build process.
ms.custom: SEO-VS-2020
ms.date: 09/13/2021
ms.date: 10/07/2022
ms.topic: conceptual
helpviewer_keywords:
- MSBuild, transforms
Expand Down
Loading