Where Tümcesi (Visual Basic)

Bir sorgu için filtre koşulu belirtir.

Where condition

Bölümleri

  • condition
    Gerekli.Değerleri toplama geçerli madde için çıkış koleksiyonunda eklenip eklenmeyeceğini belirleyen ifade.İfade değerlendirme yapmalıdır bir Boolean değeri veya eşdeğeri bir Boolean değeri.Koşul olarak değerlendirilirse True, sorgu sonucunda; öğesi eklenir Aksi durumda, öğe sorgu sonuç çıkarılır.

Notlar

Where Yan tümcesi yalnızca belirli ölçütlere uyan öğeleri seçerek sorgu verileri süzmek etkinleştirir.Öğelerin değerlerini neden Where için değerlendirmek için yan True sorgu sonucu; dahil diğer öğeleri dışarıda bırakılır.Kullanılan ifade bir Where yan tümcesi gerekir değerlendirmek için bir Boolean ya da eşdeğeri bir Boolean, değerlendiren bir tamsayı gibi False değeri sıfır olduğunda.Birden çok ifadelerde birleştirebilirsiniz bir Where gibi mantıksal işleçler kullanarak yan tümcesi And, Or, AndAlso, OrElse, Is, ve IsNot.

Bunlar kadar varsayılan olarak, sorgu ifadeler değerlendirilmez — Örneğin, olduklarında veriye bağlı veya içinde aracılığıyla iterated bir For döngü.Sonuç olarak, Where yan tümcesi sorgunun erişilen kadar değil değerlendirildi.Değerleri, kullanılan sorgu için dış olup olmadığını Where yan tümcesi, uygun değeri içinde kullanıldığından emin olmak Where sorgu yürütüldüğünde zaman yan tümcesi.Sorgu yürütme hakkında daha fazla bilgi için bkz: İlk LINQ Sorgunuzu Yazma (Visual Basic).

İşlevlerinde çağırabileceğiniz bir Where koleksiyonunda geçerli öğeden bir hesaplama veya bir değer üzerinde işlem gerçekleştirmek için yan tümcesi.Bir işlev çağırarak bir Where yan tümcesi erişildiğinde, ne zaman yerine tanımlanmış olduğu hemen çalıştırılacak sorgu neden olabilir.Sorgu yürütme hakkında daha fazla bilgi için bkz: İlk LINQ Sorgunuzu Yazma (Visual Basic).

Örnek

Aşağıdaki sorgu ifadesi kullanan bir From aralık değişkeni bildirmek için yan cust her Customer , nesne customers koleksiyonu.Where Yan tümcesi belirtilen bölgesinden gelen müşterilere çıktı kısıtlamak için aralık değişkeni kullanır.For Each Döngü, sorgu sonucunda her müşteri için şirket adını görüntüler.

Sub DisplayCustomersForRegion(ByVal customers As List(Of Customer),
                              ByVal region As String)

  Dim customersForRegion = From cust In customers
                           Where cust.Region = region

  For Each cust In customersForRegion
    Console.WriteLine(cust.CompanyName)
  Next 
End Sub

Aşağıdaki örnek And ve Or mantıksal işleçleri Where yan tümcesi.

Private Sub DisplayElements()
    Dim elements As List(Of Element) = BuildList()

    ' Get a list of elements that have an atomic number from 12 to 14, 
    ' or that have a name that ends in "r". 
    Dim subset = From theElement In elements
        Where (theElement.AtomicNumber >= 12 And theElement.AtomicNumber < 15) _
        Or theElement.Name.EndsWith("r")
        Order By theElement.Name

    For Each theElement In subset
        Console.WriteLine(theElement.Name & " " & theElement.AtomicNumber)
    Next 

    ' Output: 
    '  Aluminum 13 
    '  Magnesium 12 
    '  Silicon 14 
    '  Sulfur 16 
End Sub 

Private Function BuildList() As List(Of Element)
    Return New List(Of Element) From
        {
            {New Element With {.Name = "Sodium", .AtomicNumber = 11}},
            {New Element With {.Name = "Magnesium", .AtomicNumber = 12}},
            {New Element With {.Name = "Aluminum", .AtomicNumber = 13}},
            {New Element With {.Name = "Silicon", .AtomicNumber = 14}},
            {New Element With {.Name = "Phosphorous", .AtomicNumber = 15}},
            {New Element With {.Name = "Sulfur", .AtomicNumber = 16}}
        }
End Function 

Public Class Element
    Public Property Name As String 
    Public Property AtomicNumber As Integer 
End Class

Ayrıca bkz.

Başvuru

From Tümcesi (Visual Basic)

Select Tümcesi (Visual Basic)

For Each...Next Deyimi (Visual Basic)

Kavramlar

Visual Basic'de LINQ'e Giriş

Diğer Kaynaklar

Sorgular (Visual Basic)