Skip to content

Commit d1f43cc

Browse files
committed
Merge branch 'master' of github.com:MicrosoftDocs/visualstudio-docs-pr into tglee-vswhatsnew
2 parents e959685 + 9e6c28d commit d1f43cc

File tree

126 files changed

+348
-335
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

126 files changed

+348
-335
lines changed

CONTRIBUTING.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ The content inside the **docs** folder is organized into sections that are organ
1919

2020
You can skip this first step for small changes.
2121

22-
**Step 2:** Fork the `Microsoft/visualstudio-docs` repo.
22+
**Step 2:** Fork the `MicrosoftDocs/visualstudio-docs` repo.
2323

2424
**Step 3:** Create a `branch` for your article.
2525

@@ -42,7 +42,7 @@ Be sure to follow the proper Markdown syntax. See the [style guide](./styleguide
4242
/media
4343
debugging-installed-app-package.png
4444

45-
**Step 5:** Submit a Pull Request (PR) from your branch to `Microsoft/visualstudio-docs/master`.
45+
**Step 5:** Submit a Pull Request (PR) from your branch to `MicrosoftDocs/visualstudio-docs/master`.
4646

4747
If your PR is addressing an existing issue, add the `Fixes #Issue_Number` keyword to the commit message or PR description, so the issue can be automatically closed when the PR is merged. For more information, see [Closing issues via commit messages](https://help.github.com/articles/closing-issues-via-commit-messages/).
4848

docs/data-tools/add-code-to-datasets-in-n-tier-applications.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ You can extend the functionality of a dataset by creating a partial class file f
3939

4040
The code that defines a dataset is generated every time changes are made to the dataset definition (in the typed dataset). This code is also generated when you make changes during the running of any wizard that modifies the configuration of a dataset. To prevent your code from being deleted during the regeneration of a dataset, add code to the dataset's partial class file.
4141

42-
By default, after you separate the dataset and `TableAdapter` code, the result is a discrete class file in each project. The original project has a filenamed *DatasetName*.Designer.vb (or *DatasetName*.Designer.cs) that contains the `TableAdapter` code. The project that's designated in the **Dataset Project** property has a file that's named *DatasetName*.DataSet.Designer.vb (or *DatasetName*.DataSet.Designer.cs).This file contains the dataset code.
42+
By default, after you separate the dataset and `TableAdapter` code, the result is a discrete class file in each project. The original project has a file named *DatasetName*.Designer.vb (or *DatasetName*.Designer.cs) that contains the `TableAdapter` code. The project that's designated in the **Dataset Project** property has a file that's named *DatasetName*.DataSet.Designer.vb (or *DatasetName*.DataSet.Designer.cs).This file contains the dataset code.
4343

4444
> [!NOTE]
4545
> When you separate datasets and `TableAdapter`s (by setting the **DataSet Project** property), existing partial dataset classes in the project won't be moved automatically. Existing dataset partial classes must be moved manually to the dataset project.
@@ -53,7 +53,7 @@ You can extend the functionality of a dataset by creating a partial class file f
5353

5454
2. Select the **.xsd** file to open the dataset.
5555

56-
3. Right-click the data table to which you want to add code (the table name in the title bar), and thenselect**View Code**.
56+
3. Right-click the data table to which you want to add code (the table name in the title bar), and then select **View Code**.
5757

5858
A partial class is created and opens in the Code Editor.
5959

docs/data-tools/add-code-to-tableadapters-in-n-tier-applications.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ You can extend the functionality of a `TableAdapter` by creating a partial class
5656

5757
2. Double click the **.xsd** file to open the **Dataset Designer**.
5858

59-
3. Right-click the `TableAdapter` that you want to add code to, and then select**View Code**.
59+
3. Right-click the `TableAdapter` that you want to add code to, and then select **View Code**.
6060

6161
A partial class is created and opens in the Code Editor.
6262

docs/data-tools/add-new-data-sources.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ In the context of .NET data tools in Visual Studio, the term *data source* refer
6464
## Data source for a database or a database file
6565

6666
### Dataset
67-
To create a dataset as a data source, run the **Data Source Configuration Wizard** (**Project** > **Add New Data** Source) and choose the **Database** data-source type. Follow the prompts to specify a new or existing database connection, or a database file.
67+
To create a dataset as a data source, run the **Data Source Configuration Wizard** (**Project** > **Add New Data Source**) and choose the **Database** data-source type. Follow the prompts to specify a new or existing database connection, or a database file.
6868

6969
### Entity classes
7070
To create an Entity Framework model as a data source, first run the **Entity Data Model Wizard** to create the entity classes (**Project** > **Add New Item** > **ADO.NET Entity Data Model**).

docs/data-tools/add-validation-to-an-n-tier-dataset.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ End Sub
6767

6868
#### To add validation during changes to individual column values
6969

70-
1. Open the dataset in The datasetby double-clicking the **.xsd** file in **Solution Explorer**. For more information, see [Walkthrough: Creating a Dataset in the Dataset Designer](walkthrough-creating-a-dataset-with-the-dataset-designer.md).
70+
1. Open the dataset in The dataset by double-clicking the **.xsd** file in **Solution Explorer**. For more information, see [Walkthrough: Creating a Dataset in the Dataset Designer](walkthrough-creating-a-dataset-with-the-dataset-designer.md).
7171

7272
2. Double-click the column you want to validate. This action creates the <xref:System.Data.DataTable.ColumnChanging> event handler.
7373

@@ -76,7 +76,7 @@ End Sub
7676
7777
3. Add code to verify that `e.ProposedValue` contains data that meets the requirements of your application. If the proposed value is unacceptable, set the column to indicate that it contains an error.
7878

79-
The following code example validates that the **Quantity** column contains more than 0. If**Quantity** is less than or equal to 0, the column is set to an error. The `Else` clause clears the error if**Quantity** is more than 0. The code in the column-changing event handler should resemble the following:
79+
The following code example validates that the **Quantity** column contains more than 0. If **Quantity** is less than or equal to 0, the column is set to an error. The `Else` clause clears the error if **Quantity** is more than 0. The code in the column-changing event handler should resemble the following:
8080

8181
```vb#
8282
If (e.Column.ColumnName = Me.QuantityColumn.ColumnName) Then
@@ -117,7 +117,7 @@ End Sub
117117
}
118118
```
119119
120-
## Validatechanges to whole rows
120+
## Validate changes to whole rows
121121
Validate values in whole rows by handling the <xref:System.Data.DataTable.RowChanging> event. The <xref:System.Data.DataTable.RowChanging> event is raised when the values in all columns are committed. It is necessary to validate in the <xref:System.Data.DataTable.RowChanging> event when the value in one column relies on the value in another column. For example, consider OrderDate and RequiredDate in the Orders table in Northwind.
122122
123123
When orders are being entered, validation makes sure that an order is not entered with a RequiredDate that is on or before the OrderDate. In this example, the values for both the RequiredDate and OrderDate columns need to be compared, so validating an individual column change does not make sense.
@@ -126,7 +126,7 @@ End Sub
126126
127127
#### To add validation during changes to whole rows
128128
129-
1. Open the dataset in The datasetby double-clicking the **.xsd** file in **Solution Explorer**. For more information, see [Walkthrough: Creating a Dataset in the Dataset Designer](walkthrough-creating-a-dataset-with-the-dataset-designer.md).
129+
1. Open the dataset in The dataset by double-clicking the **.xsd** file in **Solution Explorer**. For more information, see [Walkthrough: Creating a Dataset in the Dataset Designer](walkthrough-creating-a-dataset-with-the-dataset-designer.md).
130130
131131
2. Double-click the title bar of the data table on the designer.
132132

docs/data-tools/bind-objects-in-visual-studio.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ translation.priority.mt:
3838
- "tr-tr"
3939
---
4040
# Bind objects in Visual Studio
41-
Visual Studio provides design-time tools for working with custom objects as the data source in your application. When you want to store data from a database in an object that you bind to UI controls, the recommended approach is to use Entity Framework to generate the class or classes. Entity Frameworkautogenerates all the boilerplate change-tracking code, which means that any changes to the local objects are automatically persisted to the database when you call AcceptChanges on the DbSet object. For more information, see [Entity Framework Documentation](https://ef.readthedocs.org/en/latest/).
41+
Visual Studio provides design-time tools for working with custom objects as the data source in your application. When you want to store data from a database in an object that you bind to UI controls, the recommended approach is to use Entity Framework to generate the class or classes. Entity Framework auto-generates all the boilerplate change-tracking code, which means that any changes to the local objects are automatically persisted to the database when you call AcceptChanges on the DbSet object. For more information, see [Entity Framework Documentation](https://ef.readthedocs.org/en/latest/).
4242

4343
> [!TIP]
4444
> The approaches to object binding in this article should only be considered if your application is already based on datasets.These approaches can also be used if you are already familiar with datasets, and the data you will be processing is tabular and not too complex or too big. For an even simpler example, involving loading data directly into objects by using a DataReader and manually updating the UI without databinding, see [Create a simple data application by using ADO.NET](../data-tools/create-a-simple-data-application-by-using-adonet.md).
@@ -65,7 +65,7 @@ Visual Studio provides design-time tools for working with custom objects as the
6565

6666

6767

68-
### Loaddata into objects
68+
### Load data into objects
6969
For this example, you load data into your objects by using TableAdapters. By default, TableAdapters are created with two kinds of methods that fetch data from a database and populate data tables.
7070

7171
- The `TableAdapter.Fill` method fills an existing data table with the data returned.
@@ -97,7 +97,7 @@ Visual Studio provides design-time tools for working with custom objects as the
9797
[!code-cs[VbRaddataConnecting#8](../data-tools/codesnippet/CSharp/bind-objects-in-visual-studio_2.cs)]
9898
[!code-vb[VbRaddataConnecting#8](../data-tools/codesnippet/VisualBasic/bind-objects-in-visual-studio_2.vb)]
9999

100-
### Addobjects to a collection
100+
### Add objects to a collection
101101
You add objects to a collection by calling the `Add` method of your custom collection class or of the <xref:System.Windows.Forms.BindingSource>.
102102

103103

@@ -117,7 +117,7 @@ Visual Studio provides design-time tools for working with custom objects as the
117117
[!code-cs[VbRaddataConnecting#6](../data-tools/codesnippet/CSharp/bind-objects-in-visual-studio_4.cs)]
118118
[!code-vb[VbRaddataConnecting#6](../data-tools/codesnippet/VisualBasic/bind-objects-in-visual-studio_4.vb)]
119119

120-
### Removeobjects from a collection
120+
### Remove objects from a collection
121121
You remove objects from a collection by calling the `Remove` or `RemoveAt` method of your custom collection class or of <xref:System.Windows.Forms.BindingSource>.
122122

123123
> [!NOTE]
@@ -128,15 +128,15 @@ Visual Studio provides design-time tools for working with custom objects as the
128128
[!code-cs[VbRaddataConnecting#7](../data-tools/codesnippet/CSharp/bind-objects-in-visual-studio_5.cs)]
129129
[!code-vb[VbRaddataConnecting#7](../data-tools/codesnippet/VisualBasic/bind-objects-in-visual-studio_5.vb)]
130130

131-
### Displayobject data to users
131+
### Display object data to users
132132
To display the data in objects to users, create an object data source using the **Data Source Configuration** wizard, and then drag the entire object or individual properties onto your form from the **Data Sources** window.
133133

134134
### Modify the data in objects
135135
To edit data in custom objects that are data-bound to Windows Forms controls, simply edit the data in the bound control (or directly in the object's properties). Data-binding architecture updates the data in the object.
136136

137137
If your application requires the tracking of changes and the rolling back of proposed changes to their original values, then you must implement this functionality in your object model. For examples of how data tables keep track of proposed changes, see <xref:System.Data.DataRowState>, <xref:System.Data.DataSet.HasChanges%2A>, and <xref:System.Data.DataTable.GetChanges%2A>.
138138

139-
### Savedata in objects back to the database
139+
### Save data in objects back to the database
140140
Save data back to the database by passing the values from your object to the TableAdapter's DBDirect methods.
141141

142142
Visual Studio creates DBDirect methods that can be executed directly against the database. These methods do not require DataSet or DataTable objects.

docs/data-tools/bind-wpf-controls-to-a-dataset.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ In this walkthrough, you will create a WPF application that contains data-bound
9494

9595
2. In the **Data Sources** window, click **Add New Data Source**.
9696

97-
The **Data Source Configuration**wizard opens.
97+
The **Data Source Configuration** wizard opens.
9898

9999
3. On the **Choose a Data Source Type** page, select **Database**, and then click **Next**.
100100

@@ -112,7 +112,7 @@ In this walkthrough, you will create a WPF application that contains data-bound
112112

113113
8. Click **Finish**.
114114

115-
Visual Studio adds a new AdventureWorksLTDataSet.xsd file to the project, and it adds a corresponding **AdventureWorksLTDataSet** item to the **Data Sources** window. The AdventureWorksLTDataSet.xsd file defines a typed dataset named `AdventureWorksLTDataSet` and a TableAdapter named `ProductTableAdapter`. Later in this walkthrough, you will use the `ProductTableAdapter` to fill the dataset with data and save changes back to the database.
115+
Visual Studio adds a new `AdventureWorksLTDataSet.xsd` file to the project, and it adds a corresponding **AdventureWorksLTDataSet** item to the **Data Sources** window. The `AdventureWorksLTDataSet.xsd` file defines a typed dataset named `AdventureWorksLTDataSet` and a TableAdapter named `ProductTableAdapter`. Later in this walkthrough, you will use the `ProductTableAdapter` to fill the dataset with data and save changes back to the database.
116116

117117
9. Build the project.
118118

@@ -121,13 +121,13 @@ In this walkthrough, you will create a WPF application that contains data-bound
121121

122122
#### To load product rows that have photos
123123

124-
1. In **Solution Explorer**, double-click the AdventureWorksLTDataSet.xsd file.
124+
1. In **Solution Explorer**, double-click the `AdventureWorksLTDataSet.xsd` file.
125125

126126
The Dataset designer opens.
127127

128-
2. In the designer, right-click the **Fill,GetData()** query and select **Configure**.
128+
2. In the designer, right-click the **Fill, GetData()** query and select **Configure**.
129129

130-
The **TableAdapter Configuration**wizard opens.
130+
The **TableAdapter Configuration** wizard opens.
131131

132132
3. In the **Enter a SQL Statement** page, add the following WHERE clause after the `SELECT` statement in the text box.
133133

@@ -160,7 +160,7 @@ In this walkthrough, you will create a WPF application that contains data-bound
160160
161161
3. Build the project.
162162
163-
## Createdata-bound controls
163+
## Create data-bound controls
164164
Create controls that display customer records by dragging the `Product` table from the **Data Sources** window to the WPF Designer.
165165
166166
#### To create data-bound controls
@@ -220,7 +220,7 @@ In this walkthrough, you will create a WPF application that contains data-bound
220220
[!code-cs[Data_WPFDATASET#3](../data-tools/codesnippet/CSharp/bind-wpf-controls-to-a-dataset_3.cs)]
221221
[!code-vb[Data_WPFDATASET#3](../data-tools/codesnippet/VisualBasic/bind-wpf-controls-to-a-dataset_3.vb)]
222222
223-
## Savechanges to product records
223+
## Save changes to product records
224224
Add code that enables users to save changes to product records by using the **Save changes** button.
225225
226226
#### To add the ability to save changes to product records

docs/data-tools/bind-wpf-controls-to-a-wcf-data-service.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ In this walkthrough, you will create a WPF application that contains data-bound
102102

103103
3. Change the name to `AdventureWorksModel.edmx`, and click **Add**.
104104

105-
The **Entity Data Model**wizard opens.
105+
The **Entity Data Model** wizard opens.
106106

107107
4. On the **Choose Model Contents** page, click **Generate from database**, and click **Next**.
108108

@@ -166,7 +166,7 @@ In this walkthrough, you will create a WPF application that contains data-bound
166166

167167
6. In the **Data Sources** window, click **Add New Data Source**.
168168

169-
The **Data Source Configuration**wizard opens.
169+
The **Data Source Configuration** wizard opens.
170170

171171
7. In the **Choose a Data Source Type** page of the wizard, select **Service**, and then click **Next**.
172172

@@ -189,7 +189,7 @@ In this walkthrough, you will create a WPF application that contains data-bound
189189

190190
#### To create the window layout
191191

192-
1. In **Solution Explorer**, double-click MainWindow.xaml.
192+
1. In **Solution Explorer**, double-click **MainWindow.xaml**.
193193

194194
The window opens in the WPF designer.
195195

@@ -258,7 +258,7 @@ In this walkthrough, you will create a WPF application that contains data-bound
258258
[!code-cs[Data_WPFWCF#2](../data-tools/codesnippet/CSharp/bind-wpf-controls-to-a-wcf-data-service_2.cs)]
259259
[!code-vb[Data_WPFWCF#2](../data-tools/codesnippet/VisualBasic/bind-wpf-controls-to-a-wcf-data-service_2.vb)]
260260
261-
## Navigatesales records
261+
## Navigate sales records
262262
Add code that enables users to scroll through sales records by using the **\<** and **>** buttons.
263263
264264
#### To enable users to navigate sales records

docs/data-tools/could-not-retrieve-schema-information-for-database-object-object-name.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ translation.priority.mt:
2727
- "pt-br"
2828
- "tr-tr"
2929
---
30-
# Could not retrieve schema information for database object &lt;object name&gt;
30+
# Could not retrieve schema information for database object \<object name>
3131
This message typically appears when an object in **Server Explorer/Database Explorer** is copied to the clipboard, deleted from the database, and then pasted onto the designer. Because the database object no longer exists, this message appears.
3232

3333
### To correct this error

docs/data-tools/create-a-simple-data-application-by-using-adonet.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -746,7 +746,7 @@ End Namespace
746746
|NC29|Close the NewCustomer form, and return focus to the Navigation form.|
747747

748748
### FillOrCancel form
749-
The FillorCancel form runs a query to return an order when you enter an order ID and select the **Find Order** button. The returned row appears in a read-only data grid. You can mark the order as canceled (X) if you select the **Cancel Order** button, or you can mark the order as filled (F) if you select the **Fill Order** button. If you select the **Find Order** button again, the updated row appears.
749+
The FillOrCancel form runs a query to return an order when you enter an order ID and select the **Find Order** button. The returned row appears in a read-only data grid. You can mark the order as canceled (X) if you select the **Cancel Order** button, or you can mark the order as filled (F) if you select the **Fill Order** button. If you select the **Find Order** button again, the updated row appears.
750750

751751
#### Create event handlers
752752
Create empty Click event handlers for the four buttons on the form.

0 commit comments

Comments
 (0)