Skip to content

Commit ba4eca0

Browse files
Youssef1313Ron Petrusha
authored andcommitted
Replace Entity Framework tokens (#14283)
* delete adonet-ef-md.md * Replace Entity Framework tokens
1 parent b82a9a4 commit ba4eca0

File tree

53 files changed

+135
-136
lines changed

Some content is hidden

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

53 files changed

+135
-136
lines changed

docs/framework/data/adonet/ef/data-providers.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,18 +4,18 @@ ms.date: "03/30/2017"
44
ms.assetid: 5252e639-ff11-4818-82e7-07221ed6ae23
55
---
66
# Entity Framework Data Providers
7-
This section provides information on data providers that support the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)].
7+
This section provides information on data providers that support the Entity Framework.
88

99
## In This Section
1010
[EntityClient Provider for the Entity Framework](entityclient-provider-for-the-entity-framework.md)
11-
Describes the EntityClient data provider. This provider transforms queries against a data model into a canonical command tree. The command tree can then be consumed by a .NET Framework data provider for the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)].
11+
Describes the EntityClient data provider. This provider transforms queries against a data model into a canonical command tree. The command tree can then be consumed by a .NET Framework data provider for the Entity Framework.
1212

1313
[SqlClient for the Entity Framework](sqlclient-for-the-entity-framework.md)
14-
Describes the .NET Framework data provider that supports the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] for use with a SQL Server database.
14+
Describes the .NET Framework data provider that supports the Entity Framework for use with a SQL Server database.
1515

1616
## Related Sections
1717
[Entity Framework (SQL Server Compact)](https://go.microsoft.com/fwlink/?LinkId=135638)
18-
Describes provider limitations and how to use the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] with a SQL Server Compact database.
18+
Describes provider limitations and how to use the Entity Framework with a SQL Server Compact database.
1919

2020
[Third-Party Providers for the Entity Framework](https://go.microsoft.com/fwlink/?LinkId=143699)
2121
List of the third-party data providers currently available for the Entity Framework.

docs/framework/data/adonet/ef/edm-generator-edmgen-exe.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ ms.assetid: fe8297a1-1fc3-48ce-8eeb-f70f63f857aa
66

77
# EDM Generator (EdmGen.exe)
88

9-
EdmGen.exe is a command-line tool used for working with [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] model and mapping files. You can use the EdmGen.exe tool to do the following:
9+
EdmGen.exe is a command-line tool used for working with Entity Framework model and mapping files. You can use the EdmGen.exe tool to do the following:
1010

11-
- Connect to a data source by using a data source–specific .NET Framework data provider, and generate the conceptual model (.csdl), storage model (.ssdl), and mapping (.msl) files that are used by the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)]. For more information, see [How to: Use EdmGen.exe to Generate the Model and Mapping Files](how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md).
11+
- Connect to a data source by using a data source–specific .NET Framework data provider, and generate the conceptual model (.csdl), storage model (.ssdl), and mapping (.msl) files that are used by the Entity Framework. For more information, see [How to: Use EdmGen.exe to Generate the Model and Mapping Files](how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md).
1212

1313
- Validate an existing model. For more information, see [How to: Use EdmGen.exe to Validate Model and Mapping Files](how-to-use-edmgen-exe-to-validate-model-and-mapping-files.md).
1414

docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,14 @@ ms.assetid: 8c5db787-78e6-4a34-8dc1-188bca0aca5e
77
The EntityClient provider is a data provider used by Entity Framework applications to access data described in a conceptual model. For information about conceptual models, see [Modeling and Mapping](modeling-and-mapping.md). EntityClient uses other .NET Framework data providers to access the data source. For example, EntityClient uses the .NET Framework Data Provider for SQL Server (SqlClient) when accessing a SQL Server database. For information about the SqlClient provider, see [SqlClient for the Entity Framework](sqlclient-for-the-entity-framework.md). The EntityClient provider is implemented in the <xref:System.Data.EntityClient> namespace.
88

99
## Managing Connections
10-
The [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] builds on top of storage-specific ADO.NET data providers by providing an <xref:System.Data.EntityClient.EntityConnection> to an underlying data provider and relational database. To construct an <xref:System.Data.EntityClient.EntityConnection> object, you have to reference a set of metadata that contains the necessary models and mapping, and also a storage-specific data provider name and connection string. After the <xref:System.Data.EntityClient.EntityConnection> is in place, entities can be accessed through the classes generated from the conceptual model.
10+
The Entity Framework builds on top of storage-specific ADO.NET data providers by providing an <xref:System.Data.EntityClient.EntityConnection> to an underlying data provider and relational database. To construct an <xref:System.Data.EntityClient.EntityConnection> object, you have to reference a set of metadata that contains the necessary models and mapping, and also a storage-specific data provider name and connection string. After the <xref:System.Data.EntityClient.EntityConnection> is in place, entities can be accessed through the classes generated from the conceptual model.
1111

1212
You can specify a connection string in app.config file.
1313

1414
The <xref:System.Data.EntityClient> also includes the <xref:System.Data.EntityClient.EntityConnectionStringBuilder> class. This class enables developers to programmatically create syntactically correct connection strings, and parse and rebuild existing connection strings, by using properties and methods of the class. For more information, see [How to: Build an EntityConnection Connection String](how-to-build-an-entityconnection-connection-string.md).
1515

1616
## Creating Queries
17-
The [!INCLUDE[esql](../../../../../includes/esql-md.md)] language is a storage-independent dialect of SQL that works directly with conceptual entity schemas and supports Entity Data Model concepts such as inheritance and relationships. The <xref:System.Data.EntityClient.EntityCommand> class is used to execute an [!INCLUDE[esql](../../../../../includes/esql-md.md)] command against an entity model. When you construct <xref:System.Data.EntityClient.EntityCommand> objects, you can specify a stored procedure name or a query text. The [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] works with storage-specific data providers to translate generic [!INCLUDE[esql](../../../../../includes/esql-md.md)] into storage-specific queries. For more information about writing [!INCLUDE[esql](../../../../../includes/esql-md.md)] queries, see [Entity SQL Language](./language-reference/entity-sql-language.md).
17+
The [!INCLUDE[esql](../../../../../includes/esql-md.md)] language is a storage-independent dialect of SQL that works directly with conceptual entity schemas and supports Entity Data Model concepts such as inheritance and relationships. The <xref:System.Data.EntityClient.EntityCommand> class is used to execute an [!INCLUDE[esql](../../../../../includes/esql-md.md)] command against an entity model. When you construct <xref:System.Data.EntityClient.EntityCommand> objects, you can specify a stored procedure name or a query text. The Entity Framework works with storage-specific data providers to translate generic [!INCLUDE[esql](../../../../../includes/esql-md.md)] into storage-specific queries. For more information about writing [!INCLUDE[esql](../../../../../includes/esql-md.md)] queries, see [Entity SQL Language](./language-reference/entity-sql-language.md).
1818

1919
The following example creates an <xref:System.Data.EntityClient.EntityCommand> object and assigns an [!INCLUDE[esql](../../../../../includes/esql-md.md)] query text to its <xref:System.Data.EntityClient.EntityCommand.CommandText%2A?displayProperty=nameWithType> property. This [!INCLUDE[esql](../../../../../includes/esql-md.md)] query requests products ordered by the list price from the conceptual model. The following code has no knowledge of the storage model at all.
2020

docs/framework/data/adonet/ef/generating-sql-from-command-trees-best-practices.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -132,11 +132,11 @@ Also, when flattening joins, participating tables (or subqueries) may have colli
132132

133133
## Avoid SELECT *
134134

135-
Do not use `SELECT *` to select from base tables. The storage model in an [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] application may only include a subset of the columns that are in the database table. In this case, `SELECT *` may produce an incorrect result. Instead, you should specify all participating columns by using the column names from the result type of the participating expressions.
135+
Do not use `SELECT *` to select from base tables. The storage model in an Entity Framework application may only include a subset of the columns that are in the database table. In this case, `SELECT *` may produce an incorrect result. Instead, you should specify all participating columns by using the column names from the result type of the participating expressions.
136136

137137
## Reuse of Expressions
138138

139-
Expressions may be reused in the query command tree passed by the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)]. Do not assume that each expression appears only once in the query command tree.
139+
Expressions may be reused in the query command tree passed by the Entity Framework. Do not assume that each expression appears only once in the query command tree.
140140

141141
## Mapping Primitive Types
142142

docs/framework/data/adonet/ef/getting-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ ms.date: "03/30/2017"
44
ms.assetid: 4735a220-3301-4ec4-8833-7209abb7208f
55
---
66
# Getting Started (Entity Framework)
7-
The ADO.NET [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] supports data-centric applications and services, and provides a platform for programming against data that raises the level of abstraction from the logical relational level to the conceptual level. By enabling developers to work with data at a greater level of abstraction, the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] supports code that is independent of any particular data storage engine or relational schema. For more information, see [Entity Framework Overview](overview.md).
7+
The ADO.NET Entity Framework supports data-centric applications and services, and provides a platform for programming against data that raises the level of abstraction from the logical relational level to the conceptual level. By enabling developers to work with data at a greater level of abstraction, the Entity Framework supports code that is independent of any particular data storage engine or relational schema. For more information, see [Entity Framework Overview](overview.md).
88

99
To quickly start using the latest version of the Entity Framework, see [Get Started](https://go.microsoft.com/fwlink/?LinkId=235280)
1010

docs/framework/data/adonet/ef/how-to-build-an-entityconnection-connection-string.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ This topic provides an example of how to build an <xref:System.Data.EntityClient
1111

1212
### To run the code in this example
1313

14-
1. Add the [AdventureWorks Sales Model](https://github.com/Microsoft/sql-server-samples/releases/tag/adventureworks) to your project and configure your project to use the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)]. For more information, see [How to: Use the Entity Data Model Wizard](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738677(v=vs.100)).
14+
1. Add the [AdventureWorks Sales Model](https://github.com/Microsoft/sql-server-samples/releases/tag/adventureworks) to your project and configure your project to use the Entity Framework. For more information, see [How to: Use the Entity Data Model Wizard](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738677(v=vs.100)).
1515

1616
2. In the code page for your application, add the following `using` statements (`Imports` in Visual Basic):
1717

docs/framework/data/adonet/ef/how-to-define-the-connection-string.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,10 @@ ms.assetid: 6027335d-4e26-420d-9151-6523289b1989
55
---
66
# How to: Define the Connection String
77

8-
This topic shows how to define the connection string that is used when connecting to a conceptual model. This topic is based on the [AdventureWorks Sales](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb387147(v=vs.100)) conceptual model. The AdventureWorks Sales Model is used throughout the task-related topics in the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] documentation. This topic assumes that you have already configured the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] and defined the AdventureWorks Sales Model. For more information, see [How to: Manually Define the Model and Mapping Files](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb399785(v=vs.100)). The procedures in this topic are also included in [How to: Manually Configure an Entity Framework Project](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738546(v=vs.100)).
8+
This topic shows how to define the connection string that is used when connecting to a conceptual model. This topic is based on the [AdventureWorks Sales](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb387147(v=vs.100)) conceptual model. The AdventureWorks Sales Model is used throughout the task-related topics in the Entity Framework documentation. This topic assumes that you have already configured the Entity Framework and defined the AdventureWorks Sales Model. For more information, see [How to: Manually Define the Model and Mapping Files](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb399785(v=vs.100)). The procedures in this topic are also included in [How to: Manually Configure an Entity Framework Project](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738546(v=vs.100)).
99

1010
> [!NOTE]
11-
> If you use the Entity Data Model Wizard in a Visual Studio project, it automatically generates an .edmx file and configures the project to use the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)]. For more information, see [How to: Use the Entity Data Model Wizard](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738677(v=vs.100))
11+
> If you use the Entity Data Model Wizard in a Visual Studio project, it automatically generates an .edmx file and configures the project to use the Entity Framework. For more information, see [How to: Use the Entity Data Model Wizard](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738677(v=vs.100))
1212
1313
## To define the Entity Framework connection string
1414

docs/framework/data/adonet/ef/how-to-execute-a-parameterized-entity-sql-query-using-entitycommand.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ This topic shows how to execute an [!INCLUDE[esql](../../../../../includes/esql-
1111

1212
### To run the code in this example
1313

14-
1. Add the [AdventureWorks Sales Model](https://github.com/Microsoft/sql-server-samples/releases/tag/adventureworks) to your project and configure your project to use the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)]. For more information, see [How to: Use the Entity Data Model Wizard](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738677(v=vs.100)).
14+
1. Add the [AdventureWorks Sales Model](https://github.com/Microsoft/sql-server-samples/releases/tag/adventureworks) to your project and configure your project to use the Entity Framework. For more information, see [How to: Use the Entity Data Model Wizard](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738677(v=vs.100)).
1515

1616
2. In the code page for your application, add the following `using` statements (`Imports` in Visual Basic):
1717

docs/framework/data/adonet/ef/how-to-execute-a-parameterized-stored-procedure-using-entitycommand.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ This topic shows how to execute a parameterized stored procedure by using the <x
1111

1212
### To run the code in this example
1313

14-
1. Add the [School Model](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb896300(v=vs.100)) to your project and configure your project to use the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)]. For more information, see [How to: Use the Entity Data Model Wizard](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738677(v=vs.100)).
14+
1. Add the [School Model](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb896300(v=vs.100)) to your project and configure your project to use the Entity Framework. For more information, see [How to: Use the Entity Data Model Wizard](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738677(v=vs.100)).
1515

1616
2. In the code page for your application, add the following `using` statements (`Imports` in Visual Basic):
1717

docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-complex-types.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ This topic shows how to execute an [!INCLUDE[esql](../../../../../includes/esql-
1111

1212
### To run the code in this example
1313

14-
1. Add the [AdventureWorks Sales Model](https://github.com/Microsoft/sql-server-samples/releases/tag/adventureworks) to your project and configure your project to use the [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)]. For more information, see [How to: Use the Entity Data Model Wizard](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738677(v=vs.100)).
14+
1. Add the [AdventureWorks Sales Model](https://github.com/Microsoft/sql-server-samples/releases/tag/adventureworks) to your project and configure your project to use the Entity Framework. For more information, see [How to: Use the Entity Data Model Wizard](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738677(v=vs.100)).
1515

1616
2. In the code page for your application, add the following `using` statements (`Imports` in Visual Basic):
1717

0 commit comments

Comments
 (0)