Aracılığıyla paylaş

  • Makale

FOR XML yan tümcesinin temel sözdizimi

FOR XML modu, RAW, AUTO, EXPLICIT veya yol olabilir.Bu sonuç XML şeklini belirler.

Important noteImportant Note:

FOR XML seçeneği XMLDATA yönergesini önerilmiyor.XSD oluşturma RAW ve AUTO modları olması durumunda, Ek Yardım düğmesini kullanın.EXPLICT modunda XMLDATA yönergesi için hiçbir değişiklik yok.This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

Aşağıda açıklanan temel sözdizimi vardırİçin yan tümce (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ın sonuç dönüştüren küme genel bir tanımlayıcı içeren bir XML öğesi olarak<satır />, öğe etiket.Bu yönerge kullandığınızda, isteğe bağlı satır öğesi için bir ad belirtebilirsiniz.Oluşturulan XML belirtilen kullanacakElementName oluşturulan her satırda. için satır öğesi olarak Daha fazla bilgi için bkz: RAW modunu kullanma.

  • OTOMATİK
    Basit, iç içe geçmiş XML ağacı içinde sorgu sonuçlar döndürür.Her tablonun en az bir sütun SELECT yan tümcesinde listelenen FROM yan tümce, bir XML öğesi olarak gösterilir.SELECT yan tümcesinde listelenen sütunlar, uygun bir öğe öznitelikleri eşleştirilir.Daha fazla bilgi için bkz: OTOMATIK mod kullanma.

  • AÇIK
    Sonuç XML ağacının şeklini açıkça tanımlanmış belirtir.İstediğiniz ek bilgiler iç içe açıkça belirtilen şekilde bu modu kullanarak, sorguları belirli bir şekilde yazılmalıdır.Daha fazla bilgi için bkz: AÇıK modunu kullanma.

  • Yol
    Öğeleri ve öznitelikleri karışık ve karmaşık özelliklerini göstermek için ek iç içe tanıtmak için basit bir yol sağlar.Bu tür bir XML arasında satır kümesi kümesi oluşturmak için XML açık modu sorguları kullanabilirsiniz, ancak yol modu açık büyük olasılıkla hantal modu sorguları için daha kolay bir alternatif sağlar.yol modu, iç içe geçmiş XML için sorgular ve türü yönergesi geri dönmek için yazma özelliği ile birlikteXML yazın örnekler verir daha az karmaşıklık. sorguları yazmak için Bunun en açık modu sorguları yazmak için bir alternatif sağlar.yol modu varsayılan olarak oluşturduğu bir<satır>sonucundaki her satır için sarmalayıcı öğe küme.İsteğe bağlı olarak, öğe adını belirtebilirsiniz.Bunu yaparsanız, belirtilen ad kaydırma öğesi adı olarak kullanılır.(FOR XML yol ('')) boş bir dize sağlarsanız, herhangi bir kapsayıcı öğe oluşturulur.Daha fazla bilgi için bkz: yol modunu kullanma.

  • xmldata
    Bir satır içi XML-Data Reduced (XDR) şema verilmesi belirtir.Şema, bir satır içi şema belgeye e.Çalışan bir örnek için bkz: RAW modunu kullanma.

  • XMLSCHEMA
    Satır içi W3C XML şema (XSD) döndürür.Hedef ad alanı URI isteğe bağlı olarak, bu yönerge belirtirken da belirtebilirsiniz.Bu şemada belirtilen ad alanını döndürür.Daha fazla bilgi için bkz: Satır içi XSD şeması oluşturma. Çalışan bir örnek için bkz: RAW modunu kullanma.

  • ÖĞELERİ
    ÖĞELERİ seçeneği belirtilmediği takdirde, sütunları alt öğeleri döndürülür.Aksi halde, bunlar için XML öznitelikleri eşleştirilir.Bu seçenek yalnızca RAW, AUTO ve yol modlarına desteklenir.Bu yönerge kullandığınızda, isteğe bağlı olarak XSINIL veya ABSENT belirtebilirsiniz.XSINIL belirtir bir öğesi olan birxsi: nil özniteliği null sütun değerlerinin. için doğru oluşturulması için Varsayılan veya ABSENT ÖĞELERİYLE birlikte, belirtilen, herhangi bir öğe NULL değerleri oluşturulur.Bir çalışma örneği için bkz:RAW modunu kullanmaveOTOMATIK mod kullanma.

  • İKİLİ BASE64
    İKİLİ Base64 seçenek belirtilmezse, sorgu tarafından döndürülen herhangi bir ikili veri base64 ile kodlanmış biçimde gösterilir.RAW ve açık modu ikili veri almak için bu seçeneğin belirtilmesi gerekir.Otomatik modda ikili veri, varsayılan olarak başvuru olarak döndürülür.Çalışan bir örnek için bkz: RAW modunu kullanma.

  • TÜRÜ
    Sorgu sonuçlar olarak döndüren belirtirXMLtype.Daha fazla bilgi için bkz: TYPE yönergesini FOR XML sorgulardaki.

  • KÖK [(' RootName ')]
    Tek bir üst düzey öğesi için oluşturulan XML ekleneceğini belirtir.Kök öğe adı oluşturmak için isteğe bağlı olarak belirtebilirsiniz."Kök" varsayılan değerdir.