CoalesceEmpty (MDX)

Boş bir hücre değerini, bir sayı veya dizi olabilecek belirli boş olmayan hücre değerine dönüştürür.

Syntax

  
Numeric syntax  
CoalesceEmpty( Numeric_Expression1 [ ,Numeric_Expression2,...n] )  
  
String syntax  
CoalesceEmpty(String_Expression1 [ ,String_Expression2,...n] )  

Arguments

Numeric_Expression1
Genellikle hücre koordinatlarının çok boyutlu ifadeleri (MDX) olarak bir sayı döndüren geçerli sayısal ifadedir.

Numeric_Expression2
Genellikle belirli bir sayısal değer olan geçerli bir sayısal ifade.

String_Expression1
Genellikle hücre koordinatlarının Çok Boyutlu İfadeler (MDX) ifadesi olan geçerli bir dizi ifadesi ve bir dizi dize döndürür.

String_Expression2
Genellikle belirli bir dizi değeri olan geçerli bir dizi ifadesi, ilk dize ifadesi tarafından döndürülen NULL yerine koyuluyor.

Remarks

Bir veya daha fazla sayısal ifade belirtilirse, CoalesceEmpty fonksiyonu ilk sayısal ifadenin (soldan sağa) sayısal değerini döndürür; bu değer boş olmayan bir değere çözülebilir. Belirtilen sayısal ifadelerden hiçbiri boş olmayan bir değere çözülemiyorsa, fonksiyon boş hücre değerini döndürür. Genellikle, ikinci sayısal ifadenin değeri, birinci sayısal ifadeyle verilen NULL'un yerine getirilen sayısal değerdir.

Bir veya daha fazla dize ifadesi belirtildiğinde, fonksiyon ilk dize ifadesinin (soldan sağa) boş olmayan bir değere çözümlenebilen dize değerini döndürür. Belirtilen dize ifadelerinden hiçbiri boş olmayan bir değere çözülemiyorsa, fonksiyon boş hücre değerini döndürür. Genellikle, ikinci dize ifadesi değerinin değeri, birinci dize ifadesi tarafından döndürülen NULL'un yerine getirilen dize değeridir.

CoalesceEmpty fonksiyonu yalnızca aynı türden değerleri alabilir. Başka bir deyişle, tüm belirtilen değer ifadeleri yalnızca sayısal veri tiplerine veya boş hücre değerine göre değerlendirilmelidir, ya da tüm belirtilen değer ifadeleri dizi veri tiplerine veya boş bir hücre değerine göre değerlendirilmelidir. Bu fonksiyona tek bir çağrı hem sayısal hem de dizi ifadelerini içeremez.

Boş hücreler hakkında daha fazla bilgi için OLE DB dokümantasyonuna bakınız.

Example

Aşağıdaki örnek Adventure Works küpünü sorgulamaktadır. Bu örnek, her ürünün sipariş miktarını ve kategorilere göre sipariş miktarlarının yüzdesini döndürür. CoalesceEmpty fonksiyonu, hesaplanan üyeler biçimlendirilirken null değerlerin sıfır (0) olarak temsil edilmesini sağlar.

WITH   
   MEMBER [Measures].[Order Percent by Category] AS  
   CoalesceEmpty(   
      ([Product].[Product Categories].CurrentMember,  
        Measures.[Order Quantity]) /   
          (  
           Ancestor  
           ( [Product].[Product Categories].CurrentMember,   
             [Product].[Product Categories].[Category]  
           ), Measures.[Order Quantity]  
       ), 0  
   ), FORMAT_STRING='Percent'  
SELECT   
   {Measures.[Order Quantity],  
      [Measures].[Order Percent by Category]} ON COLUMNS,  
{[Product].[Product].Members} ON ROWS  
FROM [Adventure Works]  
WHERE {[Date].[Calendar Year].[Calendar Year].&[2003]}