Udostępnij za pośrednictwem

  • Artykuł

Podstawowa składnia XML dla klauzuli

Tryb dla XML może być surowców, AUTO, JAWNE lub ścieżki.Określa kształt wynikowy XML.

Ważna informacjaWażne:

Dyrektywa XMLDATA XML dla opcji jest niezalecane.Użyj generacji XSD przypadek trybów surowców i AUTO.Nie ma żadnych zastąpienie dyrektywy XMLDATA w trybie EXPLICT.Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Należy unikać stosowania tej funkcji w nowych projektach oraz zaplanować modyfikację aplikacji, w których obecnie jest używana ta funkcja.

Oto podstawowa składnia, opisana w Dla klauzuli 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 kwerendy i przekształca każdy wiersz w zestaw wyników do elementu XML, która ma ogólny identyfikator <wiersz />, jako elementu tag.Opcjonalnie można określić nazwę elementu wiersza podczas korzystania z niniejszej dyrektywy.Wynikowy XML będzie używać określonego ElementName jako element wiersza generowane dla każdego wiersza.Aby uzyskać więcej informacji, zobacz Używanie trybu RAW.

  • AUTOMATYCZNE
    Zwraca wyniki kwerendy w drzewie XML proste, zagnieżdżone.Każda tabela w klauzula FROM, w której znajduje się co najmniej jedną kolumna w klauzula SELECT jest reprezentowana jako XML element.Atrybuty odpowiedniego elementu są mapowane kolumn wymienionych w klauzula SELECT.Aby uzyskać więcej informacji, zobacz Używanie trybu automatycznego.

  • JAWNE
    Określa, że kształt wynikowy drzewo XML jest jawnie zdefiniowana.Korzystając z tego trybu kwerend musi być napisana w określony sposób, dodatkowe informacje na temat zagnieżdżanie jest jawnie określony.Aby uzyskać więcej informacji, zobacz Używanie trybu JAWNE.

  • ŚCIEŻKA
    Zawiera prostszy sposób wymieszać elementów i atrybutów i wprowadzenie dodatkowych zagnieżdżanie odpowiadające właściwości złożonej.DLA XML JAWNE trybu kwerend można używać do konstruowania tego rodzaju XML z zestawu zestaw wierszy, ale tryb ścieżki zapewnia prostsze alternatywą dla kwerend prawdopodobnie kłopotliwa trybu JAWNE.Tryb ścieżki, wraz z możliwością zapisu kwerend zagnieżdżonych dla XML i dyrektywy typu zwraca xml wpisz wystąpień, umożliwia pisanie kwerend z mniejszą złożoność.Zapewnia alternatywę dla pisania kwerend trybu najbardziej JAWNE.Domyślnie tryb ścieżki generuje <wiersz> element otoki dla każdego wiersza zestaw wyników.Opcjonalnie można określić nazwę elementu.Jeśli jednak określona nazwa jest używana jako element otoki.Jeśli ciąg pusty (dla XML ŚCIEŻKA (")), jest generowany nie element otoki.Aby uzyskać więcej informacji, zobacz Używanie trybu ścieżki.

  • XMLDATA
    Określa schemat wbudowany danych XML (XDR) powinny być zwrócone.Schemat jest poprzedzany do dokumentu jako schemat wbudowany.Dla próbki pracy, zobacz Używanie trybu RAW.

  • SCHEMATU XML
    Zwraca wbudowanego schematu W3C XML (XSD).Opcjonalnie można określić miejsce docelowe obszaru nazw URI, określając niniejszej dyrektywy.To zwraca określonego obszaru nazw schematu.Aby uzyskać więcej informacji, zobacz Generowanie schematu wbudowany XSD.Dla próbki pracy, zobacz Używanie trybu RAW.

  • ELEMENTY
    Jeśli określono opcję elementy kolumn są zwracane jako podelementy.W przeciwnym razie są mapowane do atrybutów XML.Ta opcja jest obsługiwana w tylko tryby surowców, automatyczne i ścieżki.Opcjonalnie można określić XSINIL lub ABSENT, korzystając z niniejszej dyrektywy.XSINIL Określa, że element, który ma xsi: nil atrybutu zestaw na wartość True dla wartości NULL kolumna.Domyślne lub gdy określono ABSENT wraz z elementami elementy nie są tworzone dla wartości NULL.Dla próbki pracy, zobacz Używanie trybu RAW i Używanie trybu automatycznego.

  • BINARNE BASE64
    Jeśli określono opcję BINARNE Base64, wszystkie dane binarne zwracanych przez kwerendę jest reprezentowany w algorytmem base64.Aby pobrać dane binarne przy użyciu surowców i tryb JAWNE, ta opcja musi być określona.W trybie AUTOMATYCZNYM dane binarne jest domyślnie zwracane jako odwołanie.Dla próbki pracy, zobacz Używanie trybu RAW.

  • TYP
    Określa, czy kwerenda zwraca wyniki jako xml typu.Aby uzyskać więcej informacji, zobacz Typ dyrektywy w XML dla kwerend.

  • GŁÓWNY [("rootname")]
    Określa, że element najwyższego poziom, pojedyncze dodać do wynikowego pliku XML.Opcjonalnie można określić nazwę elementu głównego do wygenerowania.Wartością domyślną jest "katalog główny".