ServiceModel Meta Veri Yardımcı Programracı (Svcutil.exe)

ServiceModel Meta Veri Yardımcı Programı aracı meta veri belgelerinden hizmet modeli kodu ve hizmet modeli kodundan meta veri belgeleri oluşturmak için kullanılır.

SvcUtil.exe

ServiceModel Meta Veri Yardımcı Programı Aracı, Windows SDK yükleme konumunda, özellikle %ProgramFiles%\Microsoft SDKs\Windows\v6.0\Bin konumunda bulunabilir.

İşlevler

Aşağıdaki tabloda, bu araç tarafından sağlanan çeşitli işlevler ve nasıl kullanıldığının açıklandığı ilgili konu özetlenir:

Timeout

Meta veriler alınırken aracın beş dakikalık zaman aşımı vardır. Bu zaman aşımı yalnızca ağ üzerinden meta verileri almak için geçerlidir. Bu meta verilerin işlenmesi için geçerli değildir.

Çoklu hedefleme

Araç çoklu hedeflemeyi desteklemez. svcutil.exe'dan bir .NET Framework 4 yapıtı oluşturmak istiyorsanız , .NET Framework 4 SDK'sından svcutil.exe kullanın. .NET Framework 3.5 yapıtı oluşturmak için .NET Framework 3.5 SDK'sından yürütülebilir dosyayı kullanın.

WSDL Belgelerine Erişme

Bir güvenlik belirteci hizmetine (STS) başvuru içeren bir WSDL belgesine erişmek için Svcutil kullandığınızda, Svcutil STS'ye bir WS-MetadataExchange çağrısı yapar. Ancak hizmet, WS-MetadataExchange veya HTTP GET kullanarak WSDL belgelerini kullanıma açabilir. Bu nedenle, STS yalnızca HTTP GET kullanarak WSDL belgesini kullanıma verdiyse, WinFX'te yazılmış bir istemci başarısız olur. .NET Framework 3.5'te yazılan istemciler için Svcutil, STS WSDL'yi edinmek için hem WS-MetadataExchange hem de HTTP GET kullanmayı dener.

SvcUtil.exe kullanma

Ortak Kullanımlar

Aşağıdaki tabloda, bu araç için yaygın olarak kullanılan bazı seçenekler gösterilmektedir:

Kod Üretimi

Svcutil.exe meta veri belgelerinden hizmet sözleşmeleri, istemciler ve veri türleri için kod oluşturabilir. Bu meta veri belgeleri dayanıklı bir depolamada olabilir veya çevrimiçi olarak alınabilir. Çevrimiçi alma, WS-Metadata Exchange protokollerini veya DISCO protokollerini izler (ayrıntılar için Meta Verileri İndirme bölümüne bakın).

Önceden tanımlanmış bir WSDL belgesini temel alan hizmet ve veri sözleşmeleri oluşturmak için SvcUtil.exe aracını kullanabilirsiniz. /serviceContract anahtarını kullanın ve WSDL belgesinin indirilebileceği veya bulunabileceği bir URL veya dosya konumu belirtin. Bu, WSDL belgesinde tanımlanan ve daha sonra bir şikayet hizmeti uygulamak için kullanılabilecek hizmet ve veri sözleşmelerini oluşturur. Daha fazla bilgi için bkz . Nasıl yapılır: Meta Verileri Alma ve Uyumlu Hizmet Uygulama.

BasicHttpContextBinding uç noktasına sahip bir hizmet için Svcutil.exe özniteliğinin allowCookies ayarlandığı true bir BasicHttpBinding oluşturur. Tanımlama bilgileri sunucudaki bağlam için kullanılır. Hizmet tanımlama bilgileri kullandığında istemcideki bağlamı yönetmek isterseniz, yapılandırmayı bağlam bağlaması kullanacak şekilde el ile değiştirebilirsiniz.

svcutil.exe [/t:code] <metadataDocumentPath>* | <url>* | <epr>

Meta Veri Dışarı Aktarma

Svcutil.exe derlenmiş derlemelerdeki hizmetler, sözleşmeler ve veri türleri için meta verileri dışarı aktarabilir. Bir hizmetin meta verilerini dışarı aktarmak için, dışarı aktarmak istediğiniz hizmeti belirtme seçeneğini kullanmanız /serviceName gerekir. Bir derlemedeki tüm veri sözleşmesi türlerini dışarı aktarmak için seçeneğini kullanmanız /dataContractOnly gerekir. Varsayılan olarak, meta veriler giriş derlemelerindeki tüm hizmet sözleşmeleri için dışarı aktarılır.

svcutil.exe [/t:metadata] [/serviceName:<serviceConfigName>] [/dataContractOnly] <assemblyPath>*

Hizmet Doğrulama

Doğrulama, hizmeti barındırmadan hizmet uygulamalarındaki hataları algılamak için kullanılabilir. Doğrulamak istediğiniz hizmeti belirtmek için seçeneğini kullanmanız /serviceName gerekir.

svcutil.exe /validate /serviceName:<serviceConfigName> <assemblyPath>*

Meta Veri İndirme

Svcutil.exe, çalışan hizmetlerden meta verileri indirmek ve meta verileri yerel dosyalara kaydetmek için kullanılabilir. Meta verileri indirmek için seçeneğini belirtmeniz /t:metadata gerekir. Aksi takdirde istemci kodu oluşturulur. HTTP ve HTTPS URL düzenleri için Svcutil.exe WS-Metadata Exchange ve DISCO kullanarak meta verileri almaya çalışır. Diğer tüm URL düzenleri için Svcutil.exe yalnızca WS-Metadata Exchange kullanır.

Svcutil, meta verileri almak için aşağıdaki meta veri isteklerini aynı anda oluşturur.

• Sağlanan adrese MEX (WS-Transfer) isteği

• Sağlanan adrese /mex eklenmiş MEX isteği

• SAĞLANAN adrese DISKO isteği (ASMX'ten DiscoveryClientProtocol kullanarak).

Varsayılan olarak, Svcutil.exe MEX istekleri yapmak için sınıfında tanımlanan MetadataExchangeBindings bağlamaları kullanır. WS-Metadata Exchange için kullanılan bağlamayı yapılandırmak için, yapılandırmada IMetadataExchange sözleşmesini kullanan bir istemci uç noktası tanımlamanız gerekir. Bu, Svcutil.exe yapılandırma dosyasında veya seçeneği kullanılarak /svcutilConfig belirtilen başka bir yapılandırma dosyasında tanımlanabilir.

svcutil.exe /t:metadata <url>* | <epr>

XmlSerializer Tür Oluşturma

Çalışma zamanında bu veri türleri için seri hale getirme ve derleme kodunu kullanarak XmlSerializer seri hale getirilebilen veri türlerini kullanan hizmetler ve istemci uygulamaları, yavaş başlatma performansına neden olabilir.

Svcutil.exe, uygulama için derlenmiş derlemelerden gerekli C# serileştirme kodunu oluşturabilir ve böylece bu uygulamalar için başlatma performansını geliştirebilir. Daha fazla bilgi için bkz . Nasıl yapılır: XmlSerializer kullanarak WCF İstemci Uygulamalarının Başlangıç Süresini Geliştirme.

svcutil.exe /t:xmlSerializer <assemblyPath>*

Örnekler

Aşağıdaki komut, çalışan bir hizmetten veya çevrimiçi meta veri belgelerinden istemci kodu oluşturur.

svcutil http://service/metadataEndpoint

Aşağıdaki komut yerel meta veri belgelerinden istemci kodu oluşturur.

svcutil *.wsdl *.xsd /language:C#

Aşağıdaki komut, yerel şema belgelerinden Visual Basic'te veri sözleşmesi türleri oluşturur.

svcutil /dconly *.xsd /language:VB

Aşağıdaki komut, meta veri belgelerini çalışan hizmetlerden indirir.

svcutil /t:metadata http://service/metadataEndpoint

Aşağıdaki komut, bir derlemede hizmet sözleşmeleri ve ilişkili türler için meta veri belgeleri oluşturur.

svcutil myAssembly.dll

Aşağıdaki komut, bir hizmet için meta veri belgeleri ve bir derlemede ilişkili tüm hizmet sözleşmelerini ve veri türlerini oluşturur.

svcutil myServiceHost.exe /serviceName:myServiceName

Aşağıdaki komut, bir derlemedeki veri türleri için meta veri belgeleri oluşturur.

svcutil myServiceHost.exe /dconly

Aşağıdaki komut hizmet barındırmayı doğrular.

svcutil /validate /serviceName:myServiceName myServiceHost.exe

Aşağıdaki komut, derlemedeki herhangi bir hizmet sözleşmesi tarafından kullanılan türler için XmlSerializer serileştirme türleri oluşturur.

svcutil /t:xmlserializer myContractLibrary.exe

En Fazla Ad Tablo Karakter Sayısı Kotası

Svcutil kullanarak bir hizmet için meta veriler oluştururken aşağıdaki iletiyi alabilirsiniz:

Hata: Xml verileri okunurken en fazla ad tablosu karakter sayısı kotası (16384) aşıldığından Meta Veriler http://localhost:8000/somesservice/mex alınamıyor. Ad tablosu, XML işleme sırasında karşılaşılan dizeleri depolamak için kullanılan bir veri yapısıdır. Yinelenen öğe adları, öznitelik adları ve öznitelik değerlerine sahip uzun XML belgeleri bu kotayı tetikleyebilir. Bu kota, XML okuyucusu oluşturulurken kullanılan XmlDictionaryReaderQuotas nesnesinde MaxNameTableCharCount özelliği değiştirilerek artırılabilir.

Bu hataya, meta verilerini istediğinizde büyük bir WSDL dosyası döndüren bir hizmet neden olabilir. Sorun, svcutil.exe aracının karakter kotasının aşılmasıdır. Bu değer, hizmet reddi (dos) saldırılarını önlemeye yardımcı olmak için ayarlanır. Svcutil için aşağıdaki yapılandırma dosyasını belirterek bu kotayı artırabilirsiniz.

Aşağıdaki yapılandırma dosyasında svcutil için okuyucu kotalarının nasıl ayarlanacağı gösterilmektedir

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.serviceModel>
        <bindings>
            <customBinding>
                <binding name="MyBinding">
                    <textMessageEncoding>
                        <readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647"
                            maxArrayLength="2147483647" maxBytesPerRead="2147483647" maxNameTableCharCount="2147483647" />
                    </textMessageEncoding>
                    <httpTransport maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" />
                </binding>
            </customBinding>
        </bindings>
        <client>
            <endpoint binding="customBinding" bindingConfiguration="MyBinding"
                contract="IMetadataExchange"
                name="http" />
        </client>
    </system.serviceModel>
</configuration>

svcutil.exe.config adlı yeni bir dosya oluşturun ve XML örnek kodunu bu dosyaya kopyalayın. Ardından dosyayı svcutil.exe ile aynı dizine yerleştirin. bir sonraki svcutil.exe çalıştırıldığında yeni ayarlar açılır.

GüvenlikLe ilgili Endişeler

Svcutil.exe yükleme klasörünü, Svcutil.config dosyasını ve tarafından /svcutilConfigişaret edilen dosyaları korumak için uygun Erişim Denetim Listesi'ni (ACL) kullanmalısınız. Bu, kötü amaçlı uzantıların kaydedilmesini ve çalıştırılmasını engelleyebilir.

Ayrıca, güvenliğin tehlikeye atılma olasılığını en aza indirmek için sistemin bir parçası olmak için güvenilmeyen uzantılar eklememeli veya Svcutil.exe ile güvenilmeyen kod sağlayıcıları kullanmamalısınız.

Son olarak, geçerli işlemde hizmet reddine neden olabileceğinden, aracı uygulamanızın orta katmanında kullanmamalısınız.

Ayrıca bkz.

• DataContractAttribute
• DataMemberAttribute
• Nasıl yapılır: İstemci Oluşturma