Condividi tramite


Impostazione degli argomenti dei metodi del servizio Web

Un metodo del servizio Web ReportServer invia una richiesta al servizio a un URL specifico utilizzando SOAP tramite HTTP. Il servizio riceve la richiesta, la elabora e restituisce una risposta. Queste richieste e risposte hanno il formato di documenti XML.

Parametri facoltativi

In alcuni casi, un metodo del servizio Web può avere parametri di input facoltativi. Anche se un parametro di input per un metodo del servizio Web è facoltativo, è comunque necessario includerlo e impostare il relativo valore su Null (Nothing in Visual Basic). Impostando il valore di un parametro su Null, il valore dell'elemento per il parametro nella richiesta SOAP viene impostato su Null.

Nell'esempio seguente viene utilizzato il metodo CreateFolder per creare una nuova cartella denominata Product Sales nella cartella Sales. Se si imposta un valore Null per le proprietà della cartella, non verranno fornite proprietà specifiche dell'utente per la cartella:

// C#  
rs.CreateFolder("Product Sales", "/Sales", null);  

Tipi di dati complessi

La classe principale del servizio Web ReportServer è ReportingService2010 e viene utilizzata per richiamare le operazioni SOAP o i metodi Web della classe proxy. Per supportare questa classe e i relativi metodi, Reporting Services include tipi di dati complessi definiti dall'utente specifici dei parametri di input e output dei metodi del servizio Web. Questi tipi di dati complessi fanno parte della classe proxy generata che è possibile usare per lo sviluppo in ambiente Microsoft .NET Framework.

Quando si genera una classe proxy, i tipi di dati complessi definiti nel file WSDL vengono rappresentati dalle classi proxy, che includono proprietà che corrispondono ai vari elementi SOAP dei tipi di dati complessi. Le sequenze di questi tipi di dati diventano matrici di oggetti che è possibile enumerare nel codice. In questo modo, non è più necessario utilizzare direttamente le strutture XML inviate nei messaggi SOAP. La conversione viene gestita da .NET Framework.