Udostępnij za pośrednictwem


Narzędzie edytora konfiguracji (SvcConfigEditor.exe)

Edytor konfiguracji usługi Windows Communication Foundation (WCF) (SvcConfigEditor.exe) umożliwia administratorom i deweloperom tworzenie i modyfikowanie ustawień konfiguracji usług WCF przy użyciu graficznego interfejsu użytkownika. Za pomocą tego narzędzia można zarządzać ustawieniami powiązań, zachowań, usług i diagnostyki WCF bez konieczności bezpośredniego edytowania plików konfiguracji XML.

Edytor konfiguracji usługi można znaleźć w folderze C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin.

Edytor konfiguracji programu WCF

Edytor konfiguracji usługi zawiera kreatora, który przeprowadzi Cię przez wszystkie kroki konfigurowania usługi WCF lub klienta. Zdecydowanie zaleca się użycie kreatora zamiast bezpośredniego edytora.

Jeśli masz już pliki konfiguracji zgodne ze standardowym schematem System.Configuration, możesz zarządzać określonymi ustawieniami powiązań, zachowania, usług i diagnostyki za pomocą interfejsu użytkownika. Edytor konfiguracji usługi umożliwia zarządzanie ustawieniami istniejących plików konfiguracji programu WCF, a także plików wykonywalnych, usług COM+ i usług hostowanych w Sieci Web. Podczas otwierania usługi hostowanej w sieci Web za pomocą Edytora konfiguracji usługi wyświetlane są sekcje konfiguracji zarówno własnej usługi, jak i dziedziczone konfiguracje węzłów wyższego poziomu.

Ponieważ ustawienia konfiguracji programu WCF znajdują się w <system.serviceModel> sekcji pliku konfiguracji, edytor działa wyłącznie na zawartości tego elementu i nie uzyskuje dostępu do innych elementów w tym samym pliku. Możesz przejść bezpośrednio do istniejących plików konfiguracji lub wybrać zestaw zawierający usługę, katalog wirtualny lub usługę COM+. Edytor ładuje plik konfiguracji dla tej konkretnej usługi i umożliwia użytkownikowi dodanie nowych elementów lub edytowanie istniejących elementów zagnieżdżonych w <system.serviceModel> sekcji pliku konfiguracji.

Edytor obsługuje funkcję IntelliSense i wymusza zgodność schematu. Wynikowe dane wyjściowe mają gwarancję zgodności ze schematem pliku konfiguracji i mają składniowo poprawne wartości danych. Jednak edytor nie gwarantuje, że plik konfiguracji jest semantycznie prawidłowy. Innymi słowy, edytor nie gwarantuje, że plik konfiguracji może współpracować z usługą, którą konfiguruje.

Uwaga

Edytor nie może przeczyścić elementu konfiguracji z pliku konfiguracji po zmodyfikowaniu elementu. Jeśli na przykład użyjesz edytora, aby ustawić nazwę punktu końcowego na ciąg niepusty i zapisać go, plik konfiguracji ma następującą zawartość, jak pokazano w poniższym przykładzie.

<endpoint binding="basicHttpBinding" name="somename" />

Jeśli spróbujesz usunąć nazwę, ustawiając ją na pusty ciąg i zapiszesz plik, plik konfiguracji nadal zawiera name atrybut, jak pokazano w poniższym przykładzie.

<endpoint binding="basicHttpBinding" name="" />

Aby przeczyścić atrybut, należy ręcznie edytować element przy użyciu innego edytora tekstów.

Należy zachować szczególną ostrożność w przypadku korzystania z issueToken elementu zachowania punktu końcowego clientCredential . W szczególności address atrybut jego localIssuer elementu podrzędnego nie może być pustym ciągiem. Jeśli atrybut został address zmodyfikowany przy użyciu Edytora konfiguracji i chcesz go całkowicie usunąć, należy to zrobić za pomocą narzędzia innego niż Edytor. W przeciwnym razie atrybut zawiera pusty ciąg, a aplikacja zgłasza wyjątek.

Korzystanie z edytora konfiguracji

Edytor konfiguracji usługi można znaleźć w następującej lokalizacji instalacji zestawu Windows SDK:

C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin\SvcConfigEditor.exe

Po uruchomieniu Edytora konfiguracji usługi możesz użyć menu Plik/Otwórz , aby wyszukać usługę lub zestaw, którym chcesz zarządzać. Pliki konfiguracji można otwierać bezpośrednio, przeglądać usługi WCF /COM+ i otwierać pliki konfiguracji dla usług hostowanych w Sieci Web.

Interfejs użytkownika Edytora konfiguracji usługi jest podzielony na następujące obszary:

  • Okienko widoku drzewa, które wyświetla elementy konfiguracji w strukturze drzewa po lewej stronie. Operacje w drzewie można wykonywać, klikając prawym przyciskiem myszy węzły.

  • Okienko zadań, w którym są wyświetlane typowe zadania dla bieżących elementów w lewym dolnym rogu okna

  • Okienko szczegółów, które wyświetla szczegółowe ustawienia węzła konfiguracji wybranego w widoku drzewa po prawej stronie.

Otwieranie pliku konfiguracji

  1. Uruchom Edytor konfiguracji usługi przy użyciu okna poleceń, aby przejść do lokalizacji instalacji programu WCF, a następnie wpisz SvcConfigEditor.exe.

  2. W menu Plik wybierz pozycję Otwórz i kliknij typ pliku, którym chcesz zarządzać.

  3. W oknie dialogowym Otwieranie przejdź do określonego pliku, którym chcesz zarządzać, i kliknij go dwukrotnie.

Przeglądarka automatycznie śledzi ścieżkę scalania konfiguracji i tworzy widok scalonej konfiguracji. Na przykład rzeczywista konfiguracja usługi, która nie jest hostowana, jest kombinacją plików Machine.config i App.config. Wszelkie zmiany są stosowane do aktywnego pliku w SvcConfigEditor. Jeśli chcesz edytować określony plik w ścieżce scalania konfiguracji, otwórz go bezpośrednio.

Uwaga

Edytor konfiguracji ponownie ładuje aktualnie otwarty plik konfiguracji, gdy ten ostatni został zmodyfikowany poza edytorem. W takim przypadku wszystkie zmiany, które nie są trwale zapisywane w edytorze, zostaną utracone. Jeśli ponowne ładowanie odbywa się spójnie, najbardziej prawdopodobną przyczyną jest usługa, która stale uzyskuje dostęp do pliku konfiguracji, na przykład oprogramowania antywirusowego działającego w tle. Aby rozwiązać ten problem, upewnij się, że edytor konfiguracji jest jedynym procesem, który może uzyskać dostęp do pliku po jego otwarciu.

Usługi

Węzeł Usługi wyświetla wszystkie usługi aktualnie przypisane w pliku konfiguracji. Każdy węzeł podrzędny w drzewie odpowiada podelementowi <services> elementu w pliku konfiguracji.

Po kliknięciu węzła Usługi można wyświetlić lub wykonać zadania na stronie podsumowania usługi w okienku szczegółów .

Tworzenie nowej konfiguracji usługi

Nową konfigurację usługi można utworzyć w następujący sposób:

  • Za pomocą Kreatora: kliknij link Utwórz nową usługę... na stronie Okienko zadań lub Podsumowanie, aby uruchomić kreatora. Można to również zrobić w menu Plik -> Dodaj nowy element.

  • Utwórz ręcznie: możesz kliknąć prawym przyciskiem myszy węzeł Usługi i wybrać pozycję Nowa usługa.

Tworzenie nowej konfiguracji punktu końcowego usługi

Nową konfigurację punktu końcowego usługi można utworzyć na następujące sposoby:

  • Utwórz przy użyciu Kreatora: kliknij link Utwórz nowy punkt końcowy usługi... na stronie okienka zadań lub podsumowania, aby uruchomić kreatora. Można to również zrobić w menu Plik -> Dodaj nowy element.

  • Utwórz ręcznie: po utworzeniu usługi możesz kliknąć prawym przyciskiem myszy węzeł Punkty końcowe i wybrać pozycję "Nowy punkt końcowy usługi".

Edytowanie konfiguracji usługi

  1. Kliknij węzeł Usługa.

  2. Edytuj ustawienia w siatkach właściwości.

Edytowanie konfiguracji punktu końcowego usługi

  1. Kliknij węzeł Punkt końcowy usługi.

  2. Edytuj ustawienia w siatkach właściwości.

Dodawanie adresu podstawowego

  1. Kliknij węzeł Host.

  2. Kliknij przycisk Nowy... w sekcji Adresy podstawowe.

  3. Wpisz identyfikator URI adresu podstawowego w oknie dialogowym.

  4. Kliknij przycisk OK.

Uwaga

Nie można edytować wartości <baseAddressPrefixFilters> wewnątrz tego narzędzia. Aby dodać lub zmodyfikować ten element, należy użyć edytora tekstów lub programu Visual Studio.

Klient

Węzeł Klient wyświetla wszystkie punkty końcowe klienta w pliku konfiguracji. Każdy podwęźle w drzewie odpowiada podelementowi <client> elementu w pliku konfiguracji.

Po kliknięciu węzła Klient można wyświetlić lub wykonać zadania na stronie podsumowania klienta w okienku szczegółów.

Tworzenie nowej konfiguracji punktu końcowego klienta

Nową konfigurację punktu końcowego klienta można utworzyć w następujący sposób:

  • Utwórz według Kreatora: kliknij link Utwórz nowego klienta... w okienku zadań w lewym dolnym rogu okna lub na stronie podsumowania, aby uruchomić kreatora. Można to również zrobić w menu Plik -> Dodaj nowy element. Kreator monituje o wskazanie lokalizacji konfiguracji usługi, z której jest generowana konfiguracja klienta. Następnie możesz wybrać punkt końcowy usługi, z którym chcesz nawiązać połączenie.

  • Utwórz ręcznie: kliknij prawym przyciskiem myszy węzeł Punkty końcowe w obszarze Klient, a następnie wybierz pozycję Nowy punkt końcowy klienta.

Edytowanie konfiguracji punktu końcowego klienta

  1. Kliknij węzeł Punkt końcowy klienta.

  2. Edytuj ustawienia w siatkach właściwości.

Standardowy punkt końcowy

Standardowe punkty końcowe to wyspecjalizowane punkty końcowe, które mają co najmniej jeden aspekt adresu, kontraktu i powiązania ustawione na wartości domyślne.

Takie ustawienia konfiguracji są przechowywane w węźle Standardowy punkt końcowy . Węzeł Punkt końcowy w warstwie Standardowa wyświetla wszystkie standardowe ustawienia punktu końcowego w pliku konfiguracji. Każdy węzeł podrzędny w drzewie odpowiada elementowi podrzędnego w <standardEndpoints> elemecie w pliku konfiguracji.

Po kliknięciu węzła Standard Endpoint można wyświetlić lub wykonać zadania na standardowej stronie podsumowania punktu końcowego w okienku szczegółów.

Tworzenie nowej standardowej konfiguracji punktu końcowego

Nową standardową konfigurację punktu końcowego można utworzyć w następujący sposób:

  • Kliknij prawym przyciskiem myszy węzeł Standardowy punkt końcowy i wybierz pozycję Nowa konfiguracja standardowego punktu końcowego... Wybierz typ powiązania w oknie dialogowym i kliknij przycisk OK.

  • Wybierz węzeł Standardowy punkt końcowy i kliknij pozycję Nowa konfiguracja standardowego punktu końcowego... w okienku zadań w lewym dolnym rogu okna.

Zostanie wyświetlone okno dialogowe Tworzenie nowego standardowego punktu końcowego i wyświetli listę wszystkich zarejestrowanych standardowych typów punktów końcowych.

Wyświetlanie i edytowanie standardowej konfiguracji punktu końcowego

Możesz otworzyć standardową konfigurację punktu końcowego do wyświetlania i edytowania w następujący sposób:

  • Kliknij, aby rozwinąć węzeł Standardowy punkt końcowy i kliknąć odpowiedni podwęźle punktu końcowego.

  • Kliknij węzeł Standardowy punkt końcowy i kliknij odpowiedni punkt końcowy w okienku Szczegóły.

Atrybuty punktu końcowego są wyświetlane w okienku po prawej stronie do edycji.

Usuwanie standardowej konfiguracji punktu końcowego

Konfigurację standardowego punktu końcowego można usunąć w następujący sposób:

  • Kliknij, aby rozwinąć węzeł Standardowy punkt końcowy , a następnie kliknij prawym przyciskiem myszy odpowiedni podwęźle punktu końcowego. Użyj polecenia kontekstowego Usuń konfigurację standardowego punktu końcowego, aby usunąć punkt końcowy.

  • Kliknij węzeł Standardowy punkt końcowy. W okienku Zadanie kliknij pozycję Usuń konfigurację standardowego punktu końcowego.

Jeśli używany jest standardowy punkt końcowy, podczas próby usunięcia zostanie wyświetlony komunikat ostrzegawczy: Standardowy punkt końcowy jest używany. Jeśli usuniesz go teraz, pamiętaj o usunięciu wszystkich odwołań w innych częściach konfiguracji (na przykład w punkcie końcowym usługi lub punkcie końcowym klienta). W przeciwnym razie konfiguracja będzie nieprawidłowa i nie będzie można jej otworzyć następnym razem. Czy na pewno chcesz usunąć standardowy punkt końcowy?"

Wiązanie

Konfiguracje powiązań służą do konfigurowania powiązań w punktach końcowych. Takie ustawienia konfiguracji są przechowywane w węźle Powiązanie . Konfiguracje powiązań odwołań punktów końcowych według nazwy i wielu punktów końcowych mogą odwoływać się do jednej konfiguracji powiązania.

Węzeł Powiązania wyświetla wszystkie ustawienia powiązania w pliku konfiguracji. Każdy węzeł podrzędny w drzewie odpowiada elementowi podrzędnego w <bindings> elemecie w pliku konfiguracji.

Po kliknięciu węzła Powiązania można wyświetlić lub wykonać zadania na stronie podsumowania powiązania w okienku szczegółów.

Tworzenie nowej konfiguracji powiązania

Nową konfigurację powiązania można utworzyć na następujące sposoby.

  • Kliknij prawym przyciskiem myszy węzeł Powiązania i wybierz pozycję Nowa konfiguracja powiązania... Wybierz typ powiązania w oknie dialogowym i kliknij przycisk OK.

  • Wybierz węzeł Powiązania i kliknij pozycję Nowa konfiguracja powiązania... w okienku zadań w lewym dolnym rogu okna.

  • Na stronie podsumowania usługi lub klienta kliknij przycisk Kliknij, aby utworzyć w polu Konfiguracja powiązania , aby utworzyć konfigurację powiązania dla odpowiedniego punktu końcowego.

Dodawanie rozszerzeń elementu powiązania do powiązania niestandardowego

  1. Wybierz powiązanie, do którego chcesz dodać element rozszerzenia.

  2. Kliknij przycisk Dodaj.

  3. Z listy dostępnych rozszerzeń wybierz rozszerzenie elementu powiązania, które chcesz dodać. Aby zaznaczyć wiele elementów, naciśnij jednocześnie CTRL.

  4. Kliknij przycisk Dodaj.

Dostosowywanie położenia rozszerzenia w powiązaniu niestandardowym

Powiązanie niestandardowe to kolekcja elementów powiązania, które tworzą stos. Każdy element powiązania na stosie ma własne ustawienia konfiguracji. Kolejność rozszerzeń elementów powiązania w powiązaniu niestandardowym wskazuje ich pozycje w stosie. Elementy w górnej części stosu są stosowane najpierw. Aby zmienić kolejność:

  1. Wybierz węzeł powiązania niestandardowego.

  2. Wybierz jeden element rozszerzenia powiązania w sekcji Położenie rozszerzenia elementu powiązania.

  3. Użyj przycisku W górę lub w dół po lewej stronie listy, aby zmienić położenie wybranego elementu.

Edytowanie konfiguracji rozszerzeń elementów powiązania w powiązaniu niestandardowym

  1. Wybierz węzeł powiązania w drzewie.

  2. Wybierz powiązanie niestandardowe zawierające element, który chcesz edytować.

  3. Wybierz rozszerzenie elementu powiązania, które chcesz edytować. Ustawienia elementu są wyświetlane w okienku po prawej stronie, gdzie można je edytować.

Diagnostyka

Węzeł Diagnostyka wyświetla wszystkie ustawienia diagnostyczne w pliku konfiguracji. Umożliwia ona włączanie lub wyłączanie liczników wydajności, włączanie lub wyłączanie instrumentacji zarządzania Windows (WMI), konfigurowanie śledzenia WCF i konfigurowanie rejestrowania komunikatów programu WCF. Ustawienia w węźle Diagnostyka odpowiadają <system.diagnostics> sekcji i <diagnostics> sekcji w <system.serviceModel> pliku konfiguracji.

Po kliknięciu węzła Diagnostyka można wyświetlić lub wykonać zadania na stronie podsumowania diagnostyki w okienku szczegółów.

Konfigurowanie liczników wydajności i usługi WMI

  1. Kliknij węzeł Diagnostyka.

  2. Kliknij pozycję Przełącz liczniki wydajności. Licznik wydajności ma trzy stany: Wyłączone (ustawienie domyślne), ServiceOnly i All. Kliknięcie linku przełącza ustawienie między tymi trzema stanami.

Konfigurowanie dostawcy WMI

  1. Kliknij węzeł Diagnostyka.

  2. Aby włączyć dostawcę usługi WMI, kliknij link Włącz dostawcę WMI.

Włączanie śledzenia WCF

Możesz utworzyć plik śledzenia WCF ze standardowymi właściwościami lub skonfigurować niestandardowy plik śledzenia.

  1. Kliknij węzeł Diagnostyka.

  2. Kliknij pozycję Włącz śledzenie.

  3. Kliknij link Poziom śledzenia, aby dostosować poziom śledzenia. Istnieją sześć poziomów śledzenia: Wyłączone, Krytyczne, Błąd, Ostrzeżenie, Informacje i Pełne. Opcja Śledzenie działań i propagacja działania umożliwia korzystanie z funkcji śledzenia działań WCF.

  4. Kliknij nazwę odbiornika śledzenia, aby określić plik śledzenia i opcje.

Włączanie rejestrowania WCF

Możesz utworzyć plik śledzenia WCF ze standardowymi właściwościami lub skonfigurować niestandardowy plik śledzenia.

  1. Kliknij węzeł Diagnostyka.

  2. Kliknij pozycję Włącz rejestrowanie komunikatów.

  3. Kliknij link Poziom dziennika, aby dostosować poziom dziennika. Istnieją trzy poziomy dziennika: Źle sformułowane, Usługi i Transport.

  4. Kliknij nazwę odbiornika, aby określić plik dziennika i opcje.

Uwaga

Jeśli chcesz, aby dzienniki śledzenia i komunikatów zostały automatycznie opróżnione po zamknięciu aplikacji, włącz opcję Automatyczne opróżnianie .

Strona podsumowania diagnostyki umożliwia wykonywanie najbardziej typowych zadań w konfigurowaniu diagnostyki. Jeśli jednak chcesz ręcznie edytować ustawienia Odbiorniki i Źródła, musisz rozwinąć węzeł Diagnostyka i edytować ustawienia w węźle Rejestrowanie komunikatów, Odbiorniki i Źródła .

Włączanie niestandardowego śledzenia lub rejestrowania komunikatów WCF

  1. Kliknij węzeł Diagnostyka i rozwiń go.

  2. Kliknij prawym przyciskiem myszy węzeł Odbiorniki i wybierz pozycję Nowy odbiornik.

  3. Wpisz nazwę pliku śledzenia w polu InitData . Możesz kliknąć przycisk "..." przycisk, aby przejść do ścieżki.

  4. Kliknięcie wiersza TypeName powoduje wyświetlenie ciągu "..." guzik. Kliknij ten przycisk, aby otworzyć przeglądarkę typów odbiornika śledzenia, której można użyć do znalezienia wstępnie skonfigurowanych odbiorników śledzenia, które są już zainstalowane.

  5. Zanotuj sekcję Źródło . Kliknij przycisk Dodaj w tej sekcji, aby otworzyć okno dialogowe z menu rozwijanego, które zawiera listę dostępnych źródeł śledzenia. Wybierz źródło śledzenia i kliknij przycisk OK.

  6. Aby edytować ustawienia rejestrowania komunikatów, kliknij węzeł Rejestrowanie komunikatów. Ustawienia można edytować w siatce właściwości.

Zaawansowani

Zachowania

Węzeł Zachowania wyświetla zachowania, które są obecnie zdefiniowane w pliku konfiguracji.

Konfiguracje zachowania służą do konfigurowania zachowań punktów końcowych i usług. Takie ustawienia konfiguracji są przechowywane w węźle Zaawansowane w obszarze Zachowania usługi i Zachowania punktu końcowego. Zachowania usług są używane przez usługi; podczas gdy zachowania punktów końcowych według punktów końcowych.

Zachowania to kolekcja elementów rozszerzenia, które są przeznaczone dla stosu. Element w górnej części stosu jest stosowany jako pierwszy. Każdy element rozszerzenia może mieć własną konfigurację.

Tworzenie nowej konfiguracji zachowania

Nową konfigurację zachowania można utworzyć na dwa sposoby.

  • Kliknij prawym przyciskiem myszy jeden z węzłów zachowania i wybierz pozycję "Nowa konfiguracja zachowania...

  • Wybierz jeden z węzłów zachowania i kliknij pozycję Nowa konfiguracja zachowania... w okienku zadań w lewym dolnym rogu okna.

Dodawanie rozszerzeń elementów zachowania do zachowania
  1. Wybierz jeden z węzłów zachowania.

  2. Wybierz zachowanie, które chcesz edytować.

  3. Kliknij przycisk Dodaj.

  4. Z listy dostępnych rozszerzeń wybierz rozszerzenie elementu zachowania, które chcesz dodać.

  5. Kliknij przycisk Dodaj.

Dostosowywanie położenia rozszerzenia w zachowaniu

Zachowania to kolekcje elementów, które tworzą stos. Każdy element na stosie ma własną konfigurację. Kolejność rozszerzeń elementów zachowania w zachowaniu wskazuje ich pozycje w stosie. Elementy w górnej części stosu są stosowane najpierw. Aby zmienić kolejność:

  1. Wybierz jeden z węzłów zachowania.

  2. Wybierz zachowanie, które chcesz edytować.

  3. Wybierz element rozszerzenia zachowania w sekcji Zachowanie Pozycji rozszerzenia elementu.

  4. Użyj przycisku W górę lub w dół po lewej stronie listy, aby zmienić położenie wybranego elementu.

Edytowanie konfiguracji rozszerzeń elementów zachowania
  1. Wybierz jeden z węzłów zachowania w drzewie.

  2. Wybierz zachowanie zawierające element, który chcesz edytować.

  3. Wybierz rozszerzenie elementu zachowania, które chcesz edytować. Ustawienia elementu są wyświetlane w okienku po prawej stronie, w którym można je edytować.

ProtocolMapping

Ta sekcja umożliwia ustawienie domyślnych typów powiązań dla różnych protokołów, takich jak http, tcp, MSMQ lub net.pipe za pomocą zdefiniowanego mapowania między schematami adresów protokołu i możliwymi powiązaniami. Można również dodać nowe mapowania do innych protokołów.

Rozszerzenia

Nowe rozszerzenia powiązań, rozszerzenia elementów powiązania, standardowe rozszerzenia punktu końcowego i rozszerzenia zachowania można zarejestrować do użycia w konfiguracji programu WCF. Rozszerzenia to pary nazw/typów. Nazwa definiuje nazwę rozszerzenia w konfiguracji, podczas gdy typ implementuje rozszerzenie. Istnieją cztery typy rozszerzeń:

  • Rozszerzenia powiązań definiują cały typ powiązania. Przykład: basicHttpBinding.

  • Rozszerzenia elementów powiązania definiują element powiązania. Przykład: textMessageEncoding.

  • Standardowe rozszerzenia punktu końcowego definiują cały standardowy punkt końcowy. Przykład: discoveryEndpoint.

  • Rozszerzenia elementów zachowania definiują element zachowania. Przykład: clientVia.

Rozszerzenia, które zostały zarejestrowane w konfiguracji, mogą być używane jak każdy inny składnik WCF tego samego typu.

Dodawanie nowego rozszerzenia

Wybierz jeden z węzłów rozszerzenia w węzłach zaawansowanych:

  1. Kliknij przycisk Nowy.

  2. Wprowadź nazwę i typ.

  3. Kliknij przycisk OK.

  4. Rozszerzenie jest teraz wyświetlane w odpowiednim miejscu w edytorze. Jeśli na przykład dodasz rozszerzenie elementu zachowania, zostanie ono wyświetlone na liście dostępnych rozszerzeń.

Środowisko hostingu

Ta sekcja umożliwia zdefiniowanie ustawień wystąpienia dla środowiska hostingu usług.

Tworzenie pliku konfiguracji przy użyciu kreatora

Jednym ze sposobów utworzenia nowego pliku konfiguracji jest użycie Kreatora nowego elementu usługi. Kreator odnajduje zainstalowane typy usług i inne elementy zgodne z usługą WCF na komputerze, w tym katalogi wirtualne COM+ i hostowane w Internecie, i ładuje je, aby utworzyć konfigurację znacznie bardziej usprawnione.

Tworzenie pliku konfiguracji

  1. Uruchom Edytor konfiguracji usługi przy użyciu okna poleceń, aby przejść do lokalizacji instalacji programu WCF, a następnie wpisz SvcConfigEditor.exe.

  2. W menu Plik wybierz pozycję Otwórz i kliknij pozycję Plik wykonywalny, com+ usługa lub usługa WebHosted, w zależności od typu pliku konfiguracji, który chcesz utworzyć.

  3. W oknie dialogowym Otwieranie przejdź do określonego pliku, dla którego chcesz utworzyć plik konfiguracji, i kliknij go dwukrotnie.

  4. W menu Plik wskaż polecenie Dodaj nowy element i kliknij pozycję Usługa. Zostanie otwarty Kreator nowego elementu usługi.

  5. Wykonaj kroki kreatora, aby utworzyć nową usługę.

Uwaga

Jeśli chcesz użyć narzędzia NetPeerTcpBinding z pliku konfiguracji wygenerowanego przez Kreatora, musisz ręcznie dodać element konfiguracji powiązania i zmodyfikować mode atrybut jego security elementu na "None".

Konfigurowanie modelu COM+

Edytor konfiguracji usługi umożliwia utworzenie nowego pliku konfiguracji dla istniejącej aplikacji COM+ lub edytowanie istniejącej konfiguracji MODELU COM+. Węzeł kontraktu COM jest widoczny tylko wtedy, gdy <comContract> sekcja istnieje w pliku konfiguracji.

Tworzenie nowej konfiguracji modelu COM+

Przed utworzeniem nowej konfiguracji modelu COM+ upewnij się, że aplikacja COM+ jest zainstalowana w usługach składników i zarejestrowana w globalnej pamięci podręcznej zestawów (GAC).

  1. Wybierz menu Plik -> Integruj ->COM+ Aplikacja. Ta operacja zamyka bieżący otwarty plik. Jeśli w bieżącym pliku znajdują się niezapisane dane, zostanie wyświetlone okno dialogowe Zapisywanie. Następnie zostanie uruchomiony Kreator integracji MODELU COM+.

  2. Na pierwszej stronie wybierz aplikację COM+ z drzewa. Jeśli nie możesz znaleźć aplikacji COM+ w drzewie, sprawdź, czy jest ona zainstalowana w usługach składników i zarejestrowana w globalnej pamięci podręcznej zestawów (GAC).

  3. Na następnej stronie wybierz metody, które chcesz uwidocznić jako usługi WCF. Wszystkie obsługiwane metody w aplikacji COM+ są wyświetlane i wybierane domyślnie.

  4. Wybierz metodę hostingu.

  5. Skonfiguruj inne ustawienia zgodnie z przewodnikami w kreatorze.

  6. Edytor konfiguracji usługi używa ComSvcConfig.exe w tle do generowania pliku konfiguracji. Po zakończeniu tego działania możesz wyświetlić podsumowanie i zamknąć kreatora. Wygenerowany plik konfiguracji jest otwarty, aby można było go edytować bezpośrednio.

Edytowanie istniejącej konfiguracji modelu COM+

  1. Wybierz menu Plik ->Otwórz ->COM+ Usługa...

  2. Wybierz usługę COM+, którą chcesz edytować z listy.

  3. Edytuj ustawienia konfiguracji w węźle Kontrakty COM.

    Uwaga

    Możesz również bezpośrednio otworzyć i edytować plik konfiguracji zawierający kontrakty COM.

Zabezpieczenia

Plik konfiguracji usługi wygenerowany przez Edytor konfiguracji nie ma gwarancji bezpieczeństwa. Zapoznaj się z dokumentacją zabezpieczeń , aby dowiedzieć się, jak zabezpieczyć usługi WCF.

Ponadto edytor konfiguracji może służyć tylko do odczytywania i zapisywania prawidłowych elementów konfiguracji programu WCF. Narzędzie ignoruje elementy zgodne ze schematem, zdefiniowane przez użytkownika. Nie podejmuje również próby usunięcia tych elementów z pliku konfiguracji ani określenia ich wpływu na znane elementy WCF. Użytkownik jest odpowiedzialny za ustalenie, czy te elementy stanowią zagrożenie dla aplikacji, czy systemu.