XML Serializer 생성기 도구(Sgen.exe)
XML Serializer 생성기는 지정된 어셈블리의 형식에 대한 XML 직렬화 어셈블리를 만듭니다. 직렬화 어셈블리는 지정된 형식의 개체를 직렬화하거나 역직렬화할 때 XmlSerializer의 시작 성능을 향상시킵니다.
참고 항목
이 도구는 .NET Framework 어셈블리에만 적용됩니다. .NET(Core) 어셈블리용 XML 직렬 변환기를 생성하려면 .NET Core에서 Microsoft XML 직렬 변환기 생성기 사용을 참조하세요.
구문
명령줄에서 도구를 실행합니다.
sgen [options]
팁
.NET Framework 도구가 제대로 작동하려면 Visual Studio 개발자 명령 프롬프트 또는 Visual Studio 개발자 PowerShell을 사용 하거나 Path, Include 및 Lib 환경 변수를 올바르게 설정해야 합니다. 이러한 환경 변수를 설정하려면 <SDK>\<version>\Bin 디렉터리에 있는 SDKVars.bat를 실행합니다.
매개 변수
| 옵션 | 설명 |
|---|---|
| /a[ssembly]:filename | filename에서 지정한 어셈블리 또는 실행 파일에 있는 모든 형식에 대해 serialization 코드를 생성합니다. 파일 이름은 하나만 제공할 수 있습니다. 이 인수가 반복되면 마지막 파일 이름이 사용됩니다. |
| /c[ompiler]:options | C# 컴파일러로 전달될 옵션을 지정합니다. 모든 csc.exe 옵션이 컴파일러로 전달되어 지원됩니다. 이 옵션은 어셈블리에서 서명되도록 지정할 때와 키 파일을 지정할 때 사용할 수 있습니다. |
| /d[ebug] | 디버거에서 사용할 수 있는 이미지를 생성합니다. |
| /f[orce] | 이름이 같은 기존 어셈블리를 덮어쓰게 합니다. 기본값은 false입니다. |
| /help 또는 /? | 이 도구의 명령 구문 및 옵션을 표시합니다. |
| /k[eep] | 생성된 소스 파일 및 기타 임시 파일이 serialization 어셈블리로 컴파일된 후에는 이 파일을 삭제하지 않습니다. 이 도구에서 특정 형식에 대해 serialization 코드를 생성하는지 여부를 확인하는 데 사용할 수 있습니다. |
| /n[ologo] | Microsoft 시작 배너를 표시하지 않습니다. |
| /o[ut]:path | 생성된 어셈블리를 저장할 디렉터리를 지정합니다. 참고: 생성된 어셈블리의 이름은 입력 어셈블리의 이름과 “xmlSerializers.dll”로 구성됩니다. |
| /p[roxytypes] | XML Web services 프록시 형식에 대해서만 serialization 코드를 생성합니다. |
| /r[eference]:assemblyfiles | XML serialization이 필요한 형식에서 참조하는 어셈블리를 지정합니다. 여러 개의 어셈블리 파일을 쉼표로 구분할 수 있도록 허용합니다. |
| /s[ilent] | 성공 메시지를 표시하지 않습니다. |
| /t[ype]:type | 지정된 형식에 대해서만 serialization 코드를 생성합니다. |
| /v[erbose] | 디버깅에 대한 자세한 출력을 표시합니다. 대상 어셈블리에서 XmlSerializer로 serialize할 수 없는 형식을 나열합니다. |
| /? | 이 도구의 명령 구문 및 옵션을 표시합니다. |
설명
XML Serializer 생성기를 사용하지 않을 경우, XmlSerializer는 애플리케이션이 실행될 때마다 각 형식에 대해 serialization 코드 및 serialization 어셈블리를 생성합니다. XML 직렬화 시작 성능을 높이려면 Sgen.exe 도구를 사용하여 해당 어셈블리를 미리 생성합니다. 그런 다음 애플리케이션과 함께 이 어셈블리를 배포할 수 있습니다.
XML Serializer 생성기는 해당 형식이 맨 처음 로드될 때 serialization 프로세스에서 성능 손실을 유발하지 않으므로, 서버와의 통신에서 XML Web services 프록시를 사용하는 클라이언트의 성능도 높일 수 있습니다.
생성된 어셈블리는 웹 서비스의 서버 쪽에서 사용할 수 없습니다. 이 도구는 웹 서비스 클라이언트 및 수동 serialization 시나리오에서만 사용할 수 있습니다.
참고 항목
이 sgen 도구는 init전용 setter와 호환되지 않습니다. 대상 어셈블리에 이 기능을 사용하는 공용 속성이 포함되어 있으면 도구가 실패합니다.
이름 지정
serialize할 형식을 포함하는 어셈블리의 이름이 MyType.dll이라면 연결된 serialization 어셈블리의 이름은 MyType.XmlSerializers.dll이 됩니다.
예제
다음 명령에서는 Data.dll이라는 어셈블리에 포함된 모든 형식을 serialize하기 위해 Data.XmlSerializers.dll이라는 어셈블리를 만듭니다.
sgen Data.dll
Data.XmlSerializers.dll 어셈블리는 Data.dll의 형식을 직렬화/역직렬화해야 하는 코드에서 참조할 수 있습니다.
참고 항목
.NET