ReportItems Koleksiyonu Başvuruları (Rapor Oluşturucusu ve SSRS)

Yerleşik ReportItems koleksiyonu, veri bölgesi satırları veya rapor tasarım yüzeyindeki metin kutuları gibi, rapor öğelerindeki metin kutuları kümesidir. ReportItems koleksiyonu, sayfa üstbilgisi, sayfa altbilgisi veya rapor gövdesinin geçerli kapsamındaki metin kutularını içerir. Bu koleksiyon, çalışma zamanında rapor işlemcisi ve rapor işleyicisi tarafından belirlenir. Kullanıcı rapor sayfalarını görüntülediği sırada, rapor işlemcisi rapor verilerini ve rapor öğesi düzen bileşenlerini art arda birleştirirken geçerli kapsam değişir. Her sayfadaki ilk ve son öğeleri gösteren sözlük stili sayfa üstbilgileri üretmek için yerleşik ReportItems koleksiyonunu kullanabilirsiniz.

[!NOT]

SQL Server Data Tools'daki Rapor Oluşturucusu ve Rapor Tasarımcısı ile rapor tanımları (.rdl) oluşturabilir ve bunları değiştirebilirsiniz. Her yazma ortamı raporları ve ilişkili öğeleri oluşturmak, açmak ve kaydetmek için farklı yollar sağlar. Daha fazla bilgi için, Web'de microsoft.com sitesinde Rapor Tasarımcısı'nda ve Oluşturucusu'nda Rapor Tasarlama makalesine bakın.

ReportItems Value Özelliğini Kullanma

ReportItems koleksiyonundaki öğelerin yalnızca bir özelliği vardır: Value. ReportItems öğesinin değeri, rapordaki başka bir alandaki verileri görüntülemek veya hesaplamak için kullanılabilir. Geçerli metin kutusunun değerine erişmek için, Visual Basic yerleşik genel özellik Me.Value'yu veya yalnızca Value'yu kullanabilirsiniz. First gibi rapor işlevlerinde ve toplama işlevlerinde, tam nitelikli sözdizimini kullanın.

Örneğin:

• Metin kutusuna yerleştirilen bu ifade, Textbox1 adlı ReportItem metin kutusunun değerini görüntüler:

  =ReportItems!Textbox1.Value

• ReportItem metin kutusu Color özelliğine yerleştirilen bu ifade, değer > 0 olduğunda metni siyah görüntüler; aksi durumda değer kırmızı görüntülenir:

  =IIF(Me.Value > 0,"Black","Red")

• Sayfa üstbilgisindeki veya altbilgisindeki metin kutusuna yerleştirilen bu ifade, LastName adlı metin kutusu için işlenen raporun her sayfasındaki ilk değeri görüntüler:

  =First(ReportItems("LastName").Value)

Sözlük Stili Sayfa Üstbilgisi İfadeleri

Sayfadaki ilk müşteriyi ve son müşteriyi görüntülemek için sayfa üstbilgisi oluşturabilirsiniz. Sayfa üstbilgisindeki metin kutusu ReportItems yerleşik koleksiyonuna ifade içinde yalnızca bir kez başvuruda bulunabildiği için, sayfa üstbilgisine iki metin kutusu eklemeniz gerekir: biri birinci müşterinin adı (=First(ReportItems!textboxLastName.Value), diğeri de sonuncu müşterinin adı (=Last(ReportItems!textboxLastName.Value) için.

Sayfa üstbilgi veya altbilgi bölümünde, yalnızca geçerli sayfadaki metin kutuları ReportItems koleksiyonunun üyesi olarak kullanılabilir. Örneğin, ReportItems!textboxLastName.Value, çok sayfalı veri bölgesinin yalnızca ilk sayfasında görünen bir metin kutusuna başvuruda bulunuyorsa, ilk sayfa için bir değer görürsünüz, ancak diğer tüm sayfalar, ifadenin yazıldığı şekilde hesaplanamadığını gösteren #Hata iletisini görüntüler.

ReportItems Koleksiyonunun Kapsamı

Rapor işlenirken, rapor gövdesindeki veya veri bölgesindeki her metin kutusu kendi veri kümesi, veri bölgesi ve grup ilişkilendirmeleri bağlamında hesaplanır. ReportItems koleksiyonuna yapılan başvurunun kapsamı geçerli kapsamdır veya geçerli kapsamdan yüksek olan herhangi bir noktadır.

Örneğin, üst gruptaki satırda bulunan bir metin kutusu, alt grup satırındaki metin kutusunun adına başvuruda bulunan bir ifade içermemelidir. Alt satır metin kutusu kapsam dışında olduğu için, böyle bir ifade bir değere çözümlenmez. Daha fazla bilgi için, bkz. Toplama İşlevleri Başvurusu (Rapor Oluşturucusu ve SSRS).

Ayrıca bkz.

Başvuru

İfadelerdeki Yerleşik Koleksiyonlar (Rapor Oluşturucusu ve SSRS)

İfade Örnekleri (Rapor Oluşturucusu ve SSRS)

Kavramlar

Reporting Services'da Sayfalandırma (Rapor Oluşturucusu ve SSRS)

Verileri Filtreleme, Gruplandırma ve Sıralama (Rapor Oluşturucusu ve SSRS)