Windows Communication Foundation Örnekleri Oluşturma
Windows Communication Foundation (WCF) örnekleri, komut satırından Visual Studio IDE veya msbuild komutu kullanılarak oluşturulabilir. Bu makalede her iki yordam da açıklanmaktadır.
Not
WCF örneklerinden herhangi birini derlemeden veya çalıştırmadan önce, Windows Communication Foundation Örnekleri için Tek Seferlik Kurulum Yordamı'nı gerçekleştirdiğinizden emin olun.
Komut istemi kullanarak örneği derlemek için
Visual Studio için Geliştirici Komut İstemi'ni açın ve örneği yüklediğiniz dizin konumu altında dile özgü alt dizine gidin.
Komut satırına yazın
msbuild. İstemci programı dosyaları client\bin ve hizmet programı dosyaları service\bin için oluşturulur. Hizmet Internet Information Services (IIS) tarafından barındırılıyorsa, hizmet programı dosyaları da servicemodelsamples dizinine ve \bin alt dizinine kopyalanır.
Not
Çalıştırdığınız hesaba değişiklik izinleri vermek için %systemdrive%\inetpub\wwwroot üzerindeki ACL'leri ayarlamanız gerekir. Aksi takdirde bazı derleme sonrası olayları başarısız olur. Alternatif olarak, ACL'leri olduğu gibi bırakabilir ve SDK komut istemini yönetici olarak çalıştırabilirsiniz.
Visual Studio kullanarak örneği oluşturmak için
Visual Studio'daki Dosya menüsünden Projeyi/Çözümü Aç'ı>seçin. Örneği yüklediğiniz dizinin altındaki dile özgü alt dizine gidin ve çözümü Visual Studio'da açmak için .sln dosya simgesine çift tıklayın.
Derle menüsünde Çözümü Yeniden Derle'yi seçin.
İstemci programı dosyaları client\bin ve hizmet programı dosyaları service\bin için oluşturulur. Hizmet IIS'de barındırılıyorsa, hizmet programı dosyaları da servicemodelsamples dizinine ve \bin alt dizinine kopyalanır.
Not
Çalıştırdığınız hesaba değişiklik izinleri vermek için %systemdrive%\inetpub\wwwroot üzerindeki ACL'leri ayarlamanız gerekir. Aksi takdirde bazı derleme sonrası olayları başarısız olur. Alternatif olarak, ACL'leri olduğu gibi bırakabilir ve SDK komut istemini veya Visual Studio'yu yönetici olarak çalıştırabilirsiniz. Bazı Visual Studio eylemleri (ASP.NET çalışan işlemine hata ayıklayıcı ekleme gibi) yönetici ayrıcalıkları da gerektirir.
Batch Dosyalarını ve Betiklerini Ayarlama
Setup.exe ve Cleanup.exe toplu iş dosyaları ve betikleri Visual Studio için Geliştirici Komut İstemi'nden çalıştırılmalıdır. Çeşitli kurulum ve temizleme dosyaları, yönetici ayrıcalıkları gerektiren ve yönetici ayrıcalıklarıyla başlatılması gereken görevleri gerçekleştirir.
Meta Veri Uç Noktaları hakkında Önemli Güvenlik Bilgileri
Hassas olabilecek hizmet meta verilerinin yanlışlıkla açıklanmasını önlemek için, Windows Communication Foundation (WCF) hizmetleri için varsayılan yapılandırma meta veri yayımlamayı devre dışı bırakır. Bu davranış varsayılan olarak güvenlidir, ancak aynı zamanda hizmetin meta veri yayımlama davranışı yapılandırmada açıkça etkinleştirilmediği sürece hizmeti çağırmak için gereken istemci kodunu oluşturmak için bir meta veri içeri aktarma aracı (örneğin Svcutil.exe) kullanamazsınız. Örneklerle deneme yapmayı kolaylaştırmak için neredeyse tüm örnekler güvenli olmayan bir meta veri yayımlama uç noktasını kullanıma sunar. Bu tür uç noktalar anonim kimliği doğrulanmamış tüketiciler tarafından kullanılabilir ve hizmetin meta verilerini genel olarak açıklamanın uygun olduğundan emin olmak için bu uç noktalar dağıtılmadan önce dikkatli olunmalıdır. Hizmet meta verilerini yayımlama hakkında daha fazla bilgi için bkz . Meta Veri Yayımlama Davranışı örneği. Meta veri uç noktasının güvenliğini sağlama örneği için bkz. Özel Güvenli Meta Veri Uç Noktası örneği.
Özel Durum İşleme
Genel olarak bu örnekler, kodun örneğin konusuna odaklanmasını sağlamak için özel durum işlemeyi içermez. Özel durum işleme hakkında daha fazla bilgi için Bkz . Beklenen Özel Durumlar örneği.
Svcutil ile İstemcileri ve Yapılandırmayı Yeniden Oluşturma
Örneklerin çoğunda istemci kodunu ve yapılandırmasını yeniden oluşturmak için ServiceModel Meta Veri Yardımcı Programı Aracı'nı (Svcutil.exe) kullanabilirsiniz. Bazı örnekler el ile düzenlenmiş yapılandırma gerektirir. Örneğin, istemci sertifikası kimlik bilgilerini kullanan bir örneğin yapılandırmasını yeniden oluşturmak için Svcutil.exe kullanırsanız, önceden yapılandırılmış kimlik bilgilerini el ile belirtmeniz gerekir. Bazı örnekler, oluşturulan kodu etkilemek için belirli Svcutil.exe seçeneklerini kullanır; bu seçenekler belirli örnek konu başlıklarında belirtilir.
İstemci ve yapılandırma dosyalarını yeniden oluşturmak için
BIR SDK komut istemi açın ve örneği yüklediğiniz dizin konumu altında dile özgü alt dizine gidin.
Hizmet Web'de barındırılan bir türse aşağıdaki komutu kullanın.
svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /out:generatedClient.csHizmet şirket içinde barındırılan bir hizmetse aşağıdaki komutu yazın.
svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /out:generatedClient.csdeğerini şirket içinde barındırılan hizmetin mex uç noktasının adresiyle değiştirin
http://localhost:8000/ServiceModelSamples/service.svc/mex.İstemciyi Visual Basic türünde oluşturmak için aşağıdaki komutu kullanın.
svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vbHizmet şirket içinde barındırılan bir türse aşağıdaki komutu kullanın.
svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vbNot
İstemci yapılandırması oluşturma işlemini atlamak için /noConfig seçeneğini ekleyin.