WCF Hizmet Ana Bilgisayarı (WcfSvcHost.exe)
Windows Communication Foundation (WCF) Hizmet Konağı (WcfSvcHost.exe), uyguladığınız bir hizmeti otomatik olarak barındırmak ve test etmek için Visual Studio hata ayıklayıcısını (F5) başlatmanıza olanak tanır. Ardından, olası hataları bulmak ve düzeltmek için WCF Test İstemcisi'ni (WcfTestClient.exe) veya kendi istemcinizi kullanarak hizmeti test edebilirsiniz.
WCF Hizmet Konağı
WCF Hizmet Konağı bir WCF hizmet projesindeki hizmetleri numaralandırır, projenin yapılandırmasını yükler ve bulduğu her hizmet için bir konak oluşturur. Araç, WCF Hizmeti şablonu aracılığıyla Visual Studio ile tümleşiktir ve projenizde hata ayıklamaya başladığınızda çağrılır.
WCF Hizmet Konağı kullanarak, ek kod yazmadan veya geliştirme sırasında belirli bir konağa işleme yapmadan bir WCF hizmetini (WCF hizmet kitaplığı projesinde) barındırabilirsiniz.
Not
WCF Hizmet Konağı Kısmi Güven'i desteklemez. Kısmi Güven'de bir WCF Hizmeti kullanmak istiyorsanız, hizmetinizi oluşturmak için Visual Studio'daki WCF Hizmet Kitaplığı Proje şablonunu kullanmayın. Bunun yerine, HIZMETI WCF Kısmi Güven'in desteklendiği bir WebSunucusunda barındırabilen WCF Hizmeti Web Sitesi şablonunu seçerek Visual Studio'da Yeni Bir Web Sitesi oluşturun.
WCF Hizmet Konağı tarafından barındırılan Proje Türleri
WCF Hizmet Konağı şu WCF hizmet kitaplığı proje türlerini barındırabilir: WCF Hizmet Kitaplığı, Sıralı İş Akışı Hizmet Kitaplığı, Durum Makinesi İş Akışı Hizmet Kitaplığı ve Dağıtım Hizmeti Kitaplığı. WCF Hizmet Konağı, Öğe Ekle işlevi kullanılarak bir hizmet kitaplığı projesine eklenebilen hizmetleri de barındırabilir. Buna WCF Hizmeti, WF Durum Makine Hizmeti, WF Sıralı Hizmeti, XAML WF Durum Makine Hizmeti ve XAML WF Sıralı Hizmeti dahildir.
Ancak aracın bir konağı yapılandırmanıza yardımcı olmadığını unutmayın. Bu görev için App.config dosyasını el ile düzenlemeniz gerekir. Araç ayrıca kullanıcı tanımlı yapılandırma dosyalarını doğrulamaz.
Dikkat
Bu amaçla tasarlanmış olmadığından, hizmetleri bir üretim ortamında barındırmak için WCF Hizmet Konağı kullanmamalısınız. WCF Hizmet Konağı, böyle bir ortamın güvenilirlik, güvenlik ve yönetilebilirlik gereksinimlerini desteklemez. Bunun yerine, üstün güvenilirlik ve izleme özellikleri sağladığından ve barındırma hizmetleri için tercih edilen çözüm olduğundan IIS kullanın. Hizmetlerinizin geliştirilmesi tamamlandıktan sonra, hizmetleri WCF Hizmet Konağından IIS'ye geçirmeniz gerekir.
Visual Studio'da WCF Hizmet Konağı Kullanma Senaryoları
Aşağıdaki tabloda, Visual Studio'da Çözüm Gezgini'nde projenize sağ tıklayıp Özellikler'i ve ardından Hata Ayıkla sekmesini seçip Projeyi Başlat'a tıklayarak bulunabilen Komut satırı bağımsız değişkenleri iletişim kutusundaki tüm parametreler listelenmektedir. Bu parametreler WCF Hizmet Konağı'nın yapılandırılmasında yararlıdır.
| Parametre | Anlamı |
|---|---|
/client |
Hizmetler barındırıldıktan sonra çalıştırılacak yürütülebilir dosyanın yolunu belirten isteğe bağlı bir parametre. Bu, barındırma sonrasında WCF Test İstemcisi'nin başlatılmasını sağlar. |
/clientArg |
Özel istemci uygulamasına geçirilen bağımsız değişken olarak bir dize belirtin. |
/? |
Yardım metnini görüntüler. |
WCF Test İstemcisi Kullanma
Yeni bir WCF hizmet projesi oluşturduktan ve hata ayıklayıcıyı başlatmak için F5 tuşuna bastıktan sonra, WCF Hizmet Konağı projenizde bulduğu tüm hizmetleri barındırmaya başlar. WCF Test İstemcisi otomatik olarak açılır ve yapılandırma dosyasında tanımlanan hizmet uç noktalarının listesini görüntüler. Ana pencerede parametreleri test edebilir ve hizmetinizi çağırabilirsiniz.
WCF Test İstemcisi'nin kullanıldığından emin olmak için Visual Studio'da Çözüm Gezgini'nde projenize sağ tıklayın, Özellikler'i seçin ve ardından Hata Ayıkla sekmesini seçin. Projeyi Başlat'a tıklayın ve Komut satırı bağımsız değişkenleri iletişim kutusunda aşağıdakilerin göründüğünden emin olun.
/client:WcfTestClient.exe
Özel İstemci Kullanma
Özel istemci kullanmak için, Visual Studio'da Çözüm Gezgini'nde projenize sağ tıklayın, Özellikler'i seçin ve ardından Hata Ayıkla sekmesini seçin. Projeyi Başlat'a tıklayın ve komut satırı bağımsız değişkenleri iletişim kutusunda parametreyi düzenleyerek /client aşağıdaki örnekte gösterildiği gibi özel istemcinize işaret edin.
/client:"path/CustomClient.exe"
Hizmeti yeniden başlatmak için F5 tuşuna bastığınızda, hata ayıklayıcıyı başlattığınızda WCF Hizmet Ana Bilgisayarı özel istemcinizi otomatik olarak başlatır.
Aşağıdaki örnekte gösterildiği gibi, özel istemci uygulamasına geçirilen bir bağımsız değişken olarak bir dize belirtmek için parametresini de kullanabilirsiniz /clientArg: .
/client:"path/CustomClient.exe" /clientArg:"arguments that are passed to Client"
Örneğin, Dağıtım Hizmeti Kitaplığı şablonunu kullanıyorsanız aşağıdaki komut satırı bağımsız değişkenlerini kullanabilirsiniz:
/client:iexplore.exe /clientArgs:http://localhost:8731/Design_Time_Addresses/Feed1/
İstemci Belirtme
WCF hizmeti barındırıldıktan sonra hiçbir istemcinin kullanılmayacağını belirtmek için Visual Studio'da Çözüm Gezgini'nde projenize sağ tıklayın, Özellikler'i seçin ve ardından Hata Ayıkla sekmesini seçin. Projeyi Başlat'a tıklayın ve Komut satırı bağımsız değişkenleri iletişim kutusunu boş bırakın.
Özel Konak Kullanma
Özel bir ana bilgisayar kullanmak için Visual Studio'da Çözüm Gezgini'nde projenize sağ tıklayın, Özellikler'i seçin, ardından Hata Ayıkla sekmesini seçin. Dış Programı Başlat'a tıklayın ve özel konağın tam yolunu girin. Konağa geçirilecek bağımsız değişkenleri belirtmek için Komut satırı bağımsız değişkenleri iletişim kutusunu da kullanabilirsiniz.
WCF Hizmeti Ana Bilgisayarı Kullanıcı Arabirimi
WCF Hizmet Konağı'nı ilk kez çağırdığınızda (Visual Studio'da F5 tuşuna basarak), WCF Hizmet Konağı penceresi otomatik olarak açılır. WCF Hizmet Konağı çalışırken, bildirim alanında programın simgesi görüntülenir. WCF Hizmeti Ana Bilgisayarı penceresini açmak için simgeye çift tıklayın
Hizmet barındırma sırasında hatalar oluştuğunda, ilgili bilgileri görüntülemek için WCF Hizmet Konağı iletişim kutusu açılır.
WCF Hizmet Ana Bilgisayarı ana penceresi iki menü içerir:
Dosya: Kapat ve Çık komutlarını içerir. Kapat'a tıkladığınızda, WCF Hizmet Konağı iletişim kutusu kapanır, ancak hizmetler barındırılmaya devam eder. Çıkış'a tıkladığınızda WCF Hizmet Konağı da kapatılır. Bu, barındırılan tüm hizmetleri de durdurur.
Yardım: Sürüm bilgilerini içeren Hakkında komutunu içerir. Ayrıca, bir yardım dosyasını açabilen Yardım komutunu içerir.
Ana WCF Hizmet Konağı penceresi iki alan içerir:
İlk alan Hizmet'tir. Tüm hizmetlerin temel bilgilerini görüntüleyen bir liste içerir. Bilgiler şunları içerir:
Hizmet: Tüm hizmetleri listeler.
Durum: Hizmetin durumunu listeler. Geçerli değerler "Başlatıldı", "Durduruldu" ve "Hata" değerleridir.
Meta Veri Adresi: Hizmetlerin meta veri adresini görüntüler.
İkinci alan Ek Bilgiler'dir. Hizmet alanında belirli bir hizmet satırı seçildiğinde hizmet durumunun ayrıntılı bir açıklamasını görüntüler. Durum Hata ise, ekranda tam hata iletisini görüntüleyebilirsiniz.
WCF Hizmet Ana Bilgisayarı Durduruluyor
WCF Hizmet Ana Bilgisayarı'nı aşağıdaki dört yolla kapatabilirsiniz:
Visual Studio'da hata ayıklama oturumunu durdurun.
WCF Hizmeti Ana Bilgisayarı penceresindeki Dosya menüsünden Çık'ı seçin.
Sistem bildirim alanında WCF Hizmeti Ana Bilgisayar tepsisi simgesinin bağlam menüsünden çık'ı seçin.
Kullanılıyorsa WCF Test İstemcisi'ne çıkın.
Yönetici istrator ayrıcalığı olmadan Hizmet Ana Bilgisayarı kullanma
Yönetici ayrıcalığı olmayan kullanıcıların WCF hizmetleri geliştirmesini sağlamak için " ad alanıhttp://+:8731/Design_Time_Addresses" için bir ACL (Erişim Denetim Listesi) oluşturulur; visual studio yüklemesi sırasında. ACL, makinede oturum açmış tüm etkileşimli kullanıcıları içeren (UI) olarak ayarlanır. Yönetici istrator'lar bu ACL'ye kullanıcı ekleyebilir veya kaldırabilir ya da ek bağlantı noktaları açabilir. Bu ACL, kullanıcıların kendilerine yönetici ayrıcalıkları vermeden WCF Hizmeti Otomatik Ana Bilgisayarı'nı (wcfSvcHost.exe) kullanmasına olanak tanır.
Yükseltilmiş yönetici hesabı altında Windows Vista'daki netsh.exe aracını kullanarak erişimi değiştirebilirsiniz. Aşağıda netsh.exe kullanımına bir örnek verilmiştir.
netsh http add urlacl url=http://+:8001/MyService user=<domain>\<user>
netsh.exe hakkında daha fazla bilgi için bkz. "Netsh.exe Aracı ve Komut Satırı Anahtarlarını Kullanma".