for xml yan tümcesi temel sözdizimi

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

Önemli
xmldata Direktif for xml seçeneği kullanımı önerilmemektedir. xsd üretimi, raw ve auto modu kullanın. xmldata yönergesi EXPLICT modunda hiçbir değişiklik yoktur. 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ümesinde genel bir tanımlayıcıya sahip bir xml öğesi dönüştüren <satır />, öğe etiketi gibi. Bu yönergeyi kullanırken isteğe bağlı satır öğesi için bir ad belirtebilirsiniz. Sonuç xml belirtilen kullanacağı ElementName üretilen her satır için satır öğesi. Daha fazla bilgi için, bkz. for xml ile ham modunu kullanın.

• AUTO
  Basit, iç içe xml ağacını döndürür sorgu sonuçlarında. Her tablo için en az bir sütunu select yan tümcesinde listelenen from yan tümcesinde bir xml öğesi olarak gösterilir. select yan tümcesinde listelenen sütunlar uygun öğe öznitelikleri eşleştirilir. Daha fazla bilgi için, bkz. for xml ile ham modunu kullanın.

• AÇIK
  Sonuç xml ağacını şeklini açıkça tanımlandığını belirtir. Yerleştirme hakkında istediğiniz ek bilgileri açıkça belirtilen şekilde bu modu kullanarak, sorguları belirli bir şekilde yazılmalıdır. Daha fazla bilgi için, bkz. Kullanımı ile for xml Açık modu.

• YOLU
  Öğeler ve öznitelikler karıştırmak ve karmaşık özellikler gösteren ek yerleştirme tanıtmak için basit bir yol sağlar. Bu tür bir xml gelen bir satır kümesi oluşturmak için for xml Açık modu sorguları kullanabilirsiniz, ancak path modu muhtemelen hantal Açık modu sorguları daha kolay bir alternatif sağlar. path modu, iç içe for xml sorgular ve dönmek için type yönergesi yazabilme yeteneği ile birlikte xml yazın örnekleri ile daha az karmaşık sorgular yazmak için izin verir. Bunun en açık modu sorguları yazma bir alternatif sağlar. path modu varsayılan olarak oluşturduğu bir <satır> öğesi sarıcı sonuç kümesindeki her satır için. İsteğe bağlı olarak bir öğe adı belirtebilirsiniz. Bunu yaparsanız, belirtilen ad sarmalayıcı öğe adı olarak kullanılır. Boş bir dize (for xml path ('')) sağlarsanız, hiçbir wrapper eleman oluşturulur. Daha fazla bilgi için, bkz. for xml ile ham modunu kullanın.

• XMLDATA
  Satır içi xml-Data Reduced (xdr) şema döndürülmelidir belirtir. Şemayı belgeye bir satır içi şema isminin önüne getirilir. Çalışma örnek için bkz: for xml ile ham modunu kullanın.

• XMLSCHEMA
  Satır içi W3C xml şema (xsd) döndürür. İsteğe bağlı olarak, hedef ad alanı URI bu yönerge belirtirken de belirtebilirsiniz. Bu şemada belirtilen ad alanını döndürür. Daha fazla bilgi için, bkz. Satır içi xsd şeması oluştur. Çalışma örnek için bkz: for xml ile ham modunu kullanın.

• ÖĞELERİ
  Öğeleri seçeneği belirtilirse, sütunların alt öğeleri döndürülür. Aksi durumda, xml öznitelikleri için eşleştirilir. Bu seçenek yalnızca raw, auto ve yol modları desteklenir. Bu yönergeyi kullanırken XSINIL ya da absent isteğe bağlı olarak belirtebilirsiniz. XSINIL belirtir bir öğesi olan bir xsi: Nil özniteliği True olarak ayarlanmış boş sütun değerleri için oluşturulabilir. Varsayılan veya ne zaman absent elemanları ile birlikte belirtilen, herhangi bir öğe null değerleri için oluşturulur. Çalışma örnek için bkz: for xml ile ham modunu kullanınve for xml ile ham modunu kullanın.

• BINARY BASE64
  BINARY Base64 seçeneği belirtilirse, sorgu tarafından döndürülen herhangi bir ikili veri Base64 ile kodlanmış biçiminde temsil edilir. raw ve Açık modu kullanarak ikili veri almak için bu seçeneği belirtilmelidir. auto modunda ikili veri, varsayılan olarak referans olarak döndürülür. Çalışma örnek için bkz: for xml ile ham modunu kullanın.

• TÜRÜ
  Sorgu sonuçları verir belirtir xml türü. Daha fazla bilgi için, bkz. TÜR Direktif for xml sorguları.

• KÖK [('RootName')]
  Bir tek, üst düzey öğesi için sonuç xml ekleneceğini belirtir. İsteğe bağlı olarak üretmek için kök öğe adı belirtebilirsiniz. "Kök" varsayılan değerdir.

Ayrıca bkz.

Başvuru

for xml ile ham modunu kullanın

for xml ile ham modunu kullanın

Kullanımı ile for xml Açık modu

select (Transact-sql)

xml (SQL Server)

Kavramlar

for xml ile ham modunu kullanın