• Makale

for xml yan tümcesi temel sözdizimi

for xml modu, raw, auto, açık veya yolu olabilir.Bu sonuç xml şeklini belirler.

Önemli notÖnemli

xmldata Direktif for xml seçeneği kaldırılmıştır.xsd kuşak içinde kullanmak durum ham ve otomatik modları.Hiçbir yerini EXPLICT modunda xmldata yönergesi yok.Bu özellik Microsoft SQL Server'ın ilerideki bir sürümünde kaldırılacaktır. Yeni geliştirme işlerinde bu özelliği kullanmaktan kaçının ve bu özelliği kullanmakta olan uygulamalarda değişiklik yapmayı planlayın.

Aşağıda açıklanan temel sözdizimi vardır for yan tümcesi (Transact-sql):

[ FOR { BROWSE | <XML> } ]
<XML> ::=
XML 
    { 
      { RAW [ ('ElementName') ] | AUTO } 
        [ 
           <CommonDirectives> 
           [ , { XMLDATA | XMLSCHEMA [ ('TargetNameSpaceURI') ]} ] 
           [ , ELEMENTS [ XSINIL | ABSENT ] 
        ]
      | EXPLICIT 
        [ 
           <CommonDirectives> 
           [ , XMLDATA ] 
        ]
      | PATH [ ('ElementName') ] 
        [ 
           <CommonDirectives> 
           [ , ELEMENTS [ XSINIL | ABSENT ] ]
        ]
     } 
 
 <CommonDirectives> ::= 
   [ , BINARY BASE64 ]
   [ , TYPE ]
   [ , ROOT [ ('RootName') ] ]

Bağımsız değişkenler

  • raw [('elementname')]
    Sorgu sonucu alır ve her satır sonuç küme bir genel tanımlayıcı sahip bir xml öğesi dönüştüren <satır />, öğe etiket.İsteğe bağlı olarak bu yönerge kullandığınızda, satır öğesi için bir ad belirtebilirsiniz.Sonuç xml belirtilen kullanma ElementName üretilen her satır için satır öğesi olarak.Daha fazla bilgi için bkz: raw modu kullanılarak.

  • OTOMATİK
    xml basit, Ýç Ýçe Geçmiþ ağacına sorgu sonuçlar döndürür.Her tablo için hangi en az bir from yan tümce tümce tümcende sütun listelenen select yan tümce tümce tümce bir xml öğesi olarak temsil edilir.select yan tümce tümce tümcesinde listelenen sütunlar için uygun öğe özniteliklerinin eşleştirilir.Daha fazla bilgi için bkz: Otomatik mod kullanarak.

  • AÇIK
    Sonuç xml ağacını şeklini açıkça tanımlandığını belirtir.İç içe geçmiş hakkında istediğiniz ek bilgileri açıkça belirtilen şekilde bu modu kullanarak, sorguları belirli bir şekilde yazılmış olması gerekir.Daha fazla bilgi için bkz: AÇIK modu kullanılarak.

  • YOL
    Öğeler ve öznitelikler karıştırmak ve karmaşık özelliklerini göstermek için ek iç içe tanıtmak için daha basit bir yol sağlar.Bu tür bir xml gelen bir satır kümesi oluşturmak için xml açık modu sorguları kullanabilirsiniz, ancak yolu modu büyük olasılıkla hantal açık modu sorguları için daha kolay bir alternatif sağlar.path modu, iç içe for xml sorgular ve geri dönmek için type yönergesi yazabilme yeteneği ile birlikte xml ile daha az karmaşık sorguları yazmak için örnekler, yazın.Bunun en açık modu sorguları yazmak için bir alternatif sağlar.path modu varsayılan olarak oluşturduğu bir <satır> öğesi sarıcı her satır sonuç küme.İsteğe bağlı olarak bir öğe adı belirtebilirsiniz.Bunu yaparsanız, belirtilen adı kaydırma öğesi adı kullanılır.Boş bir dize (for xml path ('')) sağlarsanız, hiçbir kapsayıcı öğe oluşturulur.Daha fazla bilgi için bkz: path modu kullanılarak.

  • XMLDATA
    Satır içi xml-Data Reduced (xdr) şema döndürülen olduğunu belirtir.Şema satır içi şema belgeye yerleştirilir.Çalışma örnek için bkz: raw modu kullanılarak.

  • XMLSCHEMA
    Satır içi W3C xml şema (xsd) döndürür.Bir hedef ad alanı URI isteğe bağlı olarak bu yönerge belirtirken de belirtebilirsiniz.Belirtilen ad alanı bu şemada döndürür.Daha fazla bilgi için bkz: Satır içi xsd şeması oluşturma.Çalışma örnek için bkz: raw modu kullanılarak.

  • ÖĞELERİ
    ÖĞELERİ seçeneği belirtilirse, sütunların alt öğeler olarak döndürülür.Aksi halde, bunlar için xml öznitelikleri eşleştirilir.Bu seçenek, raw, otomatik ve yol modlarda yalnızca desteklenir.Bu yönergeyi kullanın, isteğe bağlı olarak XSINIL ya da absent belirtebilirsiniz.XSINIL belirtir bir öğesi olan bir xsi: nil öznitelik küme null için sütun değerlerini doğru oluşturulacak.Varsayılan veya öğeleri ile birlikte absent ne zaman belirtilen tarafından herhangi bir öğe null değerleri için oluşturulur.Çalışma örnek için bkz: raw modu kullanılarak ve Otomatik mod kullanarak.

  • İKİLİ BASE64
    İKİLİ Base64 seçeneği belirtilirse, sorgu tarafından döndürülen herhangi bir ikili veri base64 ile kodlanmış biçiminde temsil edilir.Ham ve açık modu kullanarak ikili veri almak için bu seçeneğin belirtilmesi gerekir.Otomatik modda ikili veri, varsayılan olarak bir referans olarak döndürülür.Çalışma örnek için bkz: raw modu kullanılarak.

  • TÜRÜ
    Sorgu sonuçlar döndüren belirtir xml türü.Daha fazla bilgi için bkz: for xml sorgu türü yönergesi.

  • KÖK [('Kök adı')]
    Sonuç xml için tek ve en üst düzey öğesi ekleneceğini belirtir.Kök öğe adı oluşturmak için isteğe bağlı olarak belirtebilirsiniz."Kök" varsayılan değerdir.