XML Serileştiricisi Oluşturma Aracı (Sgen.exe)

XML Seri Hale Getirici Oluşturucu, belirtilen derlemedeki türler için bir XML serileştirme derlemesi oluşturur. Serileştirme derlemesi, belirtilen türlerdeki nesneleri seri hale getirdiğinde veya seri durumdan çıkardığında öğesinin XmlSerializer başlangıç performansını geliştirir.

Uyarı

Bu araç .NET Framework derlemelerine özgüdür. .NET (Core) derlemeleri için XML seri hale getiricileri oluşturmak için bkz. .NET Core üzerinde Microsoft XML Seri Hale Getirici Oluşturucu kullanma.

Sözdizimi

Aracı komut satırından çalıştırın.

sgen [options]

Tavsiye

.NET Framework araçlarının düzgün çalışması için Visual Studio Geliştirici Komut İstemi'ni veya Visual Studio Geliştirici PowerShell'i kullanmanız veya , Pathve Include ortam değişkenlerini doğru ayarlamanız Libgerekir. Bu ortam değişkenlerini ayarlamak için bulunan <çalıştırın.

Parametreler

Seçenek	Açıklama
/a[ssembly]:filename	Dosya adıyla belirtilen derlemede veya yürütülebilir dosyada yer alan tüm türler için serileştirme kodu oluşturur. Yalnızca bir dosya adı sağlanabilir. Bu bağımsız değişken yinelenirse, son dosya adı kullanılır.
/c[ompiler]:options	C# derleyicisine geçirecek seçenekleri belirtir. Tüm csc.exe seçenekleri derleyiciye geçirilirken desteklenir. Bu, derlemenin imzalanması gerektiğini belirtmek ve anahtar dosyasını belirtmek için kullanılabilir.
/d[hata ayıklama]	Hata ayıklayıcı ile kullanılabilecek bir görüntü oluşturur.
/f[orce]	Aynı ada sahip mevcut bir derlemenin üzerine yazmayı zorlar. Varsayılan false'dir.
/help veya /?	Araç için komut sözdizimini ve seçenekleri görüntüler.
/k[eep]	Oluşturulan kaynak dosyaların ve diğer geçici dosyaların serileştirme derlemesinde derlendikten sonra silinmesini engeller. Bu, aracın belirli bir tür için serileştirme kodu oluşturup oluşturmadığını belirlemek için kullanılabilir.
/n[ologo]	Microsoft başlangıç başlığının görüntülenmesini engeller.
/o[ut]:path	Oluşturulan derlemenin kaydedildiği dizini belirtir. Not: Oluşturulan derlemenin adı, giriş derlemesinin ve "xmlSerializers.dll" adından oluşur.
/p[roxytypes]	Yalnızca XML Web hizmeti proxy türleri için serileştirme kodu oluşturur.
/r[eference]:assemblyfiles	XML serileştirme gerektiren türlerin başvurduğu derlemeleri belirtir. Virgülle ayrılmış birden çok derleme dosyasını kabul eder.
/s[ilent]	Başarı iletilerinin görüntülenmesini bastırır.
/t[ype]:type	Yalnızca belirtilen tür için serileştirme kodu oluşturur.
/v[erbose]	Hata ayıklama için ayrıntılı çıktı gösterebilir. Hedef derlemeden XmlSerializer ile serileştirilemeyen türleri listeler.
/?	Araç için komut sözdizimini ve seçenekleri görüntüler.

Açıklamalar

XML Seri Hale Getirici Oluşturucu kullanılmadığında, XmlSerializer bir uygulama her çalıştırıldığında her tür için serileştirme kodu ve serileştirme derlemesi oluşturur. XML serileştirme başlatma performansını geliştirmek için Sgen.exe aracını kullanarak bu derlemeleri önceden oluşturun. Bu derlemeler daha sonra uygulamayla dağıtılabilir.

XML Seri Hale Getirici Oluşturucu, sunucularla iletişim kurmak için XML web hizmeti proxy'lerini kullanan istemcilerin performansını da geliştirebilir çünkü serileştirme işlemi, tür ilk kez yüklendiğinde performans isabetine neden olmaz.

Oluşturulan derlemeler bir web hizmetinin sunucu tarafında kullanılamaz. Bu araç yalnızca web hizmeti istemcileri ve el ile serileştirme senaryoları içindir.

Uyarı

Araç sgeninit-only ayarlayıcılarıyla uyumlu değildir. Hedef derleme bu özelliği kullanan genel özellikler içeriyorsa araç başarısız olur.

Adlandırma

Serileştirilecek türü içeren derleme MyType.dllolarak adlandırılırsa, ilişkili serileştirme derlemesi MyType.XmlSerializers.dllolarak adlandırılır.

Örnekler

Aşağıdaki komut ,Data.dll adlı derlemede bulunan tüm türleri serileştirmek için Data.XmlSerializers.dlladlı bir derleme oluşturur.

sgen Data.dll

Data.XmlSerializers.dll derlemesine, Data.dll içindeki türleri serileştirmesi ve deserileştirmesi gereken koddan başvurulabilir.

Ayrıca bakınız

• Araçlar
• Geliştirici komut satırı kabukları