DataContext Constructors
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Initializes a new instance of the DataContext class. The connection string you use can be an ADO.NET connection string. You can also specify a filename to a SQL Server Express or SQL Server Compact file.
| DataContext(IDbConnection) |
Initializes a new instance of the DataContext class by referencing the connection used by the .NET Framework. |
| DataContext(String) |
Initializes a new instance of the DataContext class by referencing a file source. |
| DataContext(IDbConnection, MappingSource) |
Initializes a new instance of the DataContext class by referencing a connection and a mapping source. |
| DataContext(String, MappingSource) |
Initializes a new instance of the DataContext class by referencing a file source and a mapping source. |
Initializes a new instance of the DataContext class by referencing the connection used by the .NET Framework.
public:
DataContext(System::Data::IDbConnection ^ connection);public DataContext(System.Data.IDbConnection connection);new System.Data.Linq.DataContext : System.Data.IDbConnection -> System.Data.Linq.DataContextPublic Sub New (connection As IDbConnection)Parameters
- connection
- IDbConnection
The connection used by the .NET Framework.
Remarks
A DataContext opens and closes a database connection as needed if you provide a closed connection or a connection string. In general, you should never have to call Dispose on a DataContext. If you provide an open connection, the DataContext will not close it. Therefore, do not instantiate a DataContext with an open connection unless you have a good reason to do this. In a System.Transactions transaction, a DataContext will not open or close a connection to avoid promotion.
Applies to
.NET Framework 4.8.1 and other versions
| Product | Versions |
|---|---|
| .NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Initializes a new instance of the DataContext class by referencing a file source.
public:
DataContext(System::String ^ fileOrServerOrConnection);public DataContext(string fileOrServerOrConnection);new System.Data.Linq.DataContext : string -> System.Data.Linq.DataContextPublic Sub New (fileOrServerOrConnection As String)Parameters
- fileOrServerOrConnection
- String
This argument can be any one of the following: The name of a file where a SQL Server Express database resides.
The name of a server where a database is present. In this case the provider uses the default database for a user.
A complete connection string. LINQ to SQL just passes the string to the provider without modification.
Applies to
.NET Framework 4.8.1 and other versions
| Product | Versions |
|---|---|
| .NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Initializes a new instance of the DataContext class by referencing a connection and a mapping source.
public:
DataContext(System::Data::IDbConnection ^ connection, System::Data::Linq::Mapping::MappingSource ^ mapping);public DataContext(System.Data.IDbConnection connection, System.Data.Linq.Mapping.MappingSource mapping);new System.Data.Linq.DataContext : System.Data.IDbConnection * System.Data.Linq.Mapping.MappingSource -> System.Data.Linq.DataContextPublic Sub New (connection As IDbConnection, mapping As MappingSource)Parameters
- connection
- IDbConnection
The connection used by the .NET Framework.
- mapping
- MappingSource
A source for mapping.
Applies to
.NET Framework 4.8.1 and other versions
| Product | Versions |
|---|---|
| .NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Initializes a new instance of the DataContext class by referencing a file source and a mapping source.
public:
DataContext(System::String ^ fileOrServerOrConnection, System::Data::Linq::Mapping::MappingSource ^ mapping);public DataContext(string fileOrServerOrConnection, System.Data.Linq.Mapping.MappingSource mapping);new System.Data.Linq.DataContext : string * System.Data.Linq.Mapping.MappingSource -> System.Data.Linq.DataContextPublic Sub New (fileOrServerOrConnection As String, mapping As MappingSource)Parameters
- fileOrServerOrConnection
- String
This argument can be any one of the following:
The name of a file where a SQL Server Express database resides.
The name of a server where a database is present. In this case the provider uses the default database for a user.
A complete connection string. LINQ to SQL just passes the string to the provider without modification.
- mapping
- MappingSource
A source for mapping.
Applies to
.NET Framework 4.8.1 and other versions
| Product | Versions |
|---|---|
| .NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: