Funkce Tvůrce sestav – první funkce ve stránkované sestavě (Tvůrce sestav)

Platí pro: Microsoft Report Builder (SSRS) Power BI Report Builder Návrhář sestav v nástrojích SQL Server Data Tools

Vrátí první hodnotu v daném oboru zadaného výrazu ve stránkované sestavě.

Poznámka:

Soubory definice stránkované sestavy (.rdl) můžete vytvářet a upravovat v Microsoft Report Builderu, Tvůrci sestav Power BI a v Návrháři sestav v nástrojích SQL Server Data Tools.

Syntaxe

  
First(expression, scope)  

Parametry

expression
(Varianta nebo Binární) Výraz, na kterém se má agregace provést, například=Fields!FieldName.Value.

rozsah
(Řetězec) Volitelný. Název datové sady, skupiny nebo oblasti dat, která obsahuje položky sestavy, na které se má agregační funkce použít. Pokud není zadaný obor , použije se aktuální obor.

Návratový typ

Je určeno typem výrazu.

Poznámky

První funkce vrátí první hodnotu v sadě dat po použití veškerého řazení a filtrování v zadaném oboru.

První funkci nelze použít ve výrazech filtru skupin s čímkoli kromě aktuálního (výchozího) oboru.

Prvek First můžete také použít v záhlaví stránky k návratu první hodnoty z kolekce ReportItems pro stránku, aby se vytvořily nadpisy ve stylu slovníku, které zobrazují první a poslední položky na stránce.

Hodnota oboru musí být řetězcová konstanta a nesmí být výrazem. Pro vnější agregace nebo agregace, pro které nejsou zadány další agregace, musí obor odkazovat na aktuální obor nebo obsahující obor. U agregací agregací mohou vnořené agregace určit podřízený obor.

Výraz může obsahovat volání vnořených agregačních funkcí s následujícími výjimkami a podmínkami:

  • Rozsah vnořených agregací musí být stejný jako rozsah vnější agregace nebo musí být v něm obsažen. Pro všechny odlišné obory ve výrazu musí být jeden obor v podřízené relaci se všemi ostatními obory.

  • Obor vnořených agregací nemůže být název datové sady.

  • Výraz nesmí obsahovat funkce First, Last, Previous nebo RunningValue .

  • Výraz nesmí obsahovat vnořené agregace, které určují rekurzivní.

Další informace najdete v tématu Referenční informace o agregačních funkcích (Tvůrce sestav a SSRS) a rozsah výrazů pro součty, agregace a předdefinované kolekce (Tvůrce sestav a SSRS).

Další informace o rekurzivních agregacích najdete v tématu Vytváření rekurzivních skupin hierarchií (Tvůrce sestav a SSRS).

Example

Následující příklad kódu vrátí první číslo výrobku ve Category skupině datové oblasti:

=First(Fields!ProductNumber.Value, "Category")