İzlenecek yol: Visual Basic içinde IEnumerable(Of T) uygulama

Makale
02/26/2013

IEnumerable<T> Arabirimi, bir dizi değerleri tek bir öğe bir zaman dönebilirsiniz sınıfları tarafından gerçekleştirilir.Bir defada bir veri öğesi dönmeden avantajı, eksiksiz bir veri kümesi ile çalışmak için belleğe yüklemek gerekmez olmasıdır.Yalnızca tek bir öğe verilerini yüklemek için yeterli bellek kullanmak zorunda.Sınıfları saðlamanýzý IEnumerable(T) arabirimi ile kullanılabilecek For Each döngüleri veya LINQ sorguları.

Örneğin, büyük metin dosyasını okuyun ve her satır belirli arama ölçütleri ile eşleşen dosyadan geri dönmek gerekir bir uygulama göz önünde bulundurun.Uygulama dosyasından belirtilen ölçütlere uyan satırları dönmek için LINQ sorgu kullanır.LINQ sorgusu kullanarak dosyanın içeriğini sorgulamak için uygulama dosyasının içeriğini bir dizi ya da bir koleksiyon yükleyebildi.Ancak, dosyanın tamamını bir dizi veya derlemesi yüklenirken gerekenden çok daha fazla bellek kullanılmasına neden.LINQ yerine dosya içeriğini arama ölçütüyle eşleşen değerleri döndürme sýralanabilir sýnýfýn kullanarak sorgu.Yalnızca birkaç döndüren sorgular eşleşen değerler daha az bellek tüketir.

Uygulayan bir sınıf oluşturabilirsiniz IEnumerable<T> kaynak verisi olarak sýralanabilir verileri göstermek için arabirim.Sınıfınızın uygulayan IEnumerable(T) arabirimini uygulayan başka bir sınıf gereksinim IEnumerator<T> arabirimi kaynak veri yineleme yapmak için.Bu iki sınıf veri öğelerinin belirli bir tür olarak ardışık olarak dönmek etkinleştirin.

Bu izlenecek yolda, uygulayan bir sınıf oluşturur IEnumerable(Of String) arabirimi ve uygulayan bir sınıf IEnumerator(Of String) bir kerede bir metin dosyasına bir satır okuma arabirimi.

[!NOT]

Bilgisayarınızda, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arabirimi öğelerinden bazılarının adı veya konumu farklı gösterilebilir. Bu öğeleri bilgisayarınızdaki Visual Studio sürümü ve kullandığınız ayarlar belirler. Daha fazla bilgi için bkz: Visual Studio ayarları.

Sýralanabilir sýnýfýn oluşturma

Sýralanabilir sýnýfýn proje oluşturmak için

De Visual Basic, Dosya menüsü, Yeni 'ı Proje.
İçinde Yeni bir proje iletişim kutusunda Proje türleri bölmesi, emin olun Windows seçilir.Seçin Class Library , şablonları bölmesi.İçinde ad kutusuna yazın StreamReaderEnumerableve ardından Tamam.Yeni proje görüntülenir.
İçinde Solution Explorer, Class1.vb dosyasını sağ tıklatın ve tıklatın yeniden.Dosyayı yeniden adlandırma StreamReaderEnumerable.vb ve enter tuşuna basın.Dosyayı yeniden adlandırmayı de adını değiştirecek sınıfına StreamReaderEnumerable.Bu sınıf gerçekleştireceksiniz IEnumerable(Of String) arabirimi.
StreamReaderEnumerable proje sağ tıklatın, üzerine Ekleve ardından New Item.Seçin sınıfı şablonu.İçinde ad kutusuna yazın StreamReaderEnumerator.vb 'ı tıklatın ve Tamam.

Bu proje ilk sınıfında sýralanabilir sınıftır ve gerçekleştireceksiniz IEnumerable(Of String) arabirimi.Bu genel arabirimini uygulayan IEnumerable arabirimi ve bu sınıfın tüketiciler olarak yazılan değerlerine erişebilirsiniz garanti String.

IEnumerable uygulamak için kodu eklemek için

StreamReaderEnumerable.vb dosyasını açın.
Sonra satırdaki Public Class StreamReaderEnumerable, aşağıdaki komutu yazın ve enter tuşuna basın.
```
Implements IEnumerable(Of String)
```
Visual Basicgerekli olan üyelere sahip sınıf otomatik olarak dolduran IEnumerable(Of String) arabirimi.
Bu sýralanabilir sýnýfýn bir defada bir metin dosyası bir satırından satırları okuyun.Sınıf bir girdi parametresi olarak bir dosya yolu götüren bir public kurucu göstermek için aşağıdaki kodu ekleyin.
```
Private _filePath As String

Public Sub New(ByVal filePath As String)
    _filePath = filePath
End Sub
```
Uygulamanız, GetEnumerator yöntemi, IEnumerable(Of String) arabirimi geri dönün, yeni bir örneğini StreamReaderEnumerator sınıfı.Uygulaması, GetEnumerator yöntemi, IEnumerable arabirimi atölyeye Private, yalnızca üyeleri tarafından ele geçirilmesini olduğundan IEnumerable(Of String) arabirimi.Kod değiştirme, Visual Basic için üretilen GetEnumerator yöntemleri yerine aşağıdaki kodu.
```
Public Function GetEnumerator() As IEnumerator(Of String) _
    Implements IEnumerable(Of String).GetEnumerator

    Return New StreamReaderEnumerator(_filePath)
End Function

Private Function GetEnumerator1() As IEnumerator _
    Implements IEnumerable.GetEnumerator

    Return Me.GetEnumerator()
End Function
```

IEnumerator uygulamak için kodu eklemek için

StreamReaderEnumerator.vb dosyasını açın.
Sonra satırdaki Public Class StreamReaderEnumerator, aşağıdaki komutu yazın ve enter tuşuna basın.
```
Implements IEnumerator(Of String)
```
Visual Basicgerekli olan üyelere sahip sınıf otomatik olarak dolduran IEnumerator(Of String) arabirimi.
Numaralayıcı sınıfı, metin dosyasını açar ve dosya g/Ç satırlar dosyadan okumak için gerçekleştirir.Sınıf bir girdi parametresi olarak bir dosya yolu götüren bir public kurucu ve metin dosyasını okumak için şu kodu ekleyin.
```
Private _sr As IO.StreamReader

Public Sub New(ByVal filePath As String)
    _sr = New IO.StreamReader(filePath)
End Sub
```

Current Özellikler her ikisi için de IEnumerator(Of String) ve IEnumerator arabirimleri metin dosyasından geçerli öğeyi döndürmek bir String.Uygulaması, Current özelliği IEnumerator arabirimi atölyeye Private, yalnızca üyeleri tarafından ele geçirilmesini olduğundan IEnumerator(Of String) arabirimi.Kod değiştirme, Visual Basic için üretilen Current özellikleri aşağıdaki kod ile.

Private _current As String

Public ReadOnly Property Current() As String _
    Implements IEnumerator(Of String).Current

    Get
        If _sr Is Nothing OrElse _current Is Nothing Then
            Throw New InvalidOperationException()
        End If

        Return _current
    End Get
End Property

Private ReadOnly Property Current1() As Object _
    Implements IEnumerator.Current

    Get
        Return Me.Current
    End Get
End Property

MoveNext Yöntemi, IEnumerator arabirimi metin dosyasındaki bir sonraki öğeye gider ve tarafından döndürülen değeri güncelleştirmeleri Current özelliği.Okumak için daha fazla öğe varsa MoveNext yöntemi döndürür False; Aksi halde MoveNext yöntemi döndürür True.Aşağıdaki kodu MoveNext yöntemine ekleyin.
```
Public Function MoveNext() As Boolean _
    Implements System.Collections.IEnumerator.MoveNext

    _current = _sr.ReadLine()
    If _current Is Nothing Then Return False
    Return True
End Function
```

Reset Yöntemi, IEnumerator arabirimi Yineleyici metin dosyasının başlangıcını işaret edecek şekilde yönlendirir ve geçerli öğe değerini siler.Aşağıdaki kodu Reset yöntemine ekleyin.

Public Sub Reset() _
    Implements System.Collections.IEnumerator.Reset

    _sr.DiscardBufferedData()
    _sr.BaseStream.Seek(0, IO.SeekOrigin.Begin)
    _current = Nothing
End Sub

Dispose Yöntemi, IEnumerator arabirimi garanti Yineleyici edilmeden yönetilmeyen tüm kaynaklar serbest bırakılır.Tarafından kullanılan dosya tanıtıcısı StreamReader nesnesi bir yönetilmeyen kaynağın ve Yineleyici örneği edilmeden kapatılmalıdır.Kod değiştirme, Visual Basic için üretilen Dispose yöntemi şu kodu ile.

Private disposedValue As Boolean = False

Protected Overridable Sub Dispose(ByVal disposing As Boolean)
    If Not Me.disposedValue Then
        If disposing Then
            ' Dispose of managed resources.
        End If
        _current = Nothing
        _sr.Close()
        _sr.Dispose()
    End If

    Me.disposedValue = True
End Sub

Public Sub Dispose() Implements IDisposable.Dispose
    Dispose(True)
    GC.SuppressFinalize(Me)
End Sub

Protected Overrides Sub Finalize()
    Dispose(False)
End Sub

Örnek yineleyici kullanarak

Sýralanabilir sýnýfýn kodunuzda uygulayan bir nesne gerektiren denetim yapıları ile birlikte kullanabileceğiniz IEnumerable, gibi bir For Next döngü ya da bir LINQ sorgusu.Aşağıdaki örnekte gösterildiği StreamReaderEnumerable LINQ sorgu.

Dim adminRequests = 
    From line In New StreamReaderEnumerable("..\..\log.txt")
    Where line.Contains("admin.aspx 401")

Dim results = adminRequests.ToList()

Ayrıca bkz.

Aracılığıyla paylaş

İzlenecek yol: Visual Basic içinde IEnumerable(Of T) uygulama

Sýralanabilir sýnýfýn oluşturma

Örnek yineleyici kullanarak

Ayrıca bkz.

Başvuru

Kavramlar

Diğer Kaynaklar

Ek kaynaklar