OleDbDataReader Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bir veri kaynağından yalnızca ileriye doğru veri satırları akışını okumanın bir yolunu sağlar. Bu sınıf devralınamaz.
public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader
public ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
public sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataReader = class
inherit DbDataReader
type OleDbDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDisposable
interface IDataRecord
interface IEnumerable
type OleDbDataReader = class
inherit DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
- Devralma
- Devralma
- Devralma
- Öznitelikler
- Uygulamalar
Örnekler
Aşağıdaki örnek, bir OleDbConnection, OleDbCommandve oluşturur OleDbDataReader. Örnek, verileri okuyarak konsola yazar. Son olarak, örnek ve sonra öğesini OleDbConnectionkapatırOleDbDataReader.
public static void ReadData(string connectionString, string queryString)
{
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbCommand command = new OleDbCommand(queryString, connection);
connection.Open();
OleDbDataReader reader = command.ExecuteReader();
while (reader.Read())
{
Console.WriteLine(reader[0].ToString());
}
reader.Close();
}
}
Public Sub ReadData(ByVal connectionString As String, _
ByVal queryString As String)
Using connection As New OleDbConnection(connectionString)
Dim command As New OleDbCommand(queryString, connection)
connection.Open()
Dim reader As OleDbDataReader = command.ExecuteReader()
While reader.Read()
Console.WriteLine(reader(0).ToString())
End While
reader.Close()
End Using
End Sub
Açıklamalar
oluşturmak OleDbDataReaderiçin, doğrudan bir oluşturucu kullanmak yerine nesnesinin OleDbCommand yöntemini çağırmanız ExecuteReader gerekir.
öğesini kapatmadan OleDbConnectionönce nesnesini kapatın OleDbDataReader . Bir nesneyi yeniden kullanma OleDbCommand planınız varsa nesneyi de kapatmanız OleDbDataReader gerekir. Örneğin, çağrısından Closesonraya kadar çıkış parametrelerini alamazsınız.
Veriler okunurken başka bir işlem veya iş parçacığı tarafından bir sonuç kümesinde yapılan değişiklikler, kullanıcı tarafından OleDbDataReadergörülebilir. Ancak, kesin davranış zamanlamaya bağlıdır.
IsClosed ve RecordsAffected kapatıldıktan sonra OleDbDataReader çağırabileceğiniz tek özelliklerdir. mevcutken OleDbDataReader özelliğine RecordsAffected erişilse de, doğru dönüş değerini garanti etmek için değerini RecordsAffected döndürmeden önce her zaman öğesini çağırınClose.
Özellikler
| Name | Description |
|---|---|
| Depth |
Geçerli satır için iç içe yerleştirme derinliğini gösteren bir değer alır. |
| FieldCount |
Geçerli satırdaki sütun sayısını alır. |
| HasRows |
öğesinin bir veya daha fazla satır içerdiğini OleDbDataReader belirten bir değer alır. |
| IsClosed |
Veri okuyucunun kapalı olup olmadığını gösterir. |
| Item[Int32] |
Belirtilen sütunun değerini, sütun sırasıyla yerel biçiminde alır. |
| Item[String] |
Belirtilen sütunun değerini, sütun adı verilen yerel biçiminde alır. |
| RecordsAffected |
SQL deyiminin yürütülmesiyle değiştirilen, eklenen veya silinen satır sayısını alır. |
| VisibleFieldCount |
içinde OleDbDataReader gizli olmayan alanların sayısını alır. |
Yöntemler
| Name | Description |
|---|---|
| Close() |
OleDbDataReader Nesneyi kapatır. |
| CreateObjRef(Type) |
Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject) |
| Dispose() |
Sınıfın geçerli örneği DbDataReader tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: DbDataReader) |
| Dispose(Boolean) |
tarafından DbDataReader kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır. (Devralındığı yer: DbDataReader) |
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| Finalize() |
Nesnenin, atık toplama tarafından geri kazanılmadan önce kaynakları boşaltmaya ve diğer temizleme işlemlerini gerçekleştirmeye çalışmasına izin verir. |
| GetBoolean(Int32) |
Belirtilen sütunun değerini Boole olarak alır. |
| GetByte(Int32) |
Belirtilen sütunun değerini bayt olarak alır. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Belirtilen sütun uzaklığından arabelleğe verilen arabellek uzaklığından başlayan bir dizi olarak bayt akışını okur. |
| GetChar(Int32) |
Belirtilen sütunun değerini karakter olarak alır. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Belirtilen sütun uzaklığından arabelleğe verilen arabellek uzaklığından başlayan bir dizi olarak bir karakter akışı okur. |
| GetData(Int32) |
İstenen sütun sıralı için bir OleDbDataReader nesne döndürür. |
| GetDataTypeName(Int32) |
Kaynak veri türünün adını alır. |
| GetDateTime(Int32) |
Belirtilen sütunun değerini nesne DateTime olarak alır. |
| GetDbDataReader(Int32) |
DbDataReader İstenen sütun sıralı için sağlayıcıya özgü bir uygulamayla geçersiz kılınabilecek bir nesne döndürür. (Devralındığı yer: DbDataReader) |
| GetDecimal(Int32) |
Belirtilen sütunun değerini nesne Decimal olarak alır. |
| GetDouble(Int32) |
Belirtilen sütunun değerini çift duyarlıklı kayan noktalı sayı olarak alır. |
| GetEnumerator() |
Veri okuyucudaki satırlar arasında yineleme yapmak için kullanılabilecek bir IEnumerator döndürür. |
| GetFieldType(Int32) |
Type Nesnenin veri türü olan öğesini alır. |
| GetFieldValue<T>(Int32) |
İstenen tür olarak belirtilen sütunun değerini alır. (Devralındığı yer: DbDataReader) |
| GetFieldValueAsync<T>(Int32, CancellationToken) |
Belirtilen sütunun değerini istenen tür olarak zaman uyumsuz olarak alır. (Devralındığı yer: DbDataReader) |
| GetFieldValueAsync<T>(Int32) |
Belirtilen sütunun değerini istenen tür olarak zaman uyumsuz olarak alır. (Devralındığı yer: DbDataReader) |
| GetFloat(Int32) |
Belirtilen sütunun değerini tek duyarlıklı kayan noktalı sayı olarak alır. |
| GetGuid(Int32) |
Belirtilen sütunun değerini genel olarak benzersiz tanımlayıcı (GUID) olarak alır. |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetInt16(Int32) |
Belirtilen sütunun değerini 16 bit imzalı tamsayı olarak alır. |
| GetInt32(Int32) |
Belirtilen sütunun değerini 32 bit imzalı tamsayı olarak alır. |
| GetInt64(Int32) |
Belirtilen sütunun değerini 64 bit imzalı tamsayı olarak alır. |
| GetLifetimeService() |
Geçersiz.
Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject) |
| GetName(Int32) |
Belirtilen sütunun adını alır. |
| GetOrdinal(String) |
Sütunun adı verilen sıra sütununu alır. |
| GetProviderSpecificFieldType(Int32) |
Belirtilen sütunun sağlayıcıya özgü türünü alır. (Devralındığı yer: DbDataReader) |
| GetProviderSpecificValue(Int32) |
Belirtilen sütunun değerini sağlayıcıya özgü bir türün örneği olarak alır. (Devralındığı yer: DbDataReader) |
| GetProviderSpecificValues(Object[]) |
Geçerli satır için koleksiyondaki sağlayıcıya özgü tüm öznitelik sütunlarını alır. (Devralındığı yer: DbDataReader) |
| GetSchemaTable() |
sütun meta verilerini OleDbDataReaderaçıklayan bir DataTable döndürür. |
| GetStream(Int32) |
Belirtilen sütundan veri almak için bir akış alır. (Devralındığı yer: DbDataReader) |
| GetString(Int32) |
Belirtilen sütunun değerini dize olarak alır. |
| GetTextReader(Int32) |
Sütundan veri almak için bir metin okuyucu alır. (Devralındığı yer: DbDataReader) |
| GetTimeSpan(Int32) |
Belirtilen sütunun değerini nesne TimeSpan olarak alır. |
| GetType() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| GetValue(Int32) |
Belirtilen sıradaki sütunun değerini yerel biçiminde alır. |
| GetValues(Object[]) |
Bir nesne dizisini geçerli satırın sütun değerleriyle doldurur. |
| InitializeLifetimeService() |
Geçersiz.
Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject) |
| IsDBNull(Int32) |
Sütunun var olmayan veya eksik değerler içerip içermediğini gösteren bir değer alır. |
| IsDBNullAsync(Int32, CancellationToken) |
Zaman uyumsuz olarak, sütunun var olmayan veya eksik değerler içerdiğini belirten bir değer alır. (Devralındığı yer: DbDataReader) |
| IsDBNullAsync(Int32) |
Zaman uyumsuz olarak, sütunun var olmayan veya eksik değerler içerdiğini belirten bir değer alır. (Devralındığı yer: DbDataReader) |
| MemberwiseClone() |
Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object) |
| MemberwiseClone(Boolean) |
Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject) |
| NextResult() |
Batch SQL deyimlerinin sonuçlarını okurken veri okuyucuyu sonraki sonuca ilerler. |
| NextResultAsync() |
Bir grup deyimin sonuçlarını okurken okuyucuyu zaman uyumsuz olarak sonraki sonuca ilerler. (Devralındığı yer: DbDataReader) |
| NextResultAsync(CancellationToken) |
Bir grup deyimin sonuçlarını okurken okuyucuyu zaman uyumsuz olarak sonraki sonuca ilerler. (Devralındığı yer: DbDataReader) |
| Read() |
öğesini OleDbDataReader sonraki kayda ilerler. |
| ReadAsync() |
Okuyucuyu zaman uyumsuz olarak sonuç kümesindeki bir sonraki kayda ilerler. (Devralındığı yer: DbDataReader) |
| ReadAsync(CancellationToken) |
Okuyucuyu zaman uyumsuz olarak sonuç kümesindeki bir sonraki kayda ilerler. (Devralındığı yer: DbDataReader) |
| ToString() |
Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object) |
Belirtik Arabirim Kullanımları
| Name | Description |
|---|---|
| IDataRecord.GetData(Int32) |
Belirtilen sütun sıralı için bir IDataReader döndürür. |
| IDataRecord.GetData(Int32) |
Bu üyenin açıklaması için bkz GetData(Int32). . (Devralındığı yer: DbDataReader) |
| IDisposable.Dispose() |
Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir. Sınıfının geçerli örneği OleDbDataReader tarafından kullanılan kaynakları serbest bırakır. |
| IEnumerable.GetEnumerator() |
Bir koleksiyonda yineleyen bir numaralandırıcı döndürür. |
Uzantı Metotları
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Sorgunun paralelleştirilmesini etkinleştirir. |
| AsQueryable(IEnumerable) |
bir IEnumerable öğesine IQueryabledönüştürür. |
| CanGetColumnSchema(DbDataReader) |
Sütun şemasını DbDataReader alıp alamayacağını gösteren bir değer alır. |
| Cast<TResult>(IEnumerable) |
öğesinin IEnumerable öğelerini belirtilen türe yazar. |
| GetColumnSchema(DbDataReader) |
bir DbDataReaderiçin sütun şemasını (DbColumnkoleksiyon) alır. |
| OfType<TResult>(IEnumerable) |
Belirtilen türe göre bir IEnumerable öğesinin öğelerini filtreler. |