Aracılığıyla paylaş

WCF Web Hizmeti Başvuru Sağlayıcısı Aracı'nı kullanma

  • Makale

Yıllar içinde birçok Visual Studio geliştiricisi, .NET Framework projelerinin web hizmetlerine erişmesi gerektiğinde Hizmet Başvurusu Ekleme aracının sağladığı üretkenliklerden memnun oldu.

WCF Web Hizmeti Başvurusu aracı, .NET 5+, .NET Core veya ASP.NET Core projenizi bir web hizmetine bağlamanıza olanak tanıyan visual studio bağlı hizmet uzantısıdır. Yalnızca .NET Framework projeleri için olan Hizmet Başvurusu Ekle işlevine benzer bir deneyim sağlar. WCF Web Hizmeti Başvurusu aracı, geçerli çözümdeki bir web hizmetinden, ağ konumundan veya WSDL dosyasından meta verileri alır ve .NET uygulamanızın web hizmetine erişmek için kullanabileceği Windows Communication Foundation (WCF) istemci proxy kodunu içeren bir kaynak dosyası oluşturur.

Önemli

Yalnızca güvenilen bir kaynaktan gelen hizmetlere başvurmanız gerekir. Güvenilmeyen bir kaynaktan başvuru eklemek güvenliği tehlikeye atabilir.

Önkoşullar

Bu makaledeki ekran görüntüleri Visual Studio 2022'den alınıyor.

Uzantıyı kullanma

Not

WCF Web Hizmeti Başvurusu aracı, ASP.NET Core Web uygulamaları da dahil olmak üzere yalnızca C# .NET Core ve .NET Standard projeleri için geçerlidir.

Örnek olarak ASP.NET Core Web Uygulaması proje şablonunu kullanarak, bu makalede projeye WCF hizmet başvurusu ekleme adımları gösterilir.

  1. Çözüm Gezgini'da, projenin Bağlan Hizmetler düğümüne çift tıklayın. (.NET Core veya .NET Standard projesi için projeye sağ tıklayın ve Bağlan Hizmet Ekle>.)

    Bağlan Hizmetler sayfası aşağıdaki görüntüde gösterildiği gibi görünür:

    Visual Studio Connected Services tab for .NET Core

  2. Bağlan Hizmetler sayfasında Hizmet Başvurusu Ekle'yi seçin.

    Hizmet başvurusu ekle sayfası açılır.

  3. WCF Web Hizmeti'ni ve ardından İleri'yi seçin.

    Bu, Yeni WCF Web Hizmeti hizmeti başvuru sihirbazını getirir.

    Visual Studio Service Endpoint tab for .NET Core

  4. Bir hizmet seçin.

    a. Kullanılabilir çeşitli hizmet arama seçenekleri vardır:

    • Geçerli çözümde tanımlanan hizmetleri aramak için Bul düğmesine tıklayın.
    • Belirtilen adreste barındırılan hizmetleri aramak için Adres kutusuna bir hizmet URL'si girin ve Git düğmesine tıklayın.
    • Web hizmeti meta veri bilgilerini içeren bir WSDL dosyası seçmek için Gözat düğmesine tıklayın.

    b. Hizmetler kutusundaki arama sonuçları listesinden hizmeti seçin. Gerekirse, oluşturulan kodun ad alanını ilgili Ad Alanı metin kutusuna girin.

    c. Veri türü seçeneklerini veya istemci seçeneklerini belirtmek için İleri düğmesine tıklayın. Alternatif olarak, varsayılan seçenekleri kullanmak için Son düğmesine tıklayın.

  5. Veri türü seçenekleri sayfası, oluşturulan hizmet başvurusu yapılandırma ayarlarını iyileştirmeye olanak tanır:

    Visual Studio Data type options tab for .NET Core

    Not

    Başvuruda bulunan derlemelerde türleri yeniden kullan onay kutusu seçeneği, hizmet başvuru kodu oluşturma için gereken veri türleri projenizin başvuruda bulunan derlemelerinden birinde tanımlandığında kullanışlıdır. Derleme zamanı türü çakışması veya çalışma zamanı sorunlarını önlemek için mevcut veri türlerini yeniden kullanmak önemlidir.

    Proje bağımlılıklarının sayısına ve diğer sistem performans faktörlerine bağlı olarak tür bilgileri yüklenirken bir gecikme olabilir. Başvuruldu derlemelerdeki türleri yeniden kullan onay kutusu işaretlenmediği sürece, Yükleme sırasında Son düğmesi devre dışı bırakılır.

  6. İşiniz bittiğinde Son'a tıklayın.

İlerleme durumunu görüntülerken araç:

  • WCF hizmetinden meta verileri indirir.
  • hizmet başvuru kodunu reference.cs adlı bir dosyada oluşturur ve Bağlan hizmetler düğümü altında projenize ekler.
  • Proje dosyasını (.csproj) hedef platformda derlemek ve çalıştırmak için gereken NuGet paket başvuruları ile Güncelleştirmeler.

Visual Studio Progress window

Bu işlemler tamamlandığında, oluşturulan WCF istemci türünün bir örneğini oluşturabilir ve hizmet işlemlerini çağırabilirsiniz.

Ayrıca bkz.

Geri bildirim ve sorular

Herhangi bir ürün geri bildiriminiz varsa Sorun bildir aracını kullanarak Geliştirici Topluluğu raporlayın.

Sürüm notları