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 si imposta il valore dell'elemento per tale parametro nella richiesta SOAP su null.

Nell'esempio seguente viene utilizzato il metodo CreateFolder per creare una nuova cartella denominata Product Sales nella cartella Sales. Fornendo un valore null per le proprietà della cartella, non vengono 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 utilizzare per lo sviluppo nell'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.