Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
JDBC-drivrutinen ger stöd för JDBC 4.0-API:et, som introducerar gränssnittet java.sql.SQLXML. SQLXML-gränssnittet definierar metoder för att interagera och manipulera XML-data. SQLXML-datatypen mappar tillSQL Server xml-datatypen.
SQLXML-gränssnittet innehåller metoder för att komma åt XML-värdet som en sträng, en läsare eller skrivare eller som en ström. XML-värdet kan också nås via en källa eller anges som ett resultat, som används med XML-parsnings-API:er som DOCUMENT Object Model (DOM), Simple API for XML (SAX) och Streaming API for XML (StAX), samt med XSLT-transformeringar och XPath.
Anmärkningar
I följande tabell beskrivs de metoder som definierats i SQLXML-gränssnittet:
| Metodsyntax | Metodbeskrivning |
|---|---|
| void free() | Den här metoden frigör SQLXML-objektet och släpper de resurser som det innehåller. |
| InputStream getBinaryStream() | Returnerar en indataström för att läsa data från SQLXML. |
| Reader getCharacterStream() | Returnerar XML-data som ett java.io.Reader-objekt eller som en dataström med tecken. |
| T utökar Source T getSource(Class<T> sourceClass) | Returnerar en källa för att läsa det XML-värde som anges av det här SQLXML-objektet . Observera: Metoden getSource stöder följande källor: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource och java.io.InputStream. |
| String getString() | Returnerar en strängrepresentation av XML-värdet som anges av det här SQLXML-objektet. |
| OutputStream setBinaryStream() | Hämtar en dataström som kan användas för att skriva det XML-värde som det här SQLXML-objektet representerar. |
| Writer setCharacterStream() | Returnerar en dataström som ska användas för att skriva det XML-värde som det här SQLXML-objektet representerar. |
| T utökar Resultat T setResult(Class<T> resultClass) | Returnerar ett resultat för att ange det XML-värde som anges av det här SQLXML-objektet . Observera: Metoden setResult stöder följande källor: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult och java.io.OutputStream. |
| void setString(Strängvärde) | Anger det XML-värde som anges av det här SQLXML-objektet till den angivna strängrepresentationen. |
Programmen kan bara läsa och skriva XML-värden till eller från ett SQLXML-objekt en gång.
När metoden free() anropas blir ett SQLXML-objekt ogiltigt och kan varken läsas eller skrivas. Om programmet försöker anropa en metod för det SQLXML-objektet förutom metoden free() genereras ett undantag.
SQLXML-objektet blir varken läsbart eller skrivbart när programmet anropar någon av följande gettermetoder: getSource, getCharacterStream, getBinaryStream och getString.
SQLXML-objektet blir varken skrivbart eller läsbart när programmet anropar någon av följande sättningsmetoder: setResult, setCharacterStream, setBinaryStream och setString.