Parametreler Koleksiyonu Başvuruları (Rapor Oluşturucusu ve SSRS)
Rapor parametreleri, ifade içinden başvuruda bulunulabilen yerleşik koleksiyonlardan biridir. İfadeye parametreler ekleyerek, kullanıcının yaptığı seçimlere göre rapor verilerini ve görünümü özelleştirebilirsiniz. İfadeler (Fx) veya <İfade> seçeneğini sağlayan her rapor öğesi özelliği veya metin kutusu özelliği için kullanılabilir. İfadeler aynı zamanda başka yollardan rapor içeriğini ve görünümünü denetlemek için de kullanılır. Daha fazla bilgi için bkz. İfade Örnekleri (Rapor Oluşturucusu ve SSRS).
Parametre değerlerini çalışma zamanında veri kümesi alan değerleriyle karşılaştırdığınızda, karşılaştırdığınız iki öğenin veri türünün aynı olması gerekir. Rapor parametreleri şu türlerden birinde olabilir: Boole, Tarih/Saat, Tamsayı, Kayan veya temeldeki veri türü olan Dize'yi temsil eden Metin. Gerekirse, veri kümesi değeriyle aynı olması için parametre değerinin veri türünü değiştirmek zorunda kalabilirsiniz. Daha fazla bilgi için bkz. İfadelerdeki Veri Türleri (Rapor Oluşturucusu ve SSRS).
İfadeye bir parametre başvurusu eklemek için, parametrenin tek değerli mi yoksa çok değerli mi olduğuna bağlı olarak değişen parametre başvurusu sözdizimini doğru belirtmeyi anlamış olmanız gerekir.
[!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.
İfadede Tek Değerli Parametre Kullanma
Aşağıdaki tablo, bir ifadede herhangi bir veri türünün tek değerli parametresine başvuru eklenirken kullanılacak sözdizimi örneklerini gösterir.
Örnek |
Açıklama |
|---|---|
=Parameters!<ParameterName>.IsMultiValue |
False döndürür. Parametrenin çok değerli olup olmadığını denetler. True ise, parametre çok değerlidir ve bir nesne koleksiyonudur. False ise, parametre tek değerlidir ve tek bir nesnedir. |
=Parameters!<ParameterName>.Count |
1 tamsayı değerini döndürür. Tek değerli parametre için bu sayı her zaman 1'dir. |
=Parameters!<ParameterName>.Label |
Kullanılabilir değerler açılır listesinde sıkça görünen ad olarak kullanılan parametre etiketini döndürür. |
=Parameters!<ParameterName>.Value |
Parametre değerini döndürür. Label özelliği ayarlanmamışsa, bu değer kullanılabilir değerler açılır listesinde görünür. |
=CStr(Parameters! <ParameterName>.Value) |
Parametre değerini dize olarak döndürür. |
=Fields(Parameters!<ParameterName>.Value).Value |
Parametreyle aynı ada sahip alanın değerini döndürür. |
Filtrede parametreler kullanma hakkında daha fazla bilgi için, bkz. Veri Kümesi Filtrelerini, Veri Bölgesi Filtrelerini ve Grup Filtrelerini Ekleme (Rapor Oluşturucusu ve SSRS).
İfadede Çok Değerli Parametre Kullanma
Aşağıdaki tablo, bir ifadede herhangi bir veri türünün çok değerli parametresine başvuru eklenirken kullanılacak sözdizimi örneklerini gösterir.
Örnek |
Açıklama |
|---|---|
=Parameters!<MultivalueParameterName>.IsMultiValue |
True veya False döndürür. Parametrenin çok değerli olup olmadığını denetler. True ise, parametre çok değerlidir ve bir nesne koleksiyonudur. False ise, parametre tek değerlidir ve tek bir nesnedir. |
=Parameters!<MultivalueParameterName>.Count |
Tamsayı değeri döndürür. Değer sayısına başvuruda bulunur. Tek değerli parametre için bu sayı her zaman 1'dir. Çok değerli parametre için bu sayı 0 veya daha büyüktür. |
=Parameters!<MultivalueParameterName>.Value(0) |
Çok değerli bir parametrede birinci değeri döndürür. |
=Parameters!<MultivalueParameterName>.Value(Parameters!<MultivalueParameterName>.Count-1) |
Çok değerli bir parametrede sonuncu değeri döndürür. |
=Split("Value1,Value2,Value3",",") |
Bir değer dizisi döndürür. Çok değerli String parametresi için bir değer dizisi oluşturun. Ayırmak için ikinci parametrede herhangi bir ayırıcıyı kullanabilirsiniz. Bu ifade, çok değerli parametrenin varsayılanlarını ayarlamak veya bir alt rapora ya da detaylandırma raporuna göndermek üzere çok değerli parametre oluşturmak için kullanılabilir. |
=Join(Parameters!<MultivalueParameterName>.Value,", ") |
Çok değerli bir parametrede virgülle ayrılmış değer listesinden oluşan bir String döndürür. Birleştirmek için ikinci parametrede herhangi bir ayırıcıyı kullanabilirsiniz. |
Filtrede parametreler kullanma hakkında daha fazla bilgi için, bkz. Rapor Parametreleri (Rapor Oluşturucusu ve SSRS).
Ayrıca bkz.
Görevler
Rapor Parametresini Ekleme, Değiştirme veya Silme (Rapor Oluşturucusu ve SSRS)
Öğretici: Raporunuza Parametre Ekleme (Rapor Oluşturucusu)
Başvuru
İfadelerdeki Yerleşik Koleksiyonlar (Rapor Oluşturucusu ve SSRS)
Kavramlar
İfadeler (Rapor Oluşturucusu ve SSRS)
Tek Değer ve Birden Fazla Değer İçeren Parametreler (Rapor Oluşturucusu ve SSRS)