<system.serviceModel>

  • Makale

Bu yapılandırma bölümü tüm Windows Communication Foundation (WCF) ServiceModel yapılandırma öğelerini içerir.

<Yapılandırma>
  <system.serviceModel>

Syntax

<system.serviceModel>
  <behaviors>
  </behaviors>
  <bindings>
  </bindings>
  <client>
  </client>
  <comContracts>
  </comContracts>
  <commonBehaviors>
  </commonBehaviors>
  <diagnostics>
  </diagnostics>
  <extensions>
  </extensions>
  <protocolMapping>
  </protocolMapping>
  <routing>
  </routing>
  <serviceHostingEnvironment>
  </serviceHostingEnvironment>
  <services>
  </services>
  <standardEndpoints>
  </standardEndpoints>
  <tracking>
  </tracking>
</system.serviceModel>

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst öğeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Hiçbiri

Alt Öğeler

Öğe Açıklama
<Davranış> Bu bölümde ve serviceBehaviorsadlı endpointBehaviors iki alt koleksiyon tanımlanmıştır. Her koleksiyon, sırasıyla uç noktalar ve hizmetler tarafından kullanılan davranış öğelerini tanımlar. Her davranış öğesi benzersiz name özniteliğiyle tanımlanır.
<Bağlama> Bu bölüm standart ve özel bağlamalardan oluşan bir koleksiyonu barındırıyor. Her giriş benzersiz nameile tanımlanır. Hizmetler bağlamaları kullanarak bağlamaları kullanır name.
<Istemci> Bu bölüm, istemcinin bir hizmete bağlanmak için kullandığı uç noktaların listesini içerir.
<comContracts> Bu bölümde WCF ve COM birlikte çalışma için etkinleştirilen COM sözleşmeleri tanımlanmıştır.
<commonBehaviors> Bu bölüm yalnızca machine.config dosyasında tanımlanabilir. ve serviceBehaviorsadlı endpointBehaviors iki alt koleksiyon tanımlar. Her koleksiyon, makinedeki tüm WCF uç noktaları ve hizmetleri tarafından kullanılan davranış öğelerini sırasıyla tanımlar. Hem hem de <commonBehaviors><behaviors> bölümlerinde bir davranış tanımlanmışsa, davranışlar> bölümündeki davranış <tercih edilir.
<Tanılama> Bu bölüm WCF'nin tanılama özellikleri için ayarları içerir. Kullanıcı izlemeyi, performans sayaçlarını ve WMI sağlayıcısını etkinleştirebilir/devre dışı bırakabilir ve özel ileti filtreleri ekleyebilir.
<Uzantı -ları> Bu bölüm, kullanıcının kullanıcı tanımlı bağlamalar, davranışlar ve uzantıların diğer yönlerini oluşturmasına olanak tanıyan bir uzantı koleksiyonu içerir.
<protocolMapping> Bu bölüm, aktarım protokolü düzenleri (http, net.tcp, net.pipe vb.) ile WCF bağlamaları arasında bir dizi varsayılan protokol eşlemesi tanımlar.
<Yönlendirme> Bu bölüm, gelen iletileri değerlendirirken kullanılacak Windows Communication Foundation (WCF)MessageFilter türünü ve bir filtre eşleştiğinde iletilerin gönderileceği hedef uç noktaları tanımlayan yönlendirme tablolarını belirleyen bir yönlendirme filtreleri kümesini tanımlar.
<serviceHostingEnvironment> Bu bölümde, hizmet barındırma ortamının belirli bir aktarım için ne tür örnek oluşturdığı açıklanır. Bu bölüm boşsa, varsayılan tür kullanılır.
<Hizmetleri> bölümü bir hizmet koleksiyonu içerir. Derlemede tanımlanan her hizmet için bu öğe, hizmetin ayarlarını belirten bir service öğe içerir.
<standardEndpoints> Bu bölüm, önceden yapılandırılmış yeniden kullanılabilir uç noktalar olan standart uç noktaların bir koleksiyonunu tanımlar. Standart uç noktanın adres, bağlama ve sözleşme özniteliklerinden biri veya daha fazlası sabit bir değere ayarlanır. Örneğin, bulma uç noktasında sözleşme düzeltildi. Hizmet uç noktasını özel bağlamaları tanımlamaya benzer yeni özelliklerle genişletmek için standart uç noktaları da kullanabilirsiniz.
<Izleme> Bu bölümde bir iş akışı hizmeti için izleme ayarları tanımlanmaktadır.

Üst Öğeler

Öğe Açıklama
<Yapılandırma> Bir .NET yapılandırma dosyasındaki tüm yapılandırma öğeleri için kök öğesi.

Açıklamalar

WCF, diğer ürünlerin yapılandırma bölümlerine öğe eklemez.

WCF hizmetleri yapılandırma dosyasının services bölümünde tanımlanır. Derleme herhangi bir sayıda hizmet içerebilir. Her hizmetin kendi service yapılandırma bölümü vardır. bölümü ve içeriği, belirli bir hizmetin hizmet sözleşmesini, davranışını ve uç noktalarını tanımlar.

Yalnızca bir hizmetin name özniteliği gereklidir. Varsayılan olarak, bir hizmetin adı bir hizmeti uygulamak için kullanılan temel CLR türünü açıklar; ancak, CLR türü gereksinimini geçersiz kılmak için üzerindeki ServiceContractAttribute ConfigurationName özelliğini değiştirebilirsiniz.

behaviorConfiguration özniteliği isteğe bağlıdır. Bir hizmet tarafından kullanılan hizmet davranışını tanımlar. Bu öznitelik tarafından belirtilen davranış, aynı yapılandırma dosyasının (aynı dosya veya üst dosya) kapsamında tanımlanan bir hizmet davranışına bağlanmalıdır.

Her hizmet, bir öğede tanımlanan bir endpoint veya daha fazla uç noktayı kullanıma sunar. Her uç noktanın kendi adresi ve bağlaması vardır. Yapılandırma dosyasında kullanılan tüm bağlamalar dosyanın kapsamında tanımlanmalıdır.

Bağlamalar, ve bindingConfigurationözniteliklerinin name birleşimi aracılığıyla uç noktalara bağlanır. binding özniteliği bağlamanın hangi bölümde tanımlandığını tanımlar. özniteliği, bindingConfiguration bağlama bölümünde hangi yapılandırılmış bağlamanın kullanıldığını tanımlar. Bağlama bölümü, yapılandırılmış birkaç bağlama tanımlayabilir.

Örnek

Bu bir WCF yapılandırma dosyası örneğidir.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.serviceModel>
    <behaviors>
      <!-- List of Behaviors -->
    </behaviors>
    <client>
      <!-- List of Endpoints -->
    </client>
    <diagnostics wmiProviderEnabled="false"
                 performanceCountersEnabled="false"
                 tracingEnabled="false">
    </diagnostics>
    <serviceHostingEnvironment>
      <!-- List of entries -->
    </serviceHostingEnvironment>
    <comContracts>
      <!-- List of COM+ Contracts -->
    </comContracts>
    <services>
      <!-- List of Services -->
    </services>
    <bindings>
      <!-- List of Bindings -->
    </bindings>
  </system.serviceModel>
</configuration>

Ayrıca bkz.