Impostazione degli argomenti dei metodi del servizio WebSupplying Web Service Method Arguments

Un metodo del servizio Web ReportServer invia una richiesta al servizio a un URL specifico utilizzando SOAP tramite HTTP.A Report Server Web service method sends a request to the service at a given URL using SOAP over HTTP. Il servizio riceve la richiesta, la elabora e restituisce una risposta.The service receives the request, processes it, and then returns a response. Queste richieste e risposte hanno il formato di documenti XML.These requests and responses are in the form of XML documents.

Parametri facoltativiOptional Parameters

In alcuni casi, un metodo del servizio Web può avere parametri di input facoltativi.In some cases, a Web service method can have optional input parameters. Anche se un parametro di input per un metodo del servizio Web è facoltativo, è comunque necessario includerlo e impostare il valore del parametro null (nulla in Visual BasicVisual Basic).Even if an input parameter for a Web service method is optional, you must still include it and set the parameter value to null (Nothing in Visual BasicVisual Basic). Impostando un valore di parametro null imposta il valore dell'elemento per il parametro nella richiesta SOAP per null.Setting a parameter value to null sets the element value for that parameter in the SOAP request to null.

Nell'esempio seguente viene utilizzato il metodo CreateFolder per creare una nuova cartella denominata Product Sales nella cartella Sales.The following example uses the CreateFolder method to create a new folder named Product Sales in the Sales folder. Fornendo un null valore per le proprietà della cartella, nessuna proprietà specifiche dell'utente vengono forniti per la cartella:By supplying a null value for the folder properties, no user-specific properties are supplied for the folder:

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

Tipi di dati complessiComplex Data Types

La classe principale del servizio Web ReportServer è ReportingService2010 e viene utilizzata per richiamare le operazioni SOAP o i metodi Web della classe proxy.The core class of the Report Server Web service is ReportingService2010, which you use to invoke the SOAP operations or Web methods of the proxy class. Per supportare questa classe e i relativi metodi, Reporting ServicesReporting Services include tipi di dati complessi definiti dall'utente specifici dei parametri di input e output dei metodi del servizio Web.To support this class and its methods, Reporting ServicesReporting Services includes user-defined, complex data types that are specific to the input and output parameters of the Web service methods. Questi tipi di dati complessi fanno parte della classe proxy generata, che è possibile utilizzare quando si sviluppa nel MicrosoftMicrosoft .NET Framework.NET Framework ambiente.These complex data types are part of the generated proxy class, which you can use when developing in the MicrosoftMicrosoft .NET Framework.NET Framework environment.

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.When you generate a proxy class, the complex data types that are defined in the WSDL file are represented by the classes of the proxy, which include properties that correspond to the various SOAP elements of the complex data types. Le sequenze di questi tipi di dati diventano matrici di oggetti che è possibile enumerare nel codice.Sequences of these data types become arrays of objects that you can enumerate through in your code. In questo modo, non è più necessario utilizzare direttamente le strutture XML inviate nei messaggi SOAP.This eliminates the need to work directly with the XML structures sent in SOAP messages. La conversione viene gestita da .NET Framework.NET Framework.The .NET Framework.NET Framework handles that translation for you.

Vedere ancheSee Also

Creazione di applicazioni mediante il servizio Web e .NET Framework Building Applications Using the Web Service and the .NET Framework
Servizio Web ReportServer Report Server Web Service
Riferimento tecnico ( SSRS )Technical Reference (SSRS)