Client di test WCF (WcfTestClient.exe)WCF Test Client (WcfTestClient.exe)

Il Client di prova di Windows Communication Foundation (WCF) (WcfTestClient.exe) è un strumento GUI che consente agli utenti di immettere parametri di test, inviare l'input immesso al servizio e Visualizza la risposta restituita dal servizio.Windows Communication Foundation (WCF) Test Client (WcfTestClient.exe) is a GUI tool that enables users to input test parameters, submit that input to the service, and view the response that the service sends back. Fornisce un test in combinazione con Host servizio WCF del servizio trasparente.It provides a seamless service testing experience when combined with WCF Service Host.

In genere, è possibile trovare il Client di prova WCF (WcfTestClient.exe) nel percorso seguente: C:\Program Files (x86) \Microsoft Visual Studio\2017\Community\Common7\IDE - Community può essere uno tra "Enterprise", "Professional" o "Community", a seconda che livello di Visual Studio è installato.You can typically find the WCF Test Client (WcfTestClient.exe) in the following location: C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE - Community may be one of "Enterprise", "Professional" or "Community" depending on which level of Visual Studio is installed.

Scenari per l'uso di Client di testScenarios for Using Test Client

Le sezioni seguenti illustrano gli scenari più comuni in cui è possibile utilizzare Client di prova WCF per semplificare il processo di sviluppo.The following sections discuss the most common scenarios in which you can use WCF Test Client to streamline your development process.

All'interno di Visual StudioInside Visual Studio

Host servizio WCF avvia Client di test WCF con un solo servizioWCF Service Host Starts WCF Test Client with a Single Service

Dopo aver creato un nuovo progetto di servizio WCF e premere F5 per avviare il debugger, l'Host del servizio WCF avvia ospitare il servizio nel progetto.After you create a new WCF service project and press F5 to start the debugger, the WCF Service Host begins to host the service in your project. Quindi, Client di prova WCF aprirà e visualizzerà un elenco di endpoint servizio definiti nel file di configurazione.Then, WCF Test Client opens and displays a list of service endpoints defined in the configuration file. È possibile testare i parametri e richiamare il servizio e ripetere il processo per testare e convalidare continuamente il servizio.You can test the parameters and invoke the service, and repeat this process to continuously test and validate your service.

Host servizio WCF avvia Client di test WCF con più serviziWCF Service Host Starts WCF Test Client with Multiple Services

È inoltre possibile utilizzare Client di prova WCF per facilitare il debug di un progetto di servizio contenente più servizi.You can also use WCF Test Client to help debug a service project that contains multiple services. Quando si apre, Client di prova WCF automaticamente l'iterazione dell'elenco dei servizi nel progetto e li apre per il testing.When WCF Test Client opens, it automatically iterates the list of services in your project and opens them for testing.

All'esterno di Visual StudioOutside Visual Studio

È anche possibile richiamare il Client di prova WCF (WcfTestClient.exe) all'esterno di Visual Studio per testare un servizio arbitrario su Internet.You can also invoke the WCF Test Client (WcfTestClient.exe) outside Visual Studio to test an arbitrary service on the Internet. Per individuare lo strumento, passare al percorso seguente:To locate the tool, go to the following location:

C:\Programmi\Microsoft Visual Studio 9.0\Common7\IDE\C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\

Per usare lo strumento, fare doppio clic sul nome del file per aprirlo da questo percorso oppure avviarlo da una riga di comando.To use the tool, double-click the file name to open it from this location, or launch it from a command line.

Client di prova WCF Usa un numero arbitrario di URI come argomenti della riga di comando.WCF Test Client takes an arbitrary number of URIs as command line arguments. Di seguito sono riportati gli URI dei servizi che è possibile sottoporre a test.These are the URIs of services that can be tested.

wcfTestClient.exe URI1 URI2 …

Dopo l'apertura della finestra del Client di prova WCF, fare clic su File->Aggiungi servizio, quindi immettere l'indirizzo dell'endpoint del servizio che si desidera aprire.After the WCF Test Client window is opened, click File->Add Service, and enter the endpoint address of the service you want to open.

Interfaccia utente di Client di test WCFWCF Test Client User Interface

È possibile utilizzare Client di prova WCF con uno o più servizi.You can use WCF Test Client with a single service or multiple services.

Operazioni di servizioService Operations

Il riquadro sinistro della finestra principale di Client di prova WCF Elenca tutti i servizi disponibili, insieme ai rispettivi endpoint e operazioni.The left pane of the WCF Test Client main window lists all the available services, along with their respective endpoints and operations.

Quando si fa doppio clic su un'operazione, è possibile visualizzare il relativo contenuto nel riquadro di destra all'interno di una nuova scheda con il nome dell'operazione.When you double-click an operation, you can view its content in the right pane inside a new tab with the operation's name.

Nel riquadro di sinistra sono elencati i anche file di configurazione client.The left pane also lists client configuration files. Fare doppio clic sugli elementi per visualizzare il contenuto del file in una nuova finestra a schede nel riquadro di destra.Double-click any of the items to display the content of the file in a new tabbed window in the right pane.

Immissione dei parametri del testEntering Test Parameters

Per visualizzare i parametri del test, fare doppio clic su un'operazione per aprirla nel riquadro di destra.To view the test parameters, double-click an operation to open it in the right pane. I parametri vengono mostrati formattato Visualizza per impostazione predefinita ed è possibile immettere valori arbitrari per i parametri testare il servizio.The parameters are showed in Formatted view by default, and you can enter arbitrary values for the parameters to test the service.

Per visualizzare il XML del messaggio, fare clic su XML.To view the message's XML, click XML. Per inviarli al servizio, fare clic su Invoke.To send them to the service, click Invoke.

Per un parametro di set di dati, fare clic sul ...For a DataSet parameter, click the accanto alla modifica...button next to Edit… per modificarlo in una nuova finestra che mostra la griglia dati.to edit it in a new window showing the DataGrid. Si noti l'aspetto del copia DataSet e Incolla DataSet pulsanti.Notice the appearance of the Copy DataSet and Paste DataSet buttons. Se lo schema dell'oggetto the DataSet non è noto alla prima modifica, il DataGrid sarà vuoto.If the schema of the DataSet object is unknown upon the first edit, the DataGrid is empty. È necessario incollare un oggetto DataSet object con lo stesso schema nell'oggetto corrente nel DataGridYou have to paste a DataSet object with the same schema into the current object in the DataGrid. (tenere presente che è necessario copiare lo schema da un'altra posizione prima di incollare). È inoltre possibile copiare un oggetto set di dati per l'utilizzo futuro facendo il copia DataSet pulsante.(Notice that you need to copy the schema from somewhere else before the paste operation.) You can also copy a Dataset object for future usage by clicking the Copy DataSet button.

La risposta del servizio viene visualizzata sotto i parametri del test.The service's response appears below the test parameters.

Nota

Se il valore restituito previsto è una stringa, il risultato verrà visualizzato come una stringa tra virgolette anche se l'input fornito non era tra virgolette.If the expected return value is a string, the result will be displayed as a quoted string even though the input provided was not in quotes.

Se una particolare operazione viene specificata come unidirezionale quando si crea il contratto per il servizio, non viene visualizzata alcuna risposta del servizio.If you specified a particular operation as one-way when you created the contract for the service, no service response is displayed. Non appena il messaggio viene accodato per il recapito, viene visualizzata una finestra di dialogo per notificare che il messaggio è stato inviato correttamente.As soon as the message is queued for delivery, a dialog box pops up to notify you that the message was successfully sent.

Supporto della sessioneSession Support

Il avvia un nuovo proxy casella di controllo nella scheda dell'operazione del servizio consente di attivare o disattivare il supporto della sessione.The Start a new proxy check box in a service operation's tab enables you to toggle session support. Per impostazione predefinita, la casella è deselezionata.This box is cleared by default.

Quando si immettono i parametri di test per un'operazione specifica (o un'altra operazione nell'endpoint del servizio stesso) e fare clic su Invoke più volte con la casella di controllo deselezionata, tali operazioni condividono un unico proxy e lo stato del servizio è persistente tra più operazioni.When you enter test parameters for a specific operation (or another operation in the same service endpoint) and click Invoke multiple times with the check box cleared, these operations share one proxy and the service status is persisted across multiple operations.

Se il avvia un nuovo proxy casella di controllo è selezionata, viene avviato un nuovo proxy per ogni Invoke, lo scenario di sessione precedente è stato terminato e viene reimpostato lo stato del servizio.If the Start a new proxy check box is checked, a new proxy is started for each Invoke, the previous session scenario is ended, and the service status is reset.

Modifica della configurazione clientEditing Client Configuration

Il riquadro sinistro della finestra principale di Client di prova WCF Elenca i file di configurazione client.The left pane of the WCF Test Client main window lists client configuration files. Fare doppio clic su uno degli elementi per visualizzare il contenuto del file nel riquadro di destra.Double-click any of the items to display the contents of the file in the right pane.

Apportare modifiche con l'Editor configurazione serviziEdit with Service Configuration Editor

Fare doppio clic su File di configurazione nel riquadro sinistro e selezionare il menu di scelta rapida modifica con SvcConfigEditor.Right-click Config File in the left pane and select the context menu Edit with SvcConfigEditor. Editor configurazione servizi verrà avviato con il contenuto della configurazione client.Service Configuration Editor is launched with the client configuration content. Sarà possibile modificare la configurazione e salvarla all'interno dello strumento.You can edit the configuration and save it within the tool.

Dopo aver salvato il file nell'Editor di configurazione di servizio, Client di prova WCF viene visualizzato un messaggio di avviso per informare l'utente che il file è stato modificato all'esterno e chiede se si desidera ricaricarlo.After saving the file in Service Configuration Editor, WCF Test Client displays a warning message to inform you that the file has been modified outside and asks whether you would like to reload it.

Se si seleziona , il contenuto della configurazione nella scheda "Client.dll. config" rifletterà le modifiche apportate nell'editor.If you select Yes, the configuration content in the "Client.dll.config" tab reflects the changes you made in the editor.

Se si seleziona n, il contenuto della configurazione nella scheda "Client.dll. config" rimarrà invariato e il contenuto modificato viene salvato automaticamente al file di origine.If you select No, the configuration content in the "Client.dll.config" tab remains unchanged and the modified content is automatically saved to the source file.

Ripristinare la configurazione predefinitaRestore to Default Configuration

Se si desidera annullare tutte le modifiche e ripristinare la configurazione del client predefinito, fare doppio clic su File di configurazione nel riquadro sinistro e selezionare il menu di scelta rapida Ripristina configurazione predefinita. Il valore di configurazione predefinito viene caricato e viene ripristinato il contenuto nella scheda "Client.dll. config".If you want to cancel all the changes and restore to the default client configuration, right-click Config File in the left pane and select the context menu Restore to Default Config. The default configuration value is loaded and content in "Client.dll.config" tab is restored.

Convalidare le modificheValidate Changes

Quando le modifiche salvate vengono caricate in Client di prova WCF, la configurazione viene verificata la validità rispetto allo schema WCF.When saved changes are being loaded in WCF Test Client, the configuration is checked for validity against WCF schema. Se vengono rilevati errori, verrà visualizzata una finestra di dialogo contenente i dettagli degli errori.If errors are found, a dialog box is displayed to show error details.

Durante la generazione del proxy, compilazione binaria o di richiamo del servizio, le voci di menu che supportano la modifica (vale a dire, "Modifica...", "Restore …" e così via) sono disabilitate.During proxy generation, binary compiling, or service invoking, menu items that support editing (that is, "Edit …", "Restore …", and so on) are disabled. Chiamata del servizio risulta inoltre disattivata durante il caricamento aggiornamento configurazione al Client di prova WCF.Service invocation is also disabled when loading updated configuration to WCF Test Client.

Rendere persistente la configurazione clientPersist Client Configuration

Il strumenti->opzioni->configurazione Client scheda contiene un sempre rigenerare la configurazione durante l'avvio Servizi opzione, abilitata per impostazione predefinita.The Tools->Options->Client Configuration tab contains an Always Regenerate Config When Launching Services option, which is enabled by default. Questa opzione specifica che ogni volta che il Client di prova WCF carica un servizio, rigenera un file di configurazione in base al contratto di servizio più recente e il file app. config del servizio.This option specifies that every time WCF Test Client loads a service, it regenerates a configuration file based on the latest service contract and service App.config files.

Se si hanno modificato la configurazione del client per il servizio WCF e si desidera usare sempre il file aggiornato per il debug del servizio, è possibile deselezionare le rigenerare opzione.If you have edited the client configuration for your WCF service and want to always use this updated file to debug your service, you can uncheck the Regenerate option. In questo modo, anche quando si aggiorna il servizio e si riapre Client di prova WCF, il file client è quello aggiornato in precedenza anziché rigenerata una basata sul servizio aggiornato.By doing so, even when you update the service and reopen WCF Test Client, the Client.dll.config file is the one you updated previously instead of a regenerated one based on the updated service.

Potrebbe tuttavia essere necessario modificare il file di configurazione per renderlo coerente con il proxy rigenerato.However, you might need to edit the configuration file to make it consistent with the regenerated proxy. Se il proxy e file di configurazione rigenerati non corrispondono perché un servizio è stato aggiornato, si verificheranno errori quando il servizio viene richiamato.If the regenerated proxy and configuration file are mismatched due to an updated service, errors will occur when the service is invoked.

Attenzione

Se il file di configurazione client è stato modificato e si è scelto di riusarlo in futuro, il file sarà disponibile nel percorso seguente:If you have modified the client configuration file and select to reuse it in the future, you can find the file in the following location:

\Documents and Settings\[Account utente] \My Documents\Test Client Projects.\Documents and Settings\[User Account]\My Documents\Test Client Projects.

Le informazioni sulle credenziali aggiornate archiviate nel file di configurazione client sono protette dall'elenco di controllo dell'accesso (ACL) di questa cartella.Any updated credential information stored to the client configuration file is protected by the Access Control List (ACL) of this folder.

Aggiunta, rimozione e aggiornamento di serviziAdding, Removing and Refreshing Services

Aggiungere un servizioAdd Service

Fare clic su File->Aggiungi servizio per aggiungere un servizio al Client di prova WCF.Click File->Add Service to add a service to WCF Test Client. Verrà quindi richiesto di digitare l'URI (indirizzo endpoint) del servizio da aggiungere.You are then required to type the URI (endpoint address) of the service to be added. L'indirizzo del servizio può corrispondere a un indirizzo mex o a un indirizzo WSDL.The service’s address can be a mex address or WSDL address.

È inoltre possibile trovare un elenco di endpoint 10 servizio aggiunti recentemente nel servizi recenti sottomenu.You can also find a list of 10 recently added services' endpoints in the Recent Services submenu. Se si seleziona uno di essi, il servizio specificato viene aggiunto al Client di prova WCF.If you select one of them, the specified service is added to WCF Test Client.

È anche possibile fare doppio clic la radice dell'albero del servizio progetti di servizie selezionare Aggiungi servizio per ottenere lo stesso risultato.You can also right-click the root of service tree My Service Projects, and select Add Service to achieve the same result.

Durante il processo di generazione proxy, di compilazione binaria o di richiamo del servizio, le voci di menu che supportano l'aggiunta di un servizio risultano disabilitate.During proxy generation, binary compiling, or service invocation, menu items that support adding a service are disabled. Anche la chiamata del servizio è disabilitata.Service invocation is also disabled.

Rimuovere un servizioRemove Service

Fare doppio clic sulla radice del servizio del servizio da rimuovere, quindi scegliere Rimuovi servizio per rimuovere un servizio da Client di prova WCF.Right-click the service root of the service to be removed, and select Remove Service to remove a service from WCF Test Client.

Durante il processo di generazione proxy, di compilazione binaria o di richiamo del servizio, le voci di menu che supportano la rimozione di un servizio risultano disabilitate.During proxy generation, binary compiling, or service invocation, menu items that support removing a service are disabled. Anche la chiamata del servizio è disabilitata.Service invocation is also disabled.

Aggiornare un servizioRefresh Service

Se viene apportata una modifica al servizio mentre Client di prova WCF è in esecuzione e si desidera verificare che l'implementazione del Client di prova WCF per il servizio sia aggiornata, fare doppio clic sulla radice del servizio del servizio e selezionare Aggiorna servizio.If a change is made to the service while WCF Test Client is running and you want to ensure that the WCF Test Client implementation for that service is up-to-date, right-click the service root of the service, and select Refresh Service. Si noti che dopo l'aggiornamento lo stato del servizio viene reimpostato.Note that after refreshing, the service status is reset.

Durante il processo di generazione proxy, di compilazione binaria o di richiamo del servizio, le voci di menu che supportano l'aggiornamento di un servizio risultano disabilitate.During proxy generation, binary compiling, or service invocation, menu items that support refreshing a service are disabled. Anche la chiamata del servizio è disabilitata.Service invocation is also disabled.

Percorso dei file generati da Client di testLocation of Files Generated by the Test Client

Per impostazione predefinita, Client di prova WCF Archivia file di codice e la configurazione client generati nella cartella "%appdata%\Local\temp\Test Client Projects".By default, WCF Test Client stores generated client code and configuration files in the "%appdata%\Local\temp\Test Client Projects" folder. Questa cartella viene eliminata dopo la chiusura di Client di prova WCF.This folder is deleted after WCF Test Client exits. Se un file di configurazione viene modificato in Client di prova WCF e il sempre rigenerare la configurazione all'avvio dei servizi opzione è disabilitata, il file modificato verrà copiato nella cartella "Memorizzato nella cache Config" nel percorso "Documenti\test Client Projects Documents\Test Client Projects"con un file XML di mapping (metadati-indirizzo-a--nome file) come indice.If a configuration file is modified in WCF Test Client and the Always Regenerate Config When Launching Services option is disabled, the modified file is copied to the "Cached Config" folder under "My Documents\Test Client Projects Documents\Test Client Projects" with a mapping (metadata-address-to-file-name) XML file as an index.

È inoltre possibile avviare Client di prova WCF in una riga di comando, usare il /ProjectPath per specificare un percorso desiderato per l'archiviazione dei file generati oppure usare il /RestoreProjectPath passa a ripristinare il percorso predefinito.You can also start WCF Test Client in a command line, use the /ProjectPath switch to specify a new desired path for storing generated files, or use the /RestoreProjectPath switch to restore the default location. La sintassi è la seguente:The syntax is as follows:

wcfTestClient.exe /ProjectPath [desired location]

Eseguendo questo comando non viene aperto il Client di prova WCF.Running this command does not open WCF Test Client. ma solo la modifica del percorso della cartella.Only the folder location is changed. È possibile eseguire questo comando se Client di prova WCF è in esecuzione o non.You can run this command whether WCF Test Client is running or not. Nella nuova posizione viene applicata quando il Client di prova WCF viene riavviato.The new location is applied when WCF Test Client is restarted. Le informazioni sul percorso possono essere salvati nel Registro di sistema o nel file WcfTestClient.exe Option nella cartella "%appdata%\Local\temp\Test Client Projects".The location information can be saved in registry, or in the WcfTestClient.exe.option file in the "%appdata%\Local\temp\Test Client Projects" folder.

Funzionalità supportate da Client di prova WCFFeatures supported by WCF Test Client

Di seguito è un elenco delle funzionalità supportate da Client di prova WCF:The following is a list of features supported by WCF Test Client:

  • Chiamata al servizio: messaggio di richiesta/risposta e unidirezionale.Service Invocation: Request/Response and One-way message.

  • Associazioni: tutte le associazioni supportate da Svcutil.exe.Bindings: all bindings supported by Svcutil.exe.

  • Controllo della sessione.Controlling Session.

  • Contratto di messaggio.Message Contract.

  • Serializzazione XML.XML serialization.

Di seguito è un elenco di funzionalità non supportate dal Client di prova WCF:The following is a list of features not supported by WCF Test Client:

Chiusura di Client di test WCFClosing WCF Test Client

È possibile chiudere Client di prova WCF nei modi seguenti:You can close WCF Test Client in the following ways:

  • Nel File menu, fare clic su uscita.On the File menu, click Exit. In alternativa, nella finestra principale del Client di Test WCF, fare clic su Chiudi.Alternatively, in the WCF Test Client main window, click Close. Entrambi queste azioni anche arrestare Host automatico servizio di WCF e arrestare il processo di debug di Visual Studio se Client di prova WCF è stato avviato da Visual Studio.Both of these actions also shut down WCF Service Auto Host and stop the Visual Studio debugging process if WCF Test Client was launched by Visual Studio.

  • Fare doppio clic sui Host servizio WCF sull'icona nell'area di notifica e quindi fare clic su uscita.Right-click the WCF Service Host icon in the notification area, and then click Exit. Questo chiude sia Host automatico servizio di WCF e Client di prova WCF e arresta il processo di debug di Visual Studio.This shuts down both WCF Service Auto Host and WCF Test Client and stops the Visual Studio debugging process.

Vedere ancheSee Also

Host del servizio WCF (WcfSvcHost.exe)WCF Service Host (WcfSvcHost.exe)