WCF-testklient (WcfTestClient.exe)
Windows Communication Foundation (WCF) Test Client (WcfTestClient.exe) är ett GUI-verktyg som gör det möjligt för användare att mata in testparametrar, skicka in dessa indata till tjänsten och visa svaret som tjänsten skickar tillbaka. Det ger en sömlös tjänsttestningsupplevelse i kombination med WCF-tjänstvärden.
Du hittar vanligtvis WCF-testklienten (WcfTestClient.exe) på följande plats: C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE – Communityn kan vara en av "Enterprise", "Professional" eller "Community" beroende på vilken nivå av Visual Studio som är installerad.
Scenarier för att använda testklient
I följande avsnitt beskrivs de vanligaste scenarierna där du kan använda WCF-testklienten för att effektivisera utvecklingsprocessen.
Inuti Visual Studio
WCF-tjänstvärden startar WCF-testklienten med en enda tjänst
När du har skapat ett nytt WCF-tjänstprojekt och trycker på F5 för att starta felsökningsprogrammet börjar WCF-tjänstvärden vara värd för tjänsten i projektet. Sedan öppnas WCF-testklienten och visar en lista över tjänstslutpunkter som definierats i konfigurationsfilen. Du kan testa parametrarna och anropa tjänsten och upprepa den här processen för att kontinuerligt testa och verifiera din tjänst.
WCF-tjänstvärden startar WCF-testklienten med flera tjänster
Du kan också använda WCF-testklienten för att felsöka ett tjänstprojekt som innehåller flera tjänster. När WCF-testklienten öppnas itererar den automatiskt listan över tjänster i projektet och öppnar dem för testning.
Utanför Visual Studio
Du kan också anropa WCF-testklienten (WcfTestClient.exe) utanför Visual Studio för att testa en godtycklig tjänst på Internet. Du hittar verktyget genom att gå till följande plats:
C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE (där communityn kan vara en av "Enterprise", "Professional" eller "Community" beroende på vilken nivå av Visual Studio som är installerad på datorn)
Om du vill använda verktyget dubbelklickar du på filnamnet för att öppna det från den här platsen eller startar det från en kommandorad.
WCF-testklienten tar ett godtyckligt antal URI:er som kommandoradsargument. Det här är URI:er för tjänster som kan testas.
wcfTestClient.exe URI1 URI2 …
När fönstret WCF-testklient har öppnats klickar du på Arkiv-Lägg> till tjänst och anger slutpunktsadressen för den tjänst som du vill öppna.
WCF-testklientens användargränssnitt
Du kan använda WCF-testklienten med en enda tjänst eller flera tjänster.
Tjänståtgärder
I den vänstra rutan i huvudfönstret för WCF-testklienten visas alla tillgängliga tjänster, tillsammans med deras respektive slutpunkter och åtgärder.
När du dubbelklickar på en åtgärd kan du visa dess innehåll i den högra rutan på en ny flik med åtgärdens namn.
I det vänstra fönstret visas även klientkonfigurationsfiler. Dubbelklicka på något av objekten för att visa innehållet i filen i ett nytt fönster med flikar i den högra rutan.
Ange testparametrar
Om du vill visa testparametrarna dubbelklickar du på en åtgärd för att öppna den i den högra rutan. Parametrarna visas som standard i formaterad vy och du kan ange godtyckliga värden för parametrarna för att testa tjänsten.
Om du vill visa meddelandets XML klickar du på XML. Om du vill skicka dem till tjänsten klickar du på Anropa.
För en DataSet-parameter klickar du på knappen ... bredvid Redigera... för att redigera den i ett nytt fönster som visar DataGrid. Observera utseendet på knapparna Kopiera datauppsättning och Klistra in datauppsättning . Om schemat för DataSet-objektet är okänt vid den första redigeringen är DataGrid tomt. Du måste klistra in ett DataSet-objekt med samma schema i det aktuella objektet i DataGrid. (Observera att du måste kopiera schemat från någon annanstans före inklistringsåtgärden.) Du kan också kopiera ett datauppsättningsobjekt för framtida användning genom att klicka på knappen Kopiera datauppsättning .
Tjänstens svar visas under testparametrarna.
Kommentar
Om det förväntade returvärdet är en sträng visas resultatet som en citerad sträng även om de angivna indata inte fanns inom citattecken.
Om du angav en viss åtgärd som enkelriktad när du skapade kontraktet för tjänsten visas inget tjänstsvar. Så snart meddelandet har placerats i kö för leverans visas en dialogruta som meddelar dig att meddelandet har skickats.
Sessionsstöd
Med kryssrutan Starta en ny proxy på fliken för en tjänståtgärd kan du växla sessionsstöd. Den här rutan är avmarkerad som standard.
När du anger testparametrar för en specifik åtgärd (eller en annan åtgärd i samma tjänstslutpunkt) och klickar på Anropa flera gånger med kryssrutan avmarkerad, delar dessa åtgärder en proxy och tjänststatusen sparas i flera åtgärder.
Om kryssrutan Starta en ny proxy är markerad startas en ny proxy för varje Invoke, föregående sessionsscenario avslutas och tjänststatusen återställs.
Redigera klientkonfiguration
I den vänstra rutan i huvudfönstret för WCF-testklienten visas klientkonfigurationsfiler. Dubbelklicka på något av objekten för att visa innehållet i filen i den högra rutan.
Redigera med Service Configuration Editor
Högerklicka på Konfigurationsfil i det vänstra fönstret och välj snabbmenyn Redigera med SvcConfigEditor. Tjänstkonfigurationsredigeraren startas med klientkonfigurationsinnehållet. Du kan redigera konfigurationen och spara den i verktyget.
När du har sparat filen i Tjänstkonfigurationsredigeraren visar WCF-testklienten ett varningsmeddelande som informerar dig om att filen har ändrats utanför och frågar om du vill läsa in den igen.
Om du väljer Ja återspeglar konfigurationsinnehållet på fliken "Client.dll.config" de ändringar du gjorde i redigeraren.
Om du väljer Nej förblir konfigurationsinnehållet på fliken "Client.dll.config" oförändrat och det ändrade innehållet sparas automatiskt i källfilen.
Återställ till standardkonfiguration
Om du vill avbryta alla ändringar och återställa till standardklientkonfigurationen högerklickar du på Konfigurationsfil i det vänstra fönstret och väljer snabbmenyn Återställ till Standardkonfiguration. Standardkonfigurationsvärdet läses in och innehållet på fliken "Client.dll.config" återställs.
Verifiera ändringar
När sparade ändringar läses in i WCF-testklienten kontrolleras konfigurationen för giltighet mot WCF-schema. Om fel hittas visas en dialogruta för att visa felinformation.
Under proxygenerering, binär kompilering eller tjänstanrop inaktiveras menyobjekt som stöder redigering (dvs. "Redigera ...", "Återställ ..." och så vidare. Tjänstanrop inaktiveras också när den uppdaterade konfigurationen läses in till WCF-testklienten.
Spara klientkonfiguration
Fliken Verktyg-Alternativ-Klientkonfiguration>> innehåller alternativet Återskapa alltid konfiguration när tjänster startas, vilket är aktiverat som standard. Det här alternativet anger att varje gång WCF-testklienten läser in en tjänst återskapas en konfigurationsfil baserat på det senaste tjänstkontraktet och appkonfigurationsfilerna för tjänsten.
Om du har redigerat klientkonfigurationen för WCF-tjänsten och alltid vill använda den uppdaterade filen för att felsöka tjänsten kan du avmarkera alternativet Återskapa . Även när du uppdaterar tjänsten och öppnar WCF-testklienten igen är filen Client.dll.config den som du uppdaterade tidigare i stället för en återskapad som baseras på den uppdaterade tjänsten.
Du kan dock behöva redigera konfigurationsfilen för att göra den konsekvent med den återskapade proxyn. Om den återskapade proxyn och konfigurationsfilen inte matchar på grund av en uppdaterad tjänst uppstår fel när tjänsten anropas.
Varning
Om du har ändrat klientkonfigurationsfilen och väljer att återanvända den i framtiden kan du hitta filen på följande plats:
\Dokument och Inställningar\[Användarkonto]\Mina dokument\Testa klientprojekt.
All uppdaterad information om autentiseringsuppgifter som lagras i klientkonfigurationsfilen skyddas av åtkomstkontrollistan (ACL) för den här mappen.
Lägga till, ta bort och uppdatera tjänster
Lägg till tjänst
Klicka på Arkiv-Lägg till tjänst för att lägga till en tjänst i WCF-testklienten>. Du måste sedan ange URI :n (slutpunktsadressen) för den tjänst som ska läggas till. Tjänstens adress kan vara en mex-adress eller WSDL-adress.
Du kan också hitta en lista över 10 nyligen tillagda tjänstslutpunkter i undermenyn Senaste tjänster . Om du väljer en av dem läggs den angivna tjänsten till i WCF-testklienten.
Du kan också högerklicka på roten för tjänstträdet Mina tjänstprojekt och välja Lägg till tjänst för att uppnå samma resultat.
Under proxygenerering, binär kompilering eller tjänstanrop inaktiveras menyalternativ som stöder tillägg av en tjänst. Tjänstanrop är också inaktiverat.
Ta bort tjänst
Högerklicka på tjänstroten för tjänsten som ska tas bort och välj Ta bort tjänst för att ta bort en tjänst från WCF-testklienten.
Under proxygenerering, binär kompilering eller tjänstanrop inaktiveras menyalternativ som stöder borttagning av en tjänst. Tjänstanrop är också inaktiverat.
Uppdatera tjänst
Om en ändring görs i tjänsten medan WCF-testklienten körs och du vill se till att implementeringen av WCF-testklienten för tjänsten är uppdaterad högerklickar du på tjänstens tjänstrot och väljer Uppdatera tjänst. Observera att tjänststatusen återställs efter uppdatering.
Under proxygenerering, binär kompilering eller tjänstanrop inaktiveras menyalternativ som stöder uppdatering av en tjänst. Tjänstanrop är också inaktiverat.
Plats för filer som genererats av testklienten
Som standard lagrar WCF-testklienten genererad klientkod och konfigurationsfiler i mappen %appdata%\Local\temp\Test Client Projects. Den här mappen tas bort när WCF-testklienten har avslutats. Om en konfigurationsfil ändras i WCF-testklienten och alternativet Återskapa alltid konfiguration när du startar tjänster inaktiveras, kopieras den ändrade filen till mappen "CachedConfig" under "Mina dokument\Testa klientprojekt" med en mappningsfil (metadata-adress-till-fil-namn) som ett index.
Du kan också starta WCF-testklienten på en kommandorad, använda växeln /ProjectPath för att ange en ny sökväg för att lagra genererade filer eller använda växeln /RestoreProjectPath för att återställa standardplatsen. Syntaxen ser ut så här:
wcfTestClient.exe /ProjectPath [desired location]
Om du kör det här kommandot öppnas inte WCF-testklienten. Endast mappplatsen ändras. Du kan köra det här kommandot oavsett om WCF-testklienten körs eller inte. Den nya platsen tillämpas när WCF-testklienten startas om. Platsinformationen kan sparas i registret eller i filen WcfTestClient.exe.option i mappen %appdata%\Local\temp\Test Client Projects.
Funktioner som stöds av WCF-testklienten
Följande är en lista över funktioner som stöds av WCF-testklienten:
Tjänstanrop: Begäran/svar och enkelriktade meddelanden.
Bindningar: alla bindningar som stöds av Svcutil.exe.
Kontrollera session.
Meddelandekontrakt.
XML-serialisering.
Följande är en lista över funktioner som inte stöds av WCF-testklienten:
Typer: Stream, Message, XmlElement, XmlAttribute, , XmlNodetyper som implementerar IXmlSerializable gränssnittet, inklusive det relaterade XmlSchemaProviderAttribute attributet, och typerna XDocument och XElement och ADO.NET DataTable typen.
Duplex-kontrakt.
Transaktionen.
Säkerhet: CardSpace, certifikat och användarnamn/lösenord.
Bindningar: WSFederationbinding, eventuella kontextbindningar och Https-bindningar, WebHttpbinding (stöd för Json-svarsmeddelande).
Stänga WCF-testklienten
Du kan stänga WCF-testklienten på följande sätt:
Klicka på Avsluta på Arkiv-menyn. Du kan också klicka på Stäng i huvudfönstret för WCF-testklienten. Båda dessa åtgärder stänger också av den automatiska WCF-tjänstens värd och stoppar Visual Studio-felsökningsprocessen om WCF-testklienten startades av Visual Studio.
Högerklicka på ikonen WCF-tjänstvärd i meddelandefältet och klicka sedan på Avsluta. Detta stänger av både WCF-tjänstens automatiska värd och WCF-testklienten och stoppar felsökningsprocessen i Visual Studio.