Konfigurationsredigerarens verktyg (SvcConfigEditor.exe)
Med Windows Communication Foundation (WCF) Service Configuration Editor (SvcConfigEditor.exe) kan administratörer och utvecklare skapa och ändra konfigurationsinställningar för WCF-tjänster med hjälp av ett grafiskt användargränssnitt. Med det här verktyget kan du hantera inställningar för WCF-bindningar, beteenden, tjänster och diagnostik utan att behöva redigera XML-konfigurationsfiler direkt.
Tjänstkonfigurationsredigeraren finns i mappen C:\Program\Microsoft SDKs\Windows\v6.0\Bin.
WCF-konfigurationsredigeraren
Tjänstkonfigurationsredigeraren levereras med en guide som vägleder dig genom alla steg när du konfigurerar en WCF-tjänst eller -klient. Du rekommenderas starkt att använda guiden i stället för redigeraren direkt.
Om du redan har några konfigurationsfiler som följer standardschemat System.Configuration kan du hantera specifika inställningar för bindningar, beteende, tjänster och diagnostik med användargränssnittet. Med Tjänstkonfigurationsredigeraren kan du hantera inställningarna för befintliga WCF-konfigurationsfiler samt körbara filer, COM+-tjänster och webbaserade tjänster. När du öppnar en webbhanterad tjänst med Service Configuration Editor visas både tjänstens egen konfiguration och ärvda konfigurationer i de övre noderna.
Eftersom WCF-konfigurationsinställningarna finns i avsnittet i <system.serviceModel> konfigurationsfilen fungerar redigeraren uteslutande på innehållet i det här elementet och har inte åtkomst till andra element i samma fil. Du kan navigera till befintliga konfigurationsfiler direkt eller välja en sammansättning som innehåller en tjänst, virtuell katalog eller COM+-tjänst. Redigeraren läser in konfigurationsfilen för den specifika tjänsten och tillåter användaren att antingen lägga till nya element eller redigera befintliga element kapslade i avsnittet i <system.serviceModel> konfigurationsfilen.
Redigeraren stöder IntelliSense och tillämpar schemaefterlevnad. Resultatet är garanterat att följa konfigurationsfilens schema och att ha syntaktiskt korrekta datavärden. Redigeraren garanterar dock inte att konfigurationsfilen är semantiskt giltig. Med andra ord garanterar inte redigeraren att konfigurationsfilen kan fungera med den tjänst som den konfigurerar.
Varning
Redigeraren kan inte rensa ett konfigurationselement från konfigurationsfilen när du har ändrat elementet. Om du till exempel använder redigeraren för att ange slutpunktsnamnet till en icke-tom sträng och sparar den, har konfigurationsfilen följande innehåll, som du ser i följande exempel.
<endpoint binding="basicHttpBinding" name="somename" />
Om du försöker ta bort namnet genom att ange det till en tom sträng och spara filen, innehåller konfigurationsfilen name fortfarande attributet, som du ser i följande exempel.
<endpoint binding="basicHttpBinding" name="" />
Om du vill rensa attributet måste du redigera elementet manuellt med hjälp av en annan textredigerare.
Du bör vara särskilt försiktig med det här problemet när du använder elementet issueToken i slutpunktsbeteendet clientCredential . Mer specifikt får attributet för address dess localIssuer underelement inte vara en tom sträng. Om du har ändrat address attributet med hjälp av konfigurationsredigeraren och vill ta bort det helt bör du göra det med ett annat verktyg än redigeraren. Annars innehåller attributet en tom sträng och programmet genererar ett undantag.
Använda konfigurationsredigeraren
Tjänstkonfigurationsredigeraren finns på följande installationsplats för Windows SDK:
C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin\SvcConfigEditor.exe
När du har öppnat tjänstkonfigurationsredigeraren kan du använda menyn Arkiv/Öppna för att bläddra efter den tjänst eller sammansättning som du vill hantera. Du kan öppna konfigurationsfiler direkt, bläddra efter WCF/COM+-tjänster och öppna konfigurationsfiler för webbaserade tjänster.
Användargränssnittet för Tjänstkonfigurationsredigeraren är indelat i följande områden:
Fönstret Trädvy, som visar konfigurationselement i en trädstruktur till vänster. Du kan utföra åtgärder i trädet genom att högerklicka på noderna.
Åtgärdsfönstret, som visar vanliga uppgifter för aktuella element längst ned till vänster i fönstret
Informationsfönstret, som visar detaljerade inställningar för konfigurationsnoden som valts i trädvyn till höger.
Öppna en konfigurationsfil
Starta Tjänstkonfigurationsredigeraren med hjälp av ett kommandofönster för att navigera till din WCF-installationsplats och skriv
SvcConfigEditor.exesedan .På menyn Arkiv väljer du Öppna och klickar på den typ av fil som du vill hantera.
I dialogrutan Öppna navigerar du till den specifika fil som du vill hantera och dubbelklickar på den.
Visningsprogrammet följer automatiskt konfigurationssammanslagningssökvägen och skapar en vy över den sammanfogade konfigurationen. Till exempel är den faktiska konfigurationen av en tjänst som inte är värd en kombination av Machine.config och App.config. Alla ändringar tillämpas på den aktiva filen i SvcConfigEditor. Om du vill redigera en specifik fil i konfigurationssammanslagningssökvägen bör du öppna den direkt.
Kommentar
Konfigurationsredigeraren läser in den konfigurationsfil som är öppen igen när den senare har ändrats utanför redigeraren. När detta händer går alla ändringar som inte sparas i redigeraren förlorade. Om ominläsning sker konsekvent är den troligaste orsaken en tjänst som ständigt kommer åt konfigurationsfilen, till exempel ett antivirusprogram som körs i bakgrunden. Lös problemet genom att se till att Konfigurationsredigeraren är den enda process som kan komma åt filen när den öppnas.
Tjänster
Noden Tjänster visar alla tjänster som för närvarande är tilldelade i konfigurationsfilen. Varje undernod i trädet motsvarar ett delelement av elementet <services> i konfigurationsfilen.
När du klickar på noden Tjänster kan du visa eller utföra uppgifter på tjänstsammanfattningssidan i informationsfönstret.
Skapa en ny tjänstkonfiguration
Du kan skapa en ny tjänstkonfiguration på följande sätt:
Använda en guide: Klicka på länken Skapa en ny tjänst... i åtgärdsfönstret eller på sammanfattningssidan för att starta guiden. Du kan också göra det på arkivmenyn ->Lägg till nytt objekt.
Skapa manuellt: Du kan högerklicka på noden Tjänster och välja Ny tjänst.
Skapa en ny tjänstslutpunktskonfiguration
Du kan skapa en ny tjänstslutpunktskonfiguration på följande sätt:
Skapa med hjälp av en guide: klicka på länken Skapa en ny tjänstslutpunkt... i åtgärdsfönstret eller på sammanfattningssidan för att starta guiden. Du kan också göra det på arkivmenyn ->Lägg till nytt objekt.
Skapa manuellt: När du har skapat en tjänst kan du högerklicka på noden Slutpunkter och välja "Ny tjänstslutpunkt".
Redigera en tjänstkonfiguration
Klicka på en tjänstnod .
Redigera inställningarna i egenskapsrutnäten.
Redigera en tjänstslutpunktskonfiguration
Klicka på en tjänstslutpunktsnod .
Redigera inställningarna i egenskapsrutnäten.
Lägga till en basadress
Klicka på noden Värd .
Klicka på knappen Ny... i avsnittet Basadresser.
Skriv in basadress-URI:n i dialogrutan.
Klicka på OK.
Kommentar
Du kan inte redigera värdet <för baseAddressPrefixFilters> i det här verktyget. Om du vill lägga till eller ändra det här elementet bör du använda en textredigerare eller Visual Studio.
Klient
Klientnoden visar alla klientslutpunkter i konfigurationsfilen. Varje undernod i trädet motsvarar ett delelement av elementet <client> i konfigurationsfilen.
När du klickar på klientnoden kan du visa eller utföra uppgifter på klientens sammanfattningssida i informationsfönstret.
Skapa en ny klientslutpunktskonfiguration
Du kan skapa en ny klientslutpunktskonfiguration på följande sätt:
Skapa efter guide: Klicka på länken Skapa en ny klient... i åtgärdsfönstret längst ned till vänster i fönstret eller på sammanfattningssidan för att starta guiden. Du kan också göra det på arkivmenyn ->Lägg till nytt objekt. Guiden uppmanar dig att peka på platsen för tjänstkonfigurationen, från vilken klientkonfigurationen genereras. Du kan sedan välja den tjänstslutpunkt som du vill ansluta till.
Skapa manuellt: Högerklicka på noden Slutpunkter under Klient och välj Ny klientslutpunkt.
Redigera en klientslutpunktskonfiguration
Klicka på en klientslutpunktsnod .
Redigera inställningarna i egenskapsrutnäten.
Standardslutpunkt
Standardslutpunkter är specialiserade slutpunkter som har en eller flera aspekter av adressen, kontraktet och bindningen inställda på standardvärden.
Sådana konfigurationsinställningar lagras i standardslutpunktsnoden. Standardslutpunktsnoden visar alla standardslutpunktsinställningar i konfigurationsfilen. Varje undernod i trädet motsvarar ett underelement i elementet <standardEndpoints> i konfigurationsfilen.
När du klickar på standardslutpunktsnoden kan du visa eller utföra uppgifter på standardsidan för slutpunktssammanfattning i informationsfönstret.
Skapa en ny standardslutpunktskonfiguration
Du kan skapa en ny standardslutpunktskonfiguration på följande sätt:
Högerklicka på standardslutpunktsnoden och välj Ny standardslutpunktskonfiguration... Välj bindningstypen i dialogrutan och klicka på OK.
Välj noden Standardslutpunkt och klicka på Ny standardslutpunktskonfiguration... i åtgärdsfönstret längst ned till vänster i fönstret.
Dialogrutan Skapa en ny standardslutpunkt visar och visar en lista över alla registrerade standardslutpunktstyper.
Visa och redigera en standardslutpunktskonfiguration
Du kan öppna en standardslutpunktskonfiguration för visning och redigering på följande sätt:
Klicka för att expandera standardslutpunktsnoden och klicka på respektive undernod för slutpunkten.
Klicka på noden Standardslutpunkt och klicka på respektive slutpunkt i fönstret Information.
Attribut för slutpunkten visas i den högra rutan för redigering.
Ta bort en standardslutpunktskonfiguration
Du kan ta bort en standardslutpunktskonfiguration på följande sätt:
Klicka för att expandera standardslutpunktsnoden och högerklicka på respektive undernod för slutpunkten. Använd kontextkommandot Ta bort standardslutpunktskonfiguration för att ta bort slutpunkten.
Klicka på noden Standardslutpunkt. I åtgärdsfönstret klickar du på Ta bort standardslutpunktskonfiguration.
Om standardslutpunkten används visas ett varningsmeddelande när du försöker ta bort den: Standardslutpunkten används. Om du tar bort den nu måste du ta bort alla dess referenser i andra delar av konfigurationen (till exempel i tjänstslutpunkten eller klientslutpunkten). Annars är konfigurationen ogiltig och kan inte öppnas nästa gång. Vill du ta bort standardslutpunkten?"
Bindning
Bindningskonfigurationer används för att konfigurera bindningar på slutpunkter. Sådana konfigurationsinställningar lagras i bindningsnoden. Slutpunkter refererar till bindningskonfigurationer efter namn och flera slutpunkter kan referera till en enda bindningskonfiguration.
Noden Bindningar visar alla bindningsinställningar i konfigurationsfilen. Varje undernod i trädet motsvarar ett underelement i elementet <bindings> i konfigurationsfilen.
När du klickar på noden Bindningar kan du visa eller utföra uppgifter på bindningssammanfattningssidan i informationsfönstret.
Skapa en ny bindningskonfiguration
Du kan skapa en ny bindningskonfiguration på följande sätt.
Högerklicka på noden Bindningar och välj Ny bindningskonfiguration... Välj bindningstypen i dialogrutan och klicka på OK.
Välj noden Bindningar och klicka på Ny bindningskonfiguration... i åtgärdsfönstret längst ned till vänster i fönstret.
På sidan tjänst- eller klientsammanfattning klickar du på Klicka för att skapa i fältet Bindningskonfiguration för att skapa en bindningskonfiguration för motsvarande slutpunkt.
Lägga till bindningselementtillägg till en anpassad bindning
Välj den bindning som du vill lägga till ett tilläggselement i.
Klicka på Lägg till.
I listan över tillgängliga tillägg väljer du det bindningselementtillägg som du vill lägga till. Om du vill markera flera objekt trycker du på CTRL-tangenten samtidigt.
Klicka på Lägg till.
Justera tilläggspositionen i en anpassad bindning
En anpassad bindning är en samling bindningselement som bildar en stack. Varje bindningselement i stacken har egna konfigurationsinställningar. Ordningen på bindningselementtilläggen i en anpassad bindning anger deras positioner i stacken. Element överst i stacken tillämpas först. Så här ändrar du ordningen:
Välj den anpassade bindningsnoden.
Välj ett bindningstilläggselement i avsnittet Bindningselementtilläggsposition .
Använd knappen Upp eller Ned till vänster i listan för att ändra positionen för det markerade elementet.
Redigera konfigurationen av bindningselementtillägg i en anpassad bindning
Välj bindningsnoden i trädet.
Välj den anpassade bindning som innehåller det element som du vill redigera.
Välj det bindningselementtillägg som du vill redigera. Inställningarna för elementet visas i den högra rutan, där de kan redigeras.
Diagnostik
Noden Diagnostik visar alla diagnostikinställningar i konfigurationsfilen. Det gör att du kan aktivera eller inaktivera prestandaräknare, aktivera eller inaktivera Windows Management Instrumentation (WMI), konfigurera WCF-spårning och konfigurera WCF-meddelandeloggning. Inställningarna i noden Diagnostik motsvarar <system.diagnostics> avsnittet och <diagnostics> avsnittet i <system.serviceModel> konfigurationsfilen.
När du klickar på noden Diagnostik kan du visa eller utföra uppgifter på sidan för diagnostiksammanfattning i informationsfönstret.
Konfigurera prestandaräknare och WMI
Klicka på noden Diagnostik.
Klicka på Växla prestandaräknare. Prestandaräknaren har tre tillstånd: Av (standard), ServiceOnly och Alla. Om du klickar på länken växlas inställningen mellan dessa tre tillstånd.
Konfigurera WMI-provider
Klicka på noden Diagnostik.
Om du vill aktivera WMI-provider klickar du på länken Aktivera WMI-provider .
Aktivera WCF-spårning
Du kan skapa en WCF-spårningsfil med standardegenskaper eller konfigurera en anpassad spårningsfil.
Klicka på noden Diagnostik.
Klicka på Aktivera spårning.
Klicka på länken Spårningsnivå för att justera spårningsnivån. Det finns sex spårningsnivåer: Off, Critical, Error, Warning, Information och Verbose. Med alternativet Aktivitetsspårning och spridningsaktivitet kan du använda funktionen för spårning av WCF-aktivitet.
Klicka på spårningslyssnarens namn för att ange spårningsfilen och alternativen.
Aktivera WCF-loggning
Du kan skapa en WCF-spårningsfil med standardegenskaper eller konfigurera en anpassad spårningsfil.
Klicka på noden Diagnostik.
Klicka på Aktivera meddelandeloggning.
Klicka på länken Loggnivå för att justera loggnivån. Det finns tre loggnivåer: Malformed, Service och Transport.
Klicka på lyssnarnamnet för att ange loggfilen och alternativen.
Kommentar
Om du vill att spårnings- och meddelandeloggarna ska rensas automatiskt när programmet stängs aktiverar du alternativet Automatisk tömning .
På sidan Diagnostiksammanfattning kan du utföra de vanligaste uppgifterna vid konfiguration av diagnostik. Men om du vill redigera inställningarna lyssnare och källor manuellt måste du expandera noden Diagnostik och redigera inställningarna i noden Meddelandeloggning, Lyssnare och Källor .
Aktivera anpassad spårning eller meddelandeloggning för WCF
Klicka på noden Diagnostik och expandera den.
Högerklicka på noden Lyssnare och välj Ny lyssnare.
Skriv in namnet på spårningsfilen i fältet InitData . Du kan klicka på "..." för att bläddra till en sökväg.
Om du klickar på typename-raden visas ett "..." knapp. Klicka på den här knappen för att öppna webbläsaren Spårningslyssnaretyp, som du kan använda för att hitta förkonfigurerade spårningslyssnare som redan är installerade.
Observera avsnittet Källa . Klicka på Lägg till i det här avsnittet för att öppna en dialogruta med en nedrullningsbara meny som visar tillgängliga spårningskällor. Välj en spårningskälla och klicka på OK.
Om du vill redigera inställningarna för meddelandeloggning klickar du på noden Meddelandeloggning . Du kan redigera inställningarna i egenskapsrutnätet.
Avancerad
Funktioner
Noden Beteenden visar de beteenden som för närvarande definieras i konfigurationsfilen.
Beteendekonfigurationer används för att konfigurera beteenden för slutpunkter och tjänster. Sådana konfigurationsinställningar lagras i noden Avancerat under Tjänstbeteenden och Slutpunktsbeteenden. Tjänstbeteenden används av tjänster. medan slutpunktsbeteenden efter slutpunkter.
Beteenden är en samling tilläggselement som för en stack. Elementet längst upp i stacken tillämpas först. Varje tilläggselement kan ha en egen konfiguration.
Skapa en ny beteendekonfiguration
Du kan skapa en ny beteendekonfiguration på två sätt.
Högerklicka på en av beteendenoderna och välj "Ny beteendekonfiguration...
Välj en av beteendenoderna och klicka på Konfiguration av nytt beteende... i åtgärdsfönstret längst ned till vänster i fönstret.
Lägga till beteendeelementtillägg i ett beteende
Välj en av beteendenoderna.
Välj det beteende som du vill redigera.
Klicka på Lägg till.
I listan över tillgängliga tillägg väljer du det beteendeelementtillägg som du vill lägga till.
Klicka på Lägg till.
Justera tilläggspositionen i ett beteende
Beteenden är samlingar av element som utgör en stack. Varje element i stacken har en egen konfiguration. Ordningen på beteendeelementtilläggen i ett beteende anger deras positioner i stacken. Element överst i stacken tillämpas först. Så här ändrar du ordningen:
Välj en av beteendenoderna.
Välj det beteende som du vill redigera.
Välj ett beteendetilläggselement i avsnittet Läge för beteendeelementtillägg.
Använd knappen Upp eller Ned till vänster i listan för att ändra positionen för det markerade elementet.
Redigera konfigurationen av beteendeelementtillägg
Välj en av beteendenoderna i trädet.
Välj det beteende som innehåller det element som du vill redigera.
Välj det beteendeelementtillägg som du vill redigera. Inställningarna för elementet visas i den högra rutan där de kan redigeras.
ProtocolMapping
I det här avsnittet kan du ange standardbindningstyper för olika protokoll, till exempel http, tcp, MSMQ eller net.pipe genom definierad mappning mellan protokolladressscheman och möjliga bindningar. Du kan också lägga till nya mappningar i andra protokoll.
Tillägg
Nya bindningstillägg, tillägg för bindningselement, standardslutpunktstillägg och beteendetillägg kan registreras för användning i WCF-konfiguration. Tillägg är namn/typpar. Namnet definierar namnet på tillägget i konfigurationen, medan typen implementerar tillägget. Det finns fyra typer av tillägg:
Bindningstillägg definierar en hel bindningstyp. Exempel:
basicHttpBinding.Bindningselementtillägg definierar ett element i en bindning. Exempel:
textMessageEncoding.Standardslutpunktstillägg definierar en hel standardslutpunkt. Exempel:
discoveryEndpoint.Beteendeelementtillägg definierar ett element i ett beteende. Exempel:
clientVia.
Tillägg som har registrerats i konfigurationen kan användas som andra WCF-komponenter av samma typ.
Lägga till ett nytt tillägg
Välj en av tilläggsnoderna i de avancerade noderna:
Klicka på Ny.
Ange ett namn och en typ.
Klicka på OK.
Tillägget visas nu på rätt plats i redigeraren. Om du till exempel lägger till ett tillägg för beteendeelement visas det i listan över tillgängliga tillägg.
Värdmiljö
I det här avsnittet kan du definiera instansieringsinställningar för tjänstvärdmiljön.
Skapa en konfigurationsfil med hjälp av guiden
Ett sätt att skapa en ny konfigurationsfil är att använda guiden Nytt tjänstelement. Guiden hittar de installerade tjänsttyperna och andra element som är kompatibla med WCF på datorn, inklusive COM+ och webbaserade virtuella kataloger, och läser in dem för att göra det mycket mer effektivt att skapa konfigurationen.
Skapa en konfigurationsfil
Starta Tjänstkonfigurationsredigeraren med hjälp av ett kommandofönster för att navigera till din WCF-installationsplats och skriv
SvcConfigEditor.exesedan .På arkivmenyn väljer du Öppna och klickar på Körbar, COM+ Service eller WebHosted Service, beroende på vilken typ av konfigurationsfil du vill skapa.
I dialogrutan Öppna navigerar du till den specifika fil som du vill skapa en konfigurationsfil för och dubbelklickar på den.
I menyn Arkiv pekar du på Lägg till nytt objekt och klickar på Tjänst. Guiden Nytt tjänstelement öppnas.
Följ stegen i guiden för att skapa den nya tjänsten.
Kommentar
Om du vill använda NetPeerTcpBinding från konfigurationsfilen som genereras av guiden måste du manuellt lägga till ett bindningskonfigurationselement och ändra mode attributet för dess security element till "Ingen".
Konfigurera COM+
Med Tjänstkonfigurationsredigeraren kan du skapa en ny konfigurationsfil för ett befintligt COM+-program eller redigera en befintlig COM+-konfiguration. COM Contract-noden visas bara när avsnittet <comContract> finns i konfigurationsfilen.
Skapa en ny COM+-konfiguration
Innan du skapar en ny COM+-konfiguration kontrollerar du att COM+-programmet är installerat i Component Services och registrerat i Global Assembly Cache (GAC).
Välj Arkiv-menyn ->Integrate ->COM+ Application. Den här åtgärden stänger den aktuella öppna filen. Om det finns data som inte har sparats i den aktuella filen visas dialogrutan Spara. Com+-integreringsguiden startas sedan.
På den första sidan väljer du COM+-programmet i trädet. Om du inte hittar ditt COM+-program i trädet kontrollerar du att det är installerat i Component Services och registrerats i Global Assembly Cache (GAC).
På nästa sida väljer du vilka metoder du vill exponera som WCF-tjänster. Alla metoder som stöds i COM+-programmet visas och väljs som standard.
Välj en värdmetod.
Konfigurera andra inställningar enligt guiderna i guiden.
Tjänstkonfigurationsredigeraren använder ComSvcConfig.exe i bakgrunden för att generera konfigurationsfilen. När detta har slutförts kan du visa en sammanfattning och avsluta guiden. Den genererade konfigurationsfilen öppnas så att du kan redigera den direkt.
Redigera en befintlig COM+-konfiguration
Välj Arkiv-menyn ->Open ->COM+ Service...
Välj den COM+-tjänst som du vill redigera i listan.
Redigera konfigurationsinställningar i COM Contracts-noden .
Kommentar
Du kan också öppna och redigera en konfigurationsfil som innehåller COM-kontrakt direkt.
Säkerhet
En tjänstkonfigurationsfil som genereras av konfigurationsredigeraren är inte garanterad att vara säker. Se säkerhetsdokumentationen för att ta reda på hur du skyddar dina WCF-tjänster.
Dessutom kan konfigurationsredigeraren endast användas för att läsa och skriva giltiga WCF-konfigurationselement. Verktyget ignorerar schemakompatibla, användardefinierade element. Det försöker inte heller ta bort dessa element från konfigurationsfilen eller fastställa deras effekter på de kända WCF-elementen. Det är användarens ansvar att avgöra om dessa element utgör ett hot mot programmet eller systemet.