diff --git a/xml/System.Data.Common/DbDataReader.xml b/xml/System.Data.Common/DbDataReader.xml index da62b0f9b17..7774967e5d4 100644 --- a/xml/System.Data.Common/DbDataReader.xml +++ b/xml/System.Data.Common/DbDataReader.xml @@ -200,7 +200,7 @@ 4.2.0.0 - Releases the resources used by the and calls . + Releases the resources used by the and calls . ADO.NET Overview @@ -300,7 +300,7 @@ . + This method calls . ]]> @@ -422,6 +422,7 @@ Gets the value of the specified column as a Boolean. The value of the specified column. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -466,6 +467,7 @@ Gets the value of the specified column as a byte. The value of the specified column. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -515,9 +517,10 @@ The buffer into which to copy the data. The index with the buffer to which the data will be copied. The maximum number of characters to read. - Reads a stream of bytes from the specified column, starting at location indicated by , into the buffer, starting at the location indicated by . + Reads a specified number of bytes from the specified column starting at a specified index and writes them to a buffer starting at a specified position in the buffer. The actual number of bytes read. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -562,6 +565,7 @@ Gets the value of the specified column as a single character. The value of the specified column. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -611,7 +615,7 @@ The buffer into which to copy the data. The index with the buffer to which the data will be copied. The maximum number of characters to read. - Reads a stream of characters from the specified column, starting at location indicated by , into the buffer, starting at the location indicated by . + Reads a specified number of characters from a specified column starting at a specified index, and writes them to a buffer starting at a specified position. The actual number of characters read. To be added. ADO.NET Overview @@ -656,9 +660,10 @@ The zero-based column ordinal. - Returns a object for the requested column ordinal. - A object. + Returns a nested data reader for the requested column. + A data reader. To be added. + The column index is out of range. ADO.NET Overview @@ -700,7 +705,7 @@ The zero-based column ordinal. Gets name of the data type of the specified column. - A string representing the name of the data type. + The name of the data type. - The specified cast is not valid. + The column index is out of range. ADO.NET Overview @@ -768,6 +773,7 @@ private static void GetDataTypes(String connectionString) { Gets the value of the specified column as a object. The value of the specified column. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -849,9 +855,10 @@ private static void GetDataTypes(String connectionString) { The zero-based column ordinal. - Gets the value of the specified column as a object. + Gets the value of the specified column as a . The value of the specified column. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -994,6 +1001,7 @@ private static void GetDataTypes(String connectionString) { Gets the data type of the specified column. The data type of the specified column. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -1033,38 +1041,30 @@ private static void GetDataTypes(String connectionString) { - Synchronously gets the value of the specified column as a type. - The column to be retrieved. - Synchronously gets the value of the specified column as a type. - The column to be retrieved. - - - - The connection drops or is closed during the data retrieval. + The type of the value to be returned. + The zero-based column ordinal. + Gets the value of the specified column as the requested type. + The value of the specified column. + The connection was dropped or closed during data retrieval. -or- - The is closed during the data retrieval. + The data reader was closed during data retrieval. -or- - There is no data ready to be read (for example, the first hasn't been called, or returned false). + There is no data ready to be read (for example, the first hasn't been called, or it returned ). -or- - Tried to read a previously-read column in sequential mode. + The reader tried to read a previously-read column in sequential mode. -or- There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. - Trying to read a column that does not exist. + The column index is out of range. - doesn't match the type returned by SQL Server or cannot be cast. + The value returned by the database doesn't match or cannot be cast to . @@ -1073,15 +1073,7 @@ private static void GetDataTypes(String connectionString) { 4.1.0.0 - Asynchronously gets the value of the specified column as a type. - - - + Asynchronously gets the value of the specified column as the requested type. @@ -1120,35 +1112,34 @@ private static void GetDataTypes(String connectionString) { The type of the value to be returned. - The type of the value to be returned. - Asynchronously gets the value of the specified column as a type. - The type of the value to be returned. + The zero-based column ordinal. + Asynchronously gets the value of the specified column as the requested type. + A task whose contains the value of the specified column. - - The connection drops or is closed during the data retrieval. + + The connection was dropped or closed during data retrieval. -or- - The is closed during the data retrieval. + The data reader was closed during the data retrieval. -or- - There is no data ready to be read (for example, the first hasn't been called, or returned false). + There is no data ready to be read (for example, the first hasn't been called, or it returned ). -or- @@ -1156,10 +1147,10 @@ private static void GetDataTypes(String connectionString) { -or- - There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. - Trying to read a column that does not exist. + There was an asynchronous operation in progress. This applies to all Get_*_ methods when running in sequential mode, as they could be called while reading a stream. + The column index is out of range. - doesn't match the type returned by the data source or cannot be cast. + The value returned by the database doesn't match or cannot be cast to . @@ -1198,36 +1189,35 @@ private static void GetDataTypes(String connectionString) { The type of the value to be returned. - The type of the value to be returned. - The cancellation instruction, which propagates a notification that operations should be canceled. This does not guarantee the cancellation. A setting of makes this method equivalent to . The returned task must be marked as cancelled. - Asynchronously gets the value of the specified column as a type. - The type of the value to be returned. + The zero-based column ordinal. + A token to cancel the asynchronous operation. + Asynchronously gets the value of the specified column as the requested type. + A task whose contains the value of the specified column. - - The connection drops or is closed during the data retrieval. + The connection was dropped or closed during data retrieval. -or- - The is closed during the data retrieval. + The data reader was closed during the data retrieval. -or- - There is no data ready to be read (for example, the first hasn't been called, or returned false). + There is no data ready to be read (for example, the first hasn't been called, or it returned ). -or- @@ -1235,10 +1225,10 @@ private static void GetDataTypes(String connectionString) { -or- - There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. - Trying to read a column that does not exist. + There was an asynchronous operation in progress. This applies to all Get_*_ methods when running in sequential mode, as they could be called while reading a stream. + The column index is out of range. - doesn't match the type returned by the data source or cannot be cast. + The value returned by the database doesn't match or cannot be cast to . @@ -1281,6 +1271,7 @@ private static void GetDataTypes(String connectionString) { Gets the value of the specified column as a single-precision floating point number. The value of the specified column. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -1322,9 +1313,10 @@ private static void GetDataTypes(String connectionString) { The zero-based column ordinal. - Gets the value of the specified column as a globally-unique identifier (GUID). + Gets the value of the specified column as a globally unique identifier (GUID). The value of the specified column. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -1369,6 +1361,7 @@ private static void GetDataTypes(String connectionString) { Gets the value of the specified column as a 16-bit signed integer. The value of the specified column. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -1437,6 +1430,7 @@ private static void GetCredits(String connectionString) { ]]> + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -1481,6 +1475,7 @@ private static void GetCredits(String connectionString) { Gets the value of the specified column as a 64-bit signed integer. The value of the specified column. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -1611,9 +1606,10 @@ private static void GetCredits(String connectionString) { The zero-based column ordinal. - Returns the provider-specific field type of the specified column. - The object that describes the data type of the specified column. + Gets the provider-specific type of the specified column. + A provider-specific .NET type. To be added. + The column index is out of range. ADO.NET Overview @@ -1656,7 +1652,7 @@ private static void GetCredits(String connectionString) { The zero-based column ordinal. - Gets the value of the specified column as an instance of . + Gets the value of the specified column as an instance of a provider-specific type. The value of the specified column. An array of into which to copy the attribute columns. Gets all provider-specific attribute columns in the collection for the current row. - The number of instances of in the array. + The number of instances of elements in the array. To be added. ADO.NET Overview @@ -1749,7 +1745,8 @@ private static void GetCredits(String connectionString) { Returns a that describes the column metadata of the . A that describes the column metadata. To be added. - The is closed. + The is closed. + The column index is out of range. ADO.NET Overview @@ -1785,24 +1782,21 @@ private static void GetCredits(String connectionString) { - Retrieves data as a . - Retrieves data as a . - The returned object. + The zero-based column ordinal. + Gets a stream to retrieve data from the specified column. + A stream. only supports the retrieval of values that can be converted to byte arrays. - - For more information, see [SqlClient Streaming Support](~/docs/framework/data/adonet/sqlclient-streaming-support.md). - ]]> - The connection drops or is closed during the data retrieval. + The connection was dropped or closed during the data retrieval. -or- - The is closed during the data retrieval. + The data reader is closed during the data retrieval. -or- @@ -1810,12 +1804,12 @@ private static void GetCredits(String connectionString) { -or- - Tried to read a previously-read column in sequential mode. + The data reader tried to read a previously-read column in sequential mode. -or- There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. - Trying to read a column that does not exist. + The column index is out of range. The specified column isn't a binary type that supports reading with a . @@ -1859,6 +1853,7 @@ private static void GetCredits(String connectionString) { Gets the value of the specified column as an instance of . The value of the specified column. To be added. + The column index is out of range. The specified cast is not valid. ADO.NET Overview @@ -1895,24 +1890,21 @@ private static void GetCredits(String connectionString) { - Retrieves data as a . - Retrieves data as a . - The returned object. + The zero-based column ordinal. + Gets a text reader to retrieve data from the column. + A text reader. only supports the retrieval of values that can be converted to character arrays (strings). - - For more information, see [SqlClient Streaming Support](~/docs/framework/data/adonet/sqlclient-streaming-support.md). - ]]> - The connection drops or is closed during the data retrieval. + The connection was dropped or closed during the data retrieval. -or- - The is closed during the data retrieval. + The data reader is closed during the data retrieval. -or- @@ -1920,12 +1912,12 @@ private static void GetCredits(String connectionString) { -or- - Tried to read a previously-read column in sequential mode. + The data reader tried to read a previously-read column in sequential mode. -or- There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. - Trying to read a column that does not exist. + The column index is out of range. The specified column isn't a text type that supports reading with a . @@ -1969,6 +1961,7 @@ private static void GetCredits(String connectionString) { Gets the value of the specified column as an instance of . The value of the specified column. To be added. + The column index is out of range. ADO.NET Overview @@ -2047,7 +2040,7 @@ private static void GetCredits(String connectionString) { Gets a value that indicates whether this contains one or more rows. - if the contains one or more rows; otherwise . + if the contains one or more rows; otherwise, . To be added. ADO.NET Overview @@ -2087,9 +2080,9 @@ private static void GetCredits(String connectionString) { Gets a value indicating whether the is closed. - if the is closed; otherwise . + if the is closed; otherwise, . To be added. - The is closed. + The is closed. This property and should be implemented to return a value when the reader is closed. @@ -2135,15 +2128,16 @@ private static void GetCredits(String connectionString) { The zero-based column ordinal. Gets a value that indicates whether the column contains nonexistent or missing values. - if the specified column is equivalent to ; otherwise . + if the specified column is equivalent to ; otherwise, . , , and so on) to avoid raising an error. + Call this method to check for null column values before calling the typed Get_*_ methods (for example, , , and so on) to avoid throwing an exception. ]]> + The column index is out of range. ADO.NET Overview @@ -2154,7 +2148,7 @@ private static void GetCredits(String connectionString) { 4.2.0.0 - An asynchronous version of , which gets a value that indicates whether the column contains non-existent or missing values. + Asynchronously gets a value that indicates whether the column contains non-existent or missing values. @@ -2190,22 +2184,29 @@ private static void GetCredits(String connectionString) { The zero-based column to be retrieved. - An asynchronous version of , which gets a value that indicates whether the column contains non-existent or missing values. + Asynchronously gets a value that indicates whether the column contains non-existent or missing values. - if the specified column value is equivalent to otherwise . + A whose property is if the specified column value is equivalent to or if it is not. - - The connection drops or is closed during the data retrieval. +The connection was dropped or closed during the data retrieval. -or- - The is closed during the data retrieval. + The data reader is closed during the data retrieval. -or- @@ -2218,7 +2219,7 @@ private static void GetCredits(String connectionString) { -or- There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. - Trying to read a column that does not exist. + The column index is out of range. @@ -2254,23 +2255,32 @@ private static void GetCredits(String connectionString) { The zero-based column to be retrieved. - The cancellation instruction, which propagates a notification that operations should be canceled. This does not guarantee the cancellation. A setting of makes this method equivalent to . The returned task must be marked as cancelled. - An asynchronous version of , which gets a value that indicates whether the column contains non-existent or missing values. Optionally, sends a notification that operations should be cancelled. + A token to cancel the asynchronous operation. + Asynchronously gets a value that indicates whether the column contains non-existent or missing values. - if the specified column value is equivalent to otherwise . + A whose property is if the specified column value is equivalent to or if it is not. - - The connection drops or is closed during the data retrieval. + + The connection was dropped or closed during the data retrieval. -or- - The is closed during the data retrieval. + The data reader is closed during the data retrieval. -or- @@ -2283,7 +2293,7 @@ private static void GetCredits(String connectionString) { -or- There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. - Trying to read a column that does not exist. + The column index is out of range. @@ -2337,7 +2347,7 @@ private static void GetCredits(String connectionString) { Gets the value of the specified column as an instance of . The value of the specified column. To be added. - The index passed was outside the range of 0 through . + The column index is out of range. ADO.NET Overview @@ -2421,7 +2431,7 @@ private static void GetCredits(String connectionString) { Advances the reader to the next result when reading the results of a batch of statements. - if there are more result sets; otherwise . + if there are more result sets; otherwise, . 4.1.0.0 - Implements the asynchronous version of , but returns a Task synchronously, blocking the calling thread. + Asynchronously advances the reader to the next result when reading the results of a batch of statements. - An asynchronous version of , which advances the reader to the next result when reading the results of a batch of statements. - - Invokes with CancellationToken.None. - A task representing the asynchronous operation. + Asynchronously advances the reader to the next result when reading the results of a batch of statements. + A whose property is if there are more result sets or if there aren't. An error occurred while executing the command text. @@ -2529,18 +2539,18 @@ private static void GetCredits(String connectionString) { The cancellation instruction. - This is the asynchronous version of . Providers should override with an appropriate implementation. The may optionally be ignored. - - The default implementation invokes the synchronous method and returns a completed task, blocking the calling thread. The default implementation will return a cancelled task if passed an already cancelled . Exceptions thrown by will be communicated via the returned Task Exception property. - - Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed. - A task representing the asynchronous operation. + Asynchronously advances the reader to the next result when reading the results of a batch of statements. + A whose property is if there are more result sets or if there aren't. An error occurred while executing the command text. @@ -2583,7 +2593,7 @@ private static void GetCredits(String connectionString) { Advances the reader to the next record in a result set. - if there are more rows; otherwise . + if there are more rows; otherwise, . 4.1.0.0 - Implements the asynchronous version of , but returns a Task synchronously, blocking the calling thread. + Asynchronously advances the reader to the next record in a result set. - An asynchronous version of , which advances the reader to the next record in a result set. This method invokes with CancellationToken.None. - A task representing the asynchronous operation. + Asynchronously advances the reader to the next record in a result set. + A whose property is if there are more rows or if there aren't. An error occurred while executing the command text. @@ -2689,18 +2702,19 @@ private static void GetCredits(String connectionString) { The cancellation instruction. - This is the asynchronous version of . Providers should override with an appropriate implementation. The cancellationToken may optionally be ignored. - - The default implementation invokes the synchronous method and returns a completed task, blocking the calling thread. The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Exceptions thrown by Read will be communicated via the returned Task Exception property. - - Do not invoke other methods and properties of the object until the returned Task is complete. - A task representing the asynchronous operation. + Asynchronously advances the reader to the next record in a result set. + A whose property is if there are more rows or if there aren't. An error occurred while executing the command text. @@ -2907,4 +2921,4 @@ private static void GetCredits(String connectionString) { - \ No newline at end of file + diff --git a/xml/System.Data/DataReaderExtensions.xml b/xml/System.Data/DataReaderExtensions.xml index 539d488564a..21c6b2c9350 100644 --- a/xml/System.Data/DataReaderExtensions.xml +++ b/xml/System.Data/DataReaderExtensions.xml @@ -14,7 +14,7 @@ - To be added. + Provides extension methods for . To be added. @@ -38,11 +38,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as a Boolean. + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -65,11 +68,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as a byte. + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -96,15 +102,18 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + The index within the row from which to begin the read operation. + The buffer into which to copy the data. + The index with the buffer to which the data will be copied. + The maximum number of characters to read. + Reads a specified number of bytes from the specified column starting at a specified index and writes them to a buffer starting at a specified position in the buffer. + The actual number of bytes read. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -127,11 +136,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as a single character. + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -158,15 +170,17 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + The index within the row from which to begin the read operation. + The buffer into which to copy the data. + The index with the buffer to which the data will be copied. + The maximum number of characters to read. + Reads a specified number of characters from a specified column starting at a specified index, and writes them to a buffer starting at a specified position. + The actual number of characters read. To be added. + The name specified is not a valid column name. + ADO.NET Overview @@ -194,11 +208,13 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Returns a nested data reader for the requested column. + A data reader. To be added. + The name specified is not a valid column name. + ADO.NET Overview @@ -221,11 +237,13 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column type name from. + The name of the column. + Gets name of the data type of the specified column. + The name of the data type. To be added. + The name specified is not a valid column name. + ADO.NET Overview @@ -248,11 +266,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as a object. + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -275,11 +296,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as a . + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -302,11 +326,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as a double-precision floating point number. + The value of the specified column. To be added. + The specified cast is not valid. + The name specified is not a valid column name. + ADO.NET Overview @@ -329,11 +356,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the field type from. + The name of the column. + Gets the data type of the specified column. + The data type of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -359,12 +389,31 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of the value to be returned. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as the requested type. + The value of the specified column. + The connection was dropped or closed during data retrieval. + +-or- + + The data reader was closed during data retrieval. + +-or- + + There is no data ready to be read (for example, the first hasn't been called, or it returned ). + +-or- + + The reader tried to read a previously-read column in sequential mode. + +-or- + + There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. + The name specified is not a valid column name. + + The value returned by the database doesn't match or cannot be cast to . @@ -389,13 +438,47 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The type of the value to be returned. + The data reader to get the column value from. + The name of the column. + An optional token to cancel the asynchronous operation. + Asynchronously gets the value of the specified column as the requested type. + A task whose contains the value of the specified column. + + + + The connection was dropped or closed during data retrieval. + +-or- + + The data reader was closed during the data retrieval. + +-or- + + There is no data ready to be read (for example, the first hasn't been called, or it returned ). + +-or- + + Tried to read a previously-read column in sequential mode. + +-or- + + There was an asynchronous operation in progress. This applies to all Get_*_ methods when running in sequential mode, as they could be called while reading a stream. + The name specified is not a valid column name. + The value returned by the database doesn't match or cannot be cast to . @@ -418,11 +501,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as a single-precision floating point number. + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -445,11 +531,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as a globally unique identifier (GUID). + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -472,11 +561,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as a 16-bit signed integer. + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -499,11 +591,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as a 32-bit signed integer. + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -526,11 +621,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as a 64-bit signed integer. + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -558,11 +656,13 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the provider-specific type of the specified column. + A provider-specific .NET type. To be added. + The name specified is not a valid column name. + ADO.NET Overview @@ -590,11 +690,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as an instance of a provider-specific type. + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -617,11 +720,36 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets a stream to retrieve data from the specified column. + A stream. + + only supports the retrieval of values that can be converted to byte arrays. + ]]> + + The connection was dropped or closed during the data retrieval. + +-or- + + The data reader is closed during the data retrieval. + +-or- + + There is no data ready to be read (for example, the first hasn't been called, or returned false). + +-or- + + The data reader tried to read a previously-read column in sequential mode. + +-or- + + There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. + The name specified is not a valid column name. + The specified column isn't a binary type that supports reading with a . @@ -644,11 +772,14 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as an instance of . + The value of the specified column. To be added. + The name specified is not a valid column name. + The specified cast is not valid. + ADO.NET Overview @@ -671,11 +802,37 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets a text reader to retrieve data from the column. + A text reader. + + only supports the retrieval of values that can be converted to character arrays (strings). + ]]> + + The connection was dropped or closed during the data retrieval. + +-or- + + The data reader is closed during the data retrieval. + +-or- + + There is no data ready to be read (for example, the first hasn't been called, or returned false). + +-or- + + The data reader tried to read a previously-read column in sequential mode. + +-or- + + There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. + The name specified is not a valid column name. + The specified column isn't a text type that supports reading with a . + @@ -698,11 +855,13 @@ - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets the value of the specified column as an instance of . + The value of the specified column. To be added. + The name specified is not a valid column name. + ADO.NET Overview @@ -725,11 +884,21 @@ - To be added. - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + Gets a value that indicates whether the column contains nonexistent or missing values. + + if the specified column is equivalent to ; otherwise, . + + , , and so on) to avoid throwing an exception. + + ]]> + + The name specified is not a valid column name. + ADO.NET Overview @@ -751,13 +920,49 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data reader to get the column value from. + The name of the column. + An optional token to cancel the asynchronous operation. + Asynchronously gets a value that indicates whether the column contains non-existent or missing values. + + A whose property is if the specified column value is equivalent to or if it is not. + + + + The connection was dropped or closed during the data retrieval. + +-or- + + The data reader is closed during the data retrieval. + +-or- + + There is no data ready to be read (for example, the first hasn't been called, or returned false). + +-or- + + Trying to read a previously read column in sequential mode. + +-or- + + There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. + The name specified is not a valid column name. - \ No newline at end of file +