Udostępnij przez

Basic Syntax of the FOR XML Clause

Tryb FOR XML może być RAW, AUTO, EXPLICIT lub ścieżka.Określa kształt wynikowy plik XML.

Important noteImportant Note:

Dyrektywa XMLDATA opcji FOR XML została zaniechana.Za pomocą generowania XSD w odniesieniu do trybów RAW i AUTO.Brak dyrektywy XMLDATA w trybie EXPLICT nie zastępuje.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.

Poniżej przedstawiono podstawową składnię, którą opisano w DLA klauzula (języka 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') ] ]

Argumenty

  • RAW [('ElementName')]
    Trwa wyników kwerendy i przekształca każdy wiersz zestaw na element XML, która ma ogólny identyfikator, wyników <wiersz />, jako tag elementu. Opcjonalnie można określić nazwę elementu wiersza, korzystając z tej dyrektywy.Wynikowy plik XML będzie używał określonego ElementName jako element wiersz wygenerowanego dla każdego wiersza.Aby uzyskać więcej informacji zobaczZa pomocą trybu RAW.

  • AUTOMATYCZNE
    Zwraca wyniki kwerendy w prosty i zagnieżdżonych drzewo składni XML.Każda tabela w klauzula FROM, w której znajduje się co najmniej jedną kolumna w klauzula SELECT jest reprezentowana jako XML element.Kolumn wymienionych w klauzula SELECT są mapowane do atrybutów odpowiedni element.Aby uzyskać więcej informacji zobaczW trybie AUTO.

  • JAWNE
    Określa, że kształt wynikowy drzewo składni XML jest jawnie zdefiniowana.Używając w tym trybie kwerendy musi być napisana w określony sposób, tak, aby uzyskać dodatkowe informacje dotyczące zagnieżdżanie mają jest jawnie określony.Aby uzyskać więcej informacji zobaczUsing EXPLICIT Mode.

  • ŚCIEŻKA
    Zawiera prostszy sposób mieszania elementów i atrybutów, a następnie wprowadzenie dodatkowych zagnieżdżanie odpowiadające właściwości złożonej.DO XML JAWNE kwerendy trybu można użyć do utworzenia tego typu XML z zestawu zestaw wierszy, ale trybu ścieżka zawiera prostszy alternatywne w stosunku do kwerendy prawdopodobnie niewygodna trybu JAWNE.Tryb ścieżka, łącznie z możliwością zapisu kwerend zagnieżdżonych FOR XML i dyrektywa funkcja typ zwraca XML wpisz wystąpień, można zapisać kwerendy z mniejszą złożoność.To stanowi alternatywę dla pisania najbardziej JAWNE kwerendy trybu.Domyślnie tryb ścieżka generuje <wiersz> Element otoki dla każdego wiersza zestaw wyników. Opcjonalnie można określić nazwę elementu.W takim wypadku określona nazwa jest używana jako nazwa elementu otoki.Jeśli podano ciąg pusty (FOR XML ścieżka ("")), element otoki nie zostanie wygenerowany.Aby uzyskać więcej informacji zobaczZa pomocą trybu ścieżka.

  • XMLDATA
    Określa, zwracana jest wbudowany schemat zmniejszonej dane XML (XDR).Schemat jest reprezentowana w dokumencie jako schemat wbudowany.Przykładowy pracy zobacz Za pomocą trybu RAW.

  • XMLSCHEMA
    Zwraca wbudowanego schematu W3C XML (XSD).Opcjonalnie można określić docelowego obszaru nazw URI, określając tę dyrektywę.Zwraca wartość określonego obszaru nazw w schemacie.Aby uzyskać więcej informacji zobaczInline XSD Schema Generation.Przykładowy pracy zobacz Za pomocą trybu RAW.

  • ELEMENTY
    Jeśli określono opcję elementów, w kolumnach są zwracane w postaci podelementy.W przeciwnym razie które są mapowane atrybutów XML.Ta opcja jest obsługiwana tylko tryby RAW, AUTO i ścieżka.Opcjonalnie można określić XSINIL lub ABSENT, korzystając z tej dyrektywy.XSINIL Określa, że element, ma xsi: nil atrybut ustawiony na wartość true, można utworzyć dla wartości NULL kolumna.Domyślna lub jeśli ABSENT zostanie użyty razem z elementów elementy nie są tworzone dla wartości NULL.Przykładowy pracy zobacz Za pomocą trybu RAW i W trybie AUTO.

  • BINARNE BASE64
    Jeśli określono opcję przy użyciu algorytmu Base 64 BINARY, wszystkie dane binarne zwracanych przez kwerendę jest reprezentowane w formacie algorytmem Base64.Aby pobrać dane binarne przy użyciu RAW i trybie jawnych, ta opcja musi być określona.W trybie AUTO dane binarne są domyślnie zwracane jako odwołanie.Przykładowy pracy zobacz Za pomocą trybu RAW.

  • TYP
    Określa, czy kwerenda zwraca wyniki, jak XML typu.Aby uzyskać więcej informacji zobaczTYPE Directive in FOR XML Queries.

  • Katalog główny [('RootName')]
    Określa, że element najwyższego poziom, pojedyncze ma być dodany do wynikowego pliku XML.Opcjonalnie można określić nazwy elementu głównego do wygenerowania.Wartością domyślną jest "" katalog główny".

  • Last updated on