WCF Test İstemcisi (WcfTestClient.exe)
Windows Communication Foundation (WCF) Test İstemcisi (WcfTestClient.exe), kullanıcıların test parametrelerini girip bu girişi hizmete göndermesini ve hizmetin geri gönderdiği yanıtı görüntülemesini sağlayan bir GUI aracıdır. WCF Hizmet Konağı ile birleştirildiğinde sorunsuz bir hizmet testi deneyimi sağlar.
WCF Test İstemcisi'ni (WcfTestClient.exe) genellikle şu konumda bulabilirsiniz: C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE - Topluluk, Visual Studio'nun hangi düzeyine yüklendiğine bağlı olarak "Kurumsal", "Profesyonel" veya "Topluluk" türlerinden biri olabilir.
Test İstemcisi Kullanma Senaryoları
Aşağıdaki bölümlerde, geliştirme sürecinizi kolaylaştırmak için WCF Test İstemcisi'ni kullanabileceğiniz en yaygın senaryolar açıklanmıştır.
Visual Studio'da
WCF Hizmet Ana Bilgisayarı TEK Bir Hizmetle WCF Test İstemcisi Başlatır
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ğı hizmeti projenizde barındırmaya başlar. Ardından WCF Test İstemcisi açılır ve yapılandırma dosyasında tanımlanan hizmet uç noktalarının listesini görüntüler. Parametreleri test edebilir, hizmeti çağırabilir ve hizmetinizi sürekli test etmek ve doğrulamak için bu işlemi yineleyebilirsiniz.
WCF Hizmet Ana Bilgisayarı, WCF Test İstemcisi'nin Birden Çok Hizmetle Başlatılmasını Sağlar
Birden çok hizmet içeren bir hizmet projesinde hata ayıklamaya yardımcı olması için WCF Test İstemcisi'ni de kullanabilirsiniz. WCF Test İstemcisi açıldığında, projenizdeki hizmetlerin listesini otomatik olarak yineler ve test için açar.
Visual Studio Dışında
Ayrıca, İnternet'te rastgele bir hizmeti test etmek için Visual Studio dışında WCF Test İstemcisi'ni (WcfTestClient.exe) çağırabilirsiniz. Aracı bulmak için aşağıdaki konuma gidin:
C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE (burada topluluk, makinede hangi Visual Studio düzeyinin yüklü olduğuna bağlı olarak "Kurumsal", "Profesyonel" veya "Topluluk" türlerinden biri olabilir)
Aracı kullanmak için dosya adına çift tıklayarak bu konumdan açın veya bir komut satırından başlatın.
WCF Test İstemcisi, komut satırı bağımsız değişkenleri olarak rastgele sayıda URI alır. Bunlar test edilebilen hizmetlerin URI'leridir.
wcfTestClient.exe URI1 URI2 …
WCF Test İstemcisi penceresi açıldıktan sonra Dosya-Hizmet> Ekle'ye tıklayın ve açmak istediğiniz hizmetin uç nokta adresini girin.
WCF Test İstemcisi Kullanıcı Arabirimi
WCF Test İstemcisi'ni tek bir hizmetle veya birden çok hizmetle kullanabilirsiniz.
Hizmet İşlemleri
WCF Test İstemcisi ana penceresinin sol bölmesinde, ilgili uç noktaları ve işlemleriyle birlikte tüm kullanılabilir hizmetler listelenir.
Bir işleme çift tıkladığınızda, sağ bölmede işlemin adını içeren yeni bir sekmenin içinde içeriğini görüntüleyebilirsiniz.
Sol bölmede istemci yapılandırma dosyaları da listelenir. Sağ bölmedeki yeni bir sekmeli pencerede dosyanın içeriğini görüntülemek için öğelerden herhangi birine çift tıklayın.
Test Parametrelerini Girme
Test parametrelerini görüntülemek için, sağ bölmede açmak üzere bir işleme çift tıklayın. Parametreler varsayılan olarak Biçimlendirilmiş görünümde gösterilir ve hizmeti test etmek için parametreler için rastgele değerler girebilirsiniz.
İletinin XML'sini görüntülemek için XML'e tıklayın. Bunları hizmete göndermek için Çağır'a tıklayın.
DataSet parametresi için, DataGrid'i gösteren yeni bir pencerede düzenlemek için Düzenle... öğesinin yanındaki ... düğmesine tıklayın. DataSet Kopyala ve Veri Kümesini Yapıştır düğmelerinin görünümüne dikkat edin. DataSet nesnesinin şeması ilk düzenlemede bilinmiyorsa DataGrid boş olur. Aynı şemaya sahip bir DataSet nesnesini DataGrid'deki geçerli nesneye yapıştırmanız gerekir. (Yapıştırma işleminden önce şemayı başka bir yerden kopyalamanız gerektiğini fark edin.) Veri Kümesini Kopyala düğmesine tıklayarak gelecekte kullanılmak üzere bir Veri Kümesi nesnesini de kopyalayabilirsiniz.
Hizmetin yanıtı test parametrelerinin altında görünür.
Not
Beklenen dönüş değeri bir dizeyse, sağlanan giriş tırnak içinde olmasa bile sonuç tırnak içinde bir dize olarak görüntülenir.
Hizmet için sözleşmeyi oluştururken belirli bir işlemi tek yönlü olarak belirttiyseniz, hizmet yanıtı görüntülenmez. İleti teslim için kuyruğa alınır gönderilmez, iletinin başarıyla gönderildiğini bildiren bir iletişim kutusu açılır.
Oturum Desteği
Hizmet işleminin sekmesindeki Yeni ara sunucu başlat onay kutusu, oturum desteğini değiştirmenizi sağlar. Bu kutu varsayılan olarak temizlenir.
Belirli bir işlem (veya aynı hizmet uç noktasında başka bir işlem) için test parametreleri girdiğinizde ve onay kutusu işaretli değilken birden çok kez çağır'a tıkladığınızda, bu işlemler bir ara sunucuyu paylaşır ve hizmet durumu birden çok işlemde kalıcı hale gelir.
Yeni ara sunucu başlat onay kutusu işaretliyse, her Invoke için yeni bir ara sunucu başlatılır, önceki oturum senaryosu sonlandırılır ve hizmet durumu sıfırlanır.
İstemci Yapılandırmasını Düzenleme
WCF Test İstemcisi ana penceresinin sol bölmesinde istemci yapılandırma dosyaları listelenir. Sağ bölmede dosyanın içeriğini görüntülemek için öğelerden herhangi birine çift tıklayın.
Hizmet Yapılandırma Düzenleyicisi ile Düzenle
Sol bölmede Yapılandırma Dosyası'na sağ tıklayın ve SvcConfigEditor ile düzenle bağlam menüsünü seçin. Hizmet Yapılandırma Düzenleyicisi, istemci yapılandırma içeriğiyle başlatılır. Yapılandırmayı düzenleyebilir ve araç içinde kaydedebilirsiniz.
Dosyayı Hizmet Yapılandırma Düzenleyicisi'ne kaydettikten sonra WCF Test İstemcisi, dosyanın dışarıda değiştirildiğini bildiren bir uyarı iletisi görüntüler ve dosyayı yeniden yüklemek isteyip istemediğinizi sorar.
Evet'i seçerseniz, "Client.dll.config" sekmesindeki yapılandırma içeriği düzenleyicide yaptığınız değişiklikleri yansıtır.
Hayır'ı seçerseniz, "Client.dll.config" sekmesindeki yapılandırma içeriği değişmeden kalır ve değiştirilen içerik otomatik olarak kaynak dosyaya kaydedilir.
Varsayılan Yapılandırmaya Geri Yükle
Tüm değişiklikleri iptal etmek ve varsayılan istemci yapılandırmasına geri yüklemek istiyorsanız, sol bölmede Yapılandırma Dosyası'na sağ tıklayın ve Varsayılan Yapılandırmaya Geri Yükle bağlam menüsünü seçin. Varsayılan yapılandırma değeri yüklenir ve "Client.dll.config" sekmesindeki içerik geri yüklenir.
Değişiklikleri Doğrula
Kaydedilmiş değişiklikler WCF Test İstemcisi'ne yüklendiğinde, yapılandırma WCF şemasına karşı geçerli olup olmadığını denetler. Hatalar bulunursa, hata ayrıntılarını göstermek için bir iletişim kutusu görüntülenir.
Ara sunucu oluşturma, ikili derleme veya hizmet çağırma sırasında, düzenlemeyi destekleyen menü öğeleri (yani, "Düzenle ...", "Geri yükle ...", vb.) devre dışı bırakılır. Güncelleştirilmiş yapılandırma WCF Test İstemcisi'ne yüklenirken de hizmet çağırma devre dışı bırakılır.
İstemci Yapılandırmasını Kalıcı Hale
Araçlar-Seçenekler-İstemci>> Yapılandırması sekmesi, varsayılan olarak etkin olan Hizmetleri Başlatırken Her Zaman Yeniden Oluştur Yapılandırması seçeneğini içerir. Bu seçenek, WCF Test İstemcisi bir hizmeti her yükleyişinde en son hizmet sözleşmesine ve Service App.config dosyalarına göre bir yapılandırma dosyasını yeniden oluşturduğunu belirtir.
WCF hizmetinizin istemci yapılandırmasını düzenlediyseniz ve hizmetinizde hata ayıklamak için her zaman bu güncelleştirilmiş dosyayı kullanmak istiyorsanız, Yeniden Oluştur seçeneğinin işaretini kaldırabilirsiniz. Bunu yaptığınızda, hizmeti güncelleştirip WCF Test İstemcisi'ni yeniden açtığınızda bile, Client.dll.config dosyası, güncelleştirilmiş hizmeti temel alarak yeniden oluşturulan dosya yerine daha önce güncelleştirdiğiniz dosyadır.
Ancak, yeniden oluşturulan ara sunucuyla tutarlı hale getirmek için yapılandırma dosyasını düzenlemeniz gerekebilir. Yeniden oluşturulan ara sunucu ve yapılandırma dosyası güncelleştirilmiş bir hizmet nedeniyle uyumsuzsa, hizmet çağrıldığında hatalar oluşur.
Dikkat
İstemci yapılandırma dosyasını değiştirdiyseniz ve gelecekte yeniden kullanmak istiyorsanız, dosyayı aşağıdaki konumda bulabilirsiniz:
\Documents and Ayarlar\[User Account]\My Documents\Test Client Projects.
İstemci yapılandırma dosyasında depolanan tüm güncelleştirilmiş kimlik bilgileri, bu klasörün Erişim Denetim Listesi (ACL) tarafından korunur.
Hizmetleri Ekleme, Kaldırma ve Yenileme
Hizmet Ekle
WCF Test İstemcisi'ne hizmet eklemek için Dosya-Hizmet> Ekle'ye tıklayın. Daha sonra eklenecek hizmetin URI'sini (uç nokta adresi) yazmanız gerekir. Hizmetin adresi bir mex adresi veya WSDL adresi olabilir.
Son eklenen 10 hizmet uç noktasının listesini Son Hizmetler alt menüsünde de bulabilirsiniz. Bunlardan birini seçerseniz, belirtilen hizmet WCF Test İstemcisi'ne eklenir.
Aynı sonucu elde etmek için Hizmet Projelerim hizmet ağacının köküne sağ tıklayıp Hizmet Ekle'yi de seçebilirsiniz.
Ara sunucu oluşturma, ikili derleme veya hizmet çağırma sırasında, hizmet eklemeyi destekleyen menü öğeleri devre dışı bırakılır. Hizmet çağırma da devre dışı bırakıldı.
Hizmeti Kaldır
Kaldırılacak hizmetin hizmet köküne sağ tıklayın ve WCF Test İstemcisi'nden bir hizmeti kaldırmak için Hizmeti Kaldır'ı seçin.
Ara sunucu oluşturma, ikili derleme veya hizmet çağırma sırasında, bir hizmetin kaldırılmasını destekleyen menü öğeleri devre dışı bırakılır. Hizmet çağırma da devre dışı bırakıldı.
Hizmeti Yenile
WCF Test İstemcisi çalışırken hizmette bir değişiklik yapılırsa ve bu hizmet için WCF Test İstemcisi uygulamasının güncel olduğundan emin olmak istiyorsanız, hizmetin hizmet köküne sağ tıklayın ve Hizmeti Yenile'yi seçin. Yenilemeden sonra hizmet durumunun sıfırlandığını unutmayın.
Ara sunucu oluşturma, ikili derleme veya hizmet çağırma sırasında, bir hizmetin yenilenmesini destekleyen menü öğeleri devre dışı bırakılır. Hizmet çağırma da devre dışı bırakıldı.
Test İstemcisi Tarafından Oluşturulan Dosyaların Konumu
VARSAYıLAN olarak, WCF Test İstemcisi oluşturulan istemci kodunu ve yapılandırma dosyalarını "%appdata%\Local\temp\Test İstemci Projeleri" klasöründe depolar. WCF Test İstemcisi çıktıktan sonra bu klasör silinir. WCF Test İstemcisi'nde bir yapılandırma dosyası değiştirilirse ve Hizmetleri Başlatırken Yapılandırmayı Her Zaman Yeniden Oluştur seçeneği devre dışı bırakılırsa, değiştirilen dosya "Belgelerim\Test İstemci Projelerim" altındaki "CachedConfig" klasörüne dizin olarak eşleme (metadata-address-to-file-name) XML dosyasıyla kopyalanır.
WcF Test İstemcisi'ni bir komut satırında başlatabilir, /ProjectPath oluşturulan dosyaları depolamak için yeni bir istenen yol belirtmek için anahtarı kullanabilir veya anahtarı kullanarak varsayılan konumu geri yükleyebilirsiniz /RestoreProjectPath . Söz dizimi şu şekildedir:
wcfTestClient.exe /ProjectPath [desired location]
Bu komut çalıştırılırken WCF Test İstemcisi açılmaz. Yalnızca klasör konumu değiştirilir. WCF Test İstemcisi çalıştırılsa da çalışmasa da bu komutu çalıştırabilirsiniz. Yeni konum, WCF Test İstemcisi yeniden başlatıldığında uygulanır. Konum bilgileri kayıt defterine veya "%appdata%\Local\temp\Test İstemci Projeleri" klasöründeki WcfTestClient.exe.option dosyasına kaydedilebilir.
WCF Test İstemcisi tarafından desteklenen özellikler
WCF Test İstemcisi tarafından desteklenen özelliklerin listesi aşağıdadır:
Hizmet Çağırma: İstek/Yanıt ve Tek yönlü ileti.
Bağlamalar: Svcutil.exe tarafından desteklenen tüm bağlamalar.
Oturum Denetleniyor.
İleti Sözleşmesi.
XML serileştirme.
WCF Test İstemcisi tarafından desteklenmeyen özelliklerin listesi aşağıdadır:
Türler: Stream, Message, XmlElement, XmlAttribute, , XmlNode, , ilgili öznitelik ve ve XElement türleri ile XDocument ADO.NET DataTable türü de dahil olmak üzere XmlSchemaProviderAttribute arabirimi uygulayan IXmlSerializable türler.
Çift yönlü sözleşme.
Işlem.
Güvenlik: CardSpace , Sertifika ve Kullanıcı Adı/Parola.
Bağlamalar: WSFederationbinding, bağlam bağlamaları ve Https bağlaması, WebHttpbinding (Json yanıt iletisi desteği).
WCF Test İstemcisi Kapatılıyor
WCF Test İstemcisi'ni aşağıdaki yollarla kapatabilirsiniz:
Dosya menüsünde Çıkış'a tıklayın. Alternatif olarak, WCF Test İstemcisi ana penceresinde Kapat'a tıklayın. Bu eylemlerin her ikisi de WCF Hizmeti Otomatik Ana Bilgisayarı'nı kapatır ve WCF Test İstemcisi Visual Studio tarafından başlatıldıysa Visual Studio hata ayıklama işlemini durdurur.
Bildirim alanında WCF Hizmet Konağı simgesine sağ tıklayın ve ardından Çıkış'a tıklayın. Bu, hem WCF Hizmeti Otomatik Ana Bilgisayarı hem de WCF Test İstemcisi'ni kapatır ve Visual Studio hata ayıklama işlemini durdurur.