Passaggio di parametri agli updategram (SQLXML 4.0)
Gli updategram sono modelli e in quanto tali è possibile passare loro parametri. Per ulteriori informazioni sul passaggio di parametri ai modelli, vedere Considerazioni sulla protezione degli updategram (SQLXML 4.0).
Gli updategram consentono di passare NULL come valore di parametro. Per passare il valore di parametro NULL, è necessario specificare l'attributo nullvalue. Il valore assegnato all'attributo nullvalue viene quindi fornito come valore di parametro e considerato come NULL dagli updategram.
[!NOTA]
In <sql:header> e <updg:header> è necessario specificare nullvalue come non qualificato, mentre in <updg:sync>nullvalue viene specificato come qualificato (ad esempio, updg:nullvalue).
Esempi
Per creare esempi reali utilizzando gli esempi seguenti, è necessario soddisfare i requisiti specificati in Requisiti per l'esecuzione di esempi di SQLXML.
Prima di utilizzare gli esempi dell'updategram, si noti quanto segue:
Negli esempi viene utilizzato il mapping predefinito, ovvero non viene specificato alcuno schema di mapping nell'updategram. Per ulteriori esempi di updategram che utilizzano schemi di mapping, vedere Specifica di uno schema di mapping con annotazioni in un updategram (SQLXML 4.0).
Gli aggiornamenti vengono applicati alle tabelle nel database AdventureWorks. È possibile ripristinare il database AdventureWorks. Per ulteriori informazioni, vedere Database di esempio AdventureWorks.
A. Passaggio di parametri a un updategram
In questo esempio l'updategram modifica il cognome di un dipendente nella tabella HumanResources.Shift. All'updategram vengono passati due parametri: ShiftID, utilizzato per identificare in modo univoco un turno, e Name.
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:header>
<updg:param name="ShiftID"/>
<updg:param name="Name" />
</updg:header>
<updg:sync >
<updg:before>
<HumanResources.Shift ShiftID="$ShiftID" />
</updg:before>
<updg:after>
<HumanResources.Shift Name="$Name" />
</updg:after>
</updg:sync>
</ROOT>
Per testare l'updategram
Copiare l'updategram sopra indicato in Blocco note e salvarlo in un file con il nome UpdategramWithParameters.xml.
Creare e utilizzare lo script di test SQLXML 4.0 (Sqlxml4test.vbs) per eseguire l'updategram.
Per ulteriori informazioni, vedere Utilizzo di ADO per eseguire query SQLXML 4.0.
B. Passaggio di NULL come valore di parametro a un updategram
Durante l'esecuzione di un updategram, il valore "isnull" viene assegnato al parametro che si desidera impostare su NULL. L'updategram converte il valore di parametro "isnulll" in NULL e lo elabora di conseguenza.
Nell'updategram seguente la qualifica di un dipendente viene impostata su NULL:
<ROOT xmlns:updg="urn:schemas-microsoft-com:xml-updategram">
<updg:header nullvalue="isnull" >
<updg:param name="EmployeeID"/>
<updg:param name="ManagerID" />
</updg:header>
<updg:sync >
<updg:before>
<HumanResources.Employee EmployeeID="$EmployeeID" />
</updg:before>
<updg:after>
<HumanResources.Employee ManagerID="$ManagerID" />
</updg:after>
</updg:sync>
</ROOT>
Per testare l'updategram
Copiare l'updategram sopra indicato in Blocco note e salvarlo in un file con il nome UpdategramPassingNullvalues.xml.
Creare e utilizzare lo script di test SQLXML 4.0 (Sqlxml4test.vbs) per eseguire l'updategram.
Per ulteriori informazioni, vedere Utilizzo di ADO per eseguire query SQLXML 4.0.