SGen 작업SGen Task

지정된 어셈블리의 형식에 대한 XML serialization 어셈블리를 만듭니다.Creates an XML serialization assembly for types in the specified assembly. 이 작업은 XML Serializer 생성기 도구(Sgen.exe)를 래핑합니다.This task wraps the XML Serializer Generator Tool (Sgen.exe). 자세한 내용은 XML Serializer 생성기 도구(Sgen.exe)를 참조하세요.For more information, see XML Serializer Generator Tool (Sgen.exe).

매개 변수Parameters

다음 표에서는 SGen 작업의 매개 변수에 대해 설명합니다.The following table describes the parameters of the SGen task.

매개 변수Parameter 설명Description
BuildAssemblyName 필수 String 매개 변수입니다.Required String parameter.

serialization 코드를 생성할 어셈블리입니다.The assembly to generate serialization code for.
BuildAssemblyPath 필수 String 매개 변수입니다.Required String parameter.

serialization 코드를 생성할 어셈블리 경로입니다.The path to the assembly to generate serialization code for.
DelaySign 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

완전히 서명된 어셈블리를 만들려는 경우 true를 지정합니다.If true, specifies that you want a fully signed assembly. 어셈블리에 공개 키만 저장하려 경우 false를 지정합니다.If false, specifies that you only want to place the public key in the assembly.

이 매개 변수는 KeyFile 또는 KeyContainer 매개 변수와 함께 사용하지 않는 한 효과가 없습니다.This parameter has no effect unless used with either the KeyFile or KeyContainer parameter.
KeyContainer 선택적 String 매개 변수입니다.Optional String parameter.

키 쌍을 보관하는 컨테이너를 지정합니다.Specifies a container that holds a key pair. 어셈블리 매니페스트에 공개 키를 삽입하여 어셈블리에 서명합니다.This will sign the assembly by inserting a public key into the assembly manifest. 그런 다음 이 작업은 개인 키를 사용하여 최종 어셈블리에 서명합니다.The task will then sign the final assembly with the private key.
KeyFile 선택적 String 매개 변수입니다.Optional String parameter.

어셈블리 서명에 사용할 키 쌍 또는 공개 키를 지정합니다.Specifies a key pair or a public key to use to sign an assembly. 컴파일러는 공개 키를 어셈블리 매니페스트에 삽입한 다음 개인 키를 사용하여 최종 어셈블리에 서명합니다.The compiler inserts the public key in the assembly manifest and then signs the final assembly with the private key.
Platform 선택적 String 매개 변수입니다.Optional String parameter.

출력 어셈블리를 생성하는 데 사용되는 컴파일러 플랫폼을 가져오거나 설정합니다.Gets or Sets the Compiler Platform used to generate the output assembly. 이 매개 변수는 x86, x64 또는 anycpu 값을 가질 수 있습니다.This parameter can have a value of x86, x64, or anycpu. 기본값은 anycpu입니다.Default is anycpu.
References 선택적 String[] 매개 변수입니다.Optional String[] parameter.

XML serialization이 필요한 형식에서 참조하는 어셈블리를 지정합니다.Specifies the assemblies that are referenced by the types requiring XML serialization.
SdkToolsPath 선택적 String 매개 변수입니다.Optional String parameter.

resgen.exe와 같은 SDK 도구에 대한 경로를 지정합니다.Specifies the path to the SDK tools, such as resgen.exe.
SerializationAssembly 선택적 <xref:Microsoft.Build.Framework.ITaskItem>[] 출력 매개 변수입니다.Optional <xref:Microsoft.Build.Framework.ITaskItem>[] output parameter.

생성된 serialization 어셈블리를 포함합니다.Contains the generated serialization assembly.
SerializationAssemblyName 선택적 String 매개 변수입니다.Optional String parameter.

생성된 serialization 어셈블리의 이름을 지정합니다.Specifies the name of the generated serialization assembly.
ShouldGenerateSerializer 필수 Boolean 매개 변수입니다.Required Boolean parameter.

true이면 SGen 작업은 serialization 어셈블리를 생성해야 합니다.If true, the SGen task should generate a serialization assembly.
Timeout 선택적 Int32 매개 변수입니다.Optional Int32 parameter.

작업 실행 파일이 얼마 후에 종료될 지를 밀리초 단위로 지정합니다.Specifies the amount of time, in milliseconds, after which the task executable is terminated. 기본값은 시간 제한이 없음을 나타내는 Int.MaxValue입니다.The default value is Int.MaxValue, indicating that there is no time out period.
ToolPath 선택적 String 매개 변수입니다.Optional String parameter.

작업에서 내부 실행 파일(sgen.exe)을 로드할 위치를 지정합니다.Specifies the location from where the task will load the underlying executable file (sgen.exe). 이 매개 변수를 지정하지 않으면 작업에서는 MSBuildMSBuild를 실행하고 있는 버전의 Framework에 해당하는 SDK 설치 경로가 사용됩니다.If this parameter is not specified, the task uses the SDK installation path corresponding to the version of the framework that is running MSBuildMSBuild.
Types 선택적 String[] 매개 변수입니다.Optional String[] parameter.

serialization 코드를 생성하기 위한 특정 형식의 목록을 가져오거나 설정합니다.Gets or sets a list of specific Types to generate serialization code for. SGen은 해당 형식에 대해서만 serialization 코드를 생성합니다.SGen will generate serialization code only for those types.
UseProxyTypes 필수 Boolean 매개 변수입니다.Required Boolean parameter.

true이면 SGen 작업은 XML Web services 프록시 형식에 대해서만 serialization 코드를 생성합니다.If true, the SGen task generates serialization code only for the XML Web service proxy types.

설명Remarks

이 작업은 위에 나와 있는 매개 변수 외에 <xref:Microsoft.Build.Utilities.ToolTask> 클래스에서 직접 상속하는 <xref:Microsoft.Build.Tasks.ToolTaskExtension> 클래스의 매개 변수도 상속합니다.In addition to the parameters listed above, this task inherits parameters from the <xref:Microsoft.Build.Tasks.ToolTaskExtension> class, which itself inherits from the <xref:Microsoft.Build.Utilities.ToolTask> class. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 ToolTaskExtension 기본 클래스를 참조하세요.For a list of these additional parameters and their descriptions, see ToolTaskExtension Base Class.

참고 항목See Also

작업 참조 Task Reference
작업 Tasks
MSBuild 개념MSBuild Concepts