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.
Not
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]
İpucu
.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 , Includeve Lib ortam değişkenlerini doğru ayarlamanız Pathgerekir. Bu ortam değişkenlerini ayarlamak için SDK>\version>\<Bin dizininde <bulunan SDKVars.bat ç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 yinelenir, son dosya adı kullanılır. |
| /c[ompiler]:options | C# Derleyici geçirilecek seçeneklerini belirtir. Tüm csc.exe seçenekleri için derleyici geçirilen desteklenir. Bu derleme imzalanması gerektiğini belirtmek ve anahtar dosyasını belirtmek için kullanılabilir. |
| /d[ebug] | Bir hata ayıklayıcısı ile kullanılan bir görüntü oluşturur. |
| /f[orce] | Aynı ada sahip bir varolan derlemenin üzerine zorlar. Varsayılan değer false'tur. |
| /help veya /? | Araç için komut sözdizimini ve seçenekleri görüntüler. |
| /k[eep] | Serileştirme derlemeye derlenen sonra oluşturulan kaynak dosyaların ve diğer geçici dosyaları silmeyi göstermez. Bu araç belirli bir tür için serileştirme kod oluşturmak olup olmadığını belirlemek için kullanılabilir. |
| /n[ologo] | Microsoft başlangıç başlığı görüntülenmesini engeller. |
| /o[ut]:path | Oluşturulan derleme kaydedileceği dizini belirtir. Not: Oluşturulan derlemenin adı, giriş derlemesinin adından ve "xmlSerializers.dll" öğesinden oluşur. |
| /p[roxytypes] | XML Web hizmeti proxy türleri için yalnızca serileştirme kod oluşturur. |
| /r[eference]:assemblyfiles | XML serileştirme gerektiren türleri tarafından başvurulan bir derleme belirtir. Virgülle ayrılmış birden çok derleme dosyaları kabul eder. |
| /s[ilent] | Başarı iletilerinin görüntülenmesini bastırır. |
| /t[ype]:type | Belirtilen tür için yalnızca serileştirme kod oluşturur. |
| /v[erbose] | Hata ayıklama için ayrıntılı çıktı görüntüler. Listeler ile seri hale getirilemiyor hedef derleme türlerinden XmlSerializer. |
| /? | 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 derlemeleri uygulama ile sonra 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.
Not
Araç sgen yalnızca init 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.dll olarak adlandırılırsa, ilişkili serileştirme derlemesi MyType.XmlSerializers.dll olarak adlandırılır.
Örnekler
Aşağıdaki komut, Data.dll adlı derlemede bulunan tüm türleri serileştirmek için Data.XmlSerializers.dll adlı bir derleme oluşturur.
sgen Data.dll
Data.XmlSerializers.dll derlemesine, Data.dll türlerini seri hale getirmesi ve seri durumdan çıkarması gereken koddan başvurulabilir.
