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

  • Makale

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.

Ayrıca bkz.