Introduzione al provider SQLXMLOLEDB (SQLXML 4.0)

Il provider SQLXMLOLEDB è un provider OLE DB che espone la funzionalità Microsoft SQLXML tramite AdO (ActiveX Data Objects). Tuttavia, il provider può eseguire comandi solo in modalità "scrittura in un flusso di output" di ADO. Il provider SQLXMLOLEDB non è un provider di set di righe. Quando si esegue un comando, è necessario specificare il flag adExecuteStream, che indirizza ADO all'uso del flusso di output specificato.

Nell'esempio seguente viene illustrata la sintassi per il comando Execute in cui è specificato il flag adExecuteStream:

Dim oTestCommand As New ADODB.Command  
...  
oTestCommand.Properties("Output Stream").Value = oTestStream  
oTestCommand.Execute , , adExecuteStream  
...  

Proprietà specifiche del provider SQLXMLOLEDB

Il provider SQLXMLOLEDB espone la proprietà di connessione specifica del provider seguente.

Connessione proprietà	Predefinito (se presenti)	Descrizione
Provider di dati		Fornisce il PROGID del provider OLE DB tramite il quale SQLXMLOLEDB esegue i comandi. A partire da SQLXML 4.0 e SQL Server 2005, questo provider è contenuto all'interno di SQL Server Native Client; pertanto, questo valore della proprietà è limitato a "SQLNCLI11". Per altre informazioni, vedere Programmazione in SQL Server Native Client.

Il provider SQLXMLOLEDB espone le proprietà di comando specifiche del provider seguenti.

Comando proprietà	Predefinito (se presenti)	Descrizione
Percorso di base	""	Specifica il percorso del file di base. Il percorso del file di base viene utilizzato per specificare il percorso dei file XSL (XML Stylesheet Language) o dello schema di mapping. Il percorso del file di base viene usato anche per risolvere i percorsi relativi dei file di schema XSL o di mapping specificati nelle proprietà XSL o Mapping Schema. Per un esempio in cui viene usata questa proprietà, vedere Esecuzione di query XPath (provider SQLXMLOLEDB).
ClientSideXML	Falso	Impostare questa proprietà su True se si desidera che il processo di conversione del set di righe in XML venga eseguito sul client anziché sul server. Ciò è utile quando si vuole spostare il carico delle prestazioni nel livello intermedio. Per un esempio in cui viene usata questa proprietà, vedere Esecuzione di query SQL (provider SQLXMLOLEDB) o esecuzione di modelli che contengono query SQL (provider SQLXMLOLEDB).
Tipo di contenuto		Restituisce il tipo di contenuto di output. Si tratta di una proprietà READ ONLY. Questa proprietà fornisce informazioni al browser sul tipo di contenuto , ad esempio TEXT/XML, TEXT/HTML, image/jpeg e così via. Il valore di questa proprietà diventa il campo content-type inviato al browser come parte dell'intestazione HTTP, che contiene il tipo MIME (Multipurpose Internet Mail Extensions) del documento inviato come corpo.
Mapping Schema	NULLO	Se un'applicazione client esegue una query XPath su uno schema di mapping (XDR o XSD), questa proprietà viene usata per specificare il nome dello schema di mapping. Il percorso specificato può essere relativo (xyz/abc/MySchema.xml) o assoluto (C:\MyFolder\abc\MySchema.xml). Se viene specificato un percorso relativo, viene utilizzato il percorso di base specificato dalla proprietà Base Path per risolvere il percorso relativo. Se nella proprietà Base Path non è stato specificato alcun percorso, il percorso relativo è relativo alla directory corrente. Specificando un valore per la proprietà Schema mapping, è possibile specificare un percorso di directory locale o un URL (http://...). Se si specifica un URL, è necessario configurare WinHTTP per accedere ai server HTTP e HTTPS tramite un server proxy. A tale scopo, eseguire l'utilità Proxycfg.exe. Per altre informazioni, vedere "Uso dell'utilità di configurazione proxy WinHTTP" in MSDN Library. Per un esempio in cui viene usata questa proprietà, vedere Esecuzione di query XPath (provider SQLXMLOLEDB).
spazi dei nomi		Questa proprietà consente l'esecuzione di query XPath che usano spazi dei nomi. Per un esempio in cui viene usata questa proprietà, vedere Esecuzione di query XPath con spazi dei nomi (provider SQLXMLOLEDB).
ss Stream Flags		Questa proprietà viene utilizzata per specificare tipi specifici di restrizioni di sicurezza. Ad esempio, è possibile non consentire riferimenti URL a file o percorsi assoluti ai file ,ad esempio siti esterni. In alternativa, potrebbe non essere necessario consentire query nei modelli. È possibile assegnare alla proprietà questi valori: 1 = STREAM_FLAGS_DISALLOW_URL 2 = STREAM_FLAGS_DISALLOW_ABSOLUTE_PATH 4 = STREAM_FLAGS_DISALLOW_QUERY 8 = STREAM_FLAGS_ DONTCACHEMAPPINGSCHEMA 16 = STREAM_FLAGS_DONTCACHETEMPLATE 32 = STREAM_FLAGS_DONTCACHEXSL Nella tabella successiva vengono fornite informazioni aggiuntive su questi valori.
xml root		Questa proprietà viene utilizzata per definire un tag radice per il codice XML risultante. Ad esempio, se si eseguono query SQL sul database e il documento XML risultante non ha un singolo elemento radice, il valore della proprietà viene usato per aggiungere un singolo elemento radice al documento. Per un esempio in cui viene usata questa proprietà, vedere Esecuzione di query SQL (provider SQLXMLOLEDB).
xsl		Questa proprietà viene utilizzata per specificare il nome del file XSL quando si desidera applicare la trasformazione XSL al documento XML restituito dalla query. Il percorso specificato può essere relativo (xyz/abc/MyXSL.xsl) o assoluto (C:\MyFolder\abc\MyXSL.xsl). Se viene specificato un percorso relativo, viene utilizzato il percorso di base specificato dalla proprietà Base Path per risolvere il percorso relativo. Se nella proprietà Base Path non è stato specificato alcun percorso, il percorso relativo è relativo alla directory corrente. Per un esempio in cui viene usata questa proprietà, vedere Applicazione di una trasformazione XSL (provider SQLXMLOLEDB).

La tabella seguente contiene le descrizioni dei valori delle proprietà ss Stream Flags.

Il valore della proprietà	Descrizione
STREAM_FLAGS_DISALLOW_URL	Gli URL non sono accettati per schemi di mapping o XSL.
STREAM_FLAGS_DISALLOW_ABSOLTE_PATH	Un percorso specificato per uno schema di mapping o per XSL deve essere relativo al percorso di base del modello stesso.
STREAM_FLAGS_DISALLOW_QUERY	Le query non sono consentite in un modello.
STREAM_FLAGS_DONTCACHEMAPPINGSCHEMA	Lo schema di mapping non viene memorizzato nella cache. Questo valore della proprietà è utile durante la fase di sviluppo del database, quando gli schemi del database sono soggetti a modifiche.
STREAM_FLAGS_DONTCACHETEMPLATE	I modelli non vengono memorizzati nella cache.
STREAM_FLAGS_DONTCACHEXSL	XSL non viene memorizzato nella cache.