|
144 | 144 | </ReturnValue> |
145 | 145 | <Parameters /> |
146 | 146 | <Docs> |
147 | | - <summary>Returns a <see cref="T:System.Data.Common.DbBatch" /> that's ready for execution against the <see cref="T:System.Data.Common.DbDataSource" />.</summary> |
148 | | - <returns>A <see cref="T:System.Data.Common.DbBatch" /> that's ready for execution against the <see cref="T:System.Data.Common.DbDataSource" />.</returns> |
| 147 | + <summary>Returns a new, closed connection to the database represented by this <see cref="T:System.Data.Common.DbDataSource" />.</summary> |
| 148 | + <returns>A new, closed connection to the database represented by this <see cref="T:System.Data.Common.DbDataSource" />.</returns> |
149 | 149 | <remarks> |
150 | 150 | <format type="text/markdown"><![CDATA[ |
151 | 151 | |
152 | 152 | ## Remarks |
153 | | - Batches returned from this method are already configured to execute against their originating <xref:System.Data.Common.DbDataSource>; their <xref:System.Data.Common.DbBatch.Connection%2A> does not need to be set, and doing so will throw an exception. |
| 153 | + The connection must be opened before it can be used. |
154 | 154 |
|
155 | | - Since these batches have no explicitly-managed connection, it is not possible to use them with transactions, and trying to set <xref:System.Data.Common.DbBatch.Transaction%2A> will throw an exception. |
| 155 | + It is the responsibility of the caller to properly dispose the connection returned by this method. Failure to do so may result in a connection leak. |
156 | 156 |
|
157 | 157 | ]]></format> |
158 | 158 | </remarks> |
|
175 | 175 | </ReturnValue> |
176 | 176 | <Parameters /> |
177 | 177 | <Docs> |
178 | | - <summary>Returns a new, closed connection to the database represented by this <see cref="T:System.Data.Common.DbDataSource" />.</summary> |
179 | | - <returns>A new, closed connection to the database represented by this <see cref="T:System.Data.Common.DbDataSource" />.</returns> |
| 178 | + <summary>Returns a <see cref="T:System.Data.Common.DbBatch" /> that's ready for execution against the <see cref="T:System.Data.Common.DbDataSource" />.</summary> |
| 179 | + <returns>A <see cref="T:System.Data.Common.DbBatch" /> that's ready for execution against the <see cref="T:System.Data.Common.DbDataSource" />.</returns> |
180 | 180 | <remarks> |
181 | 181 | <format type="text/markdown"><![CDATA[ |
182 | 182 | |
|
235 | 235 | </ReturnValue> |
236 | 236 | <Parameters /> |
237 | 237 | <Docs> |
238 | | - <summary>Returns a <see cref="T:System.Data.Common.DbBatch" /> that's ready for execution against the <see cref="T:System.Data.Common.DbDataSource" />.</summary> |
239 | | - <returns>A <see cref="T:System.Data.Common.DbBatch" /> that's ready for execution against the <see cref="T:System.Data.Common.DbDataSource" />.</returns> |
| 238 | + <summary>Returns a new, closed connection to the database represented by this <see cref="T:System.Data.Common.DbDataSource" />.</summary> |
| 239 | + <returns>A new, closed connection to the database represented by this <see cref="T:System.Data.Common.DbDataSource" />.</returns> |
240 | 240 | <remarks> |
241 | 241 | <format type="text/markdown"><![CDATA[ |
242 | 242 | |
|
0 commit comments