XML Schema Definition Tool (Xsd.exe)XML Schema Definition Tool (Xsd.exe)

XML 스키마 정의 도구(Xsd.exe)를 사용하면 XDR, XML 및 XSD 파일 또는 런타임 어셈블리의 클래스에서 XML 스키마 또는 공용 언어 런타임 클래스를 생성할 수 있습니다.The XML Schema Definition (Xsd.exe) tool generates XML schema or common language runtime classes from XDR, XML, and XSD files, or from classes in a runtime assembly.

구문Syntax

xsd file.xdr [-outputdir:directory][/parameters:file.xml]
xsd file.xml [-outputdir:directory] [/parameters:file.xml]
xsd file.xsd {/classes | /dataset} [/element:element]
             [/enableLinqDataSet] [/language:language]
                          [/namespace:namespace] [-outputdir:directory] [URI:uri]
                          [/parameters:file.xml]
xsd {file.dll | file.exe} [-outputdir:directory] [/type:typename [...]][/parameters:file.xml]

인수Argument

인수Argument 설명Description
file.extensionfile.extension 변환할 입력 파일을 지정합니다.Specifies the input file to convert. 다음 중 하나에 해당 하는 확장명을 xdr, .xml, .xsd, .dll 또는 .exe 중 하나로 지정 해야 합니다.You must specify the extension as one of the following: .xdr, .xml, .xsd, .dll, or .exe.

XDR 스키마 파일(.xdr 확장명)을 지정하면 Xsd.exe는 XDR 스키마를 XSD 스키마로 변환됩니다.If you specify an XDR schema file (.xdr extension), Xsd.exe converts the XDR schema to an XSD schema. 출력 파일의 이름은 XDR 스키마와 동일하지만 확장명은 .xsd입니다.The output file has the same name as the XDR schema, but with the .xsd extension.

XML 파일(.xml 확장명)을 지정하면 Xsd.exe는 해당 파일에 있는 데이터에서 스키마를 유추하여 XSD 스키마가 생성됩니다.If you specify an XML file (.xml extension), Xsd.exe infers a schema from the data in the file and produces an XSD schema. 출력 파일의 이름은 XML 파일과 동일하지만 확장명은 .xsd입니다.The output file has the same name as the XML file, but with the .xsd extension.

XML 스키마 파일(.xsd 확장명)을 지정하면 해당 XML 스키마에 해당하는 런타임 개체에 대한 소스 코드가 생성됩니다.If you specify an XML schema file (.xsd extension), Xsd.exe generates source code for runtime objects that correspond to the XML schema.

런타임 어셈블리 파일(.exe 또는 .dll 확장명)을 지정하면 해당 어셈블리에 있는 하나 이상의 형식에 대해 스키마가 생성됩니다.If you specify a runtime assembly file (.exe or .dll extension), Xsd.exe generates schemas for one or more types in that assembly. /type 옵션을 사용하면 스키마를 생성할 대상 형식을 지정할 수 있습니다.You can use the /type option to specify the types for which to generate schemas. 출력 스키마의 이름은 schema0.xsd, schema1.xsd 등과 같이 지정됩니다.The output schemas are named schema0.xsd, schema1.xsd, and so on. 지정된 형식에서 XMLRoot 사용자 지정 특성을 사용하여 네임스페이스를 지정하는 경우에만 여러 개의 스키마가 생성됩니다.Xsd.exe produces multiple schemas only if the given types specify a namespace using the XMLRoot custom attribute.

일반 옵션General Options

옵션Option 설명Description
/h [elp ]/h[elp] 이 도구의 명령 구문 및 옵션을 표시합니다.Displays command syntax and options for the tool.
/o [utputdir ]: 디렉터리/o[utputdir]:directory 출력 파일의 디렉터리를 지정합니다.Specifies the directory for output files. 이 인수는 한 번만 나타날 수 있으며,This argument can appear only once. 기본값은 현재 디렉터리입니다.The default is the current directory.
/?/? 이 도구의 명령 구문 및 옵션을 표시합니다.Displays command syntax and options for the tool.
/p [arameters ]: 파일 .xml/p[arameters]:file.xml 지정한 .xml 파일의 여러 가지 작동 모드에 대한 읽기 옵션입니다.Read options for various operation modes from the specified .xml file. 약식 표현은 /p:입니다.The short form is /p:. 자세한 내용은 설명 부분을 참조 하세요.For more information, see the Remarks section.

XSD 파일 옵션XSD File Options

.xsd 파일에는 다음 옵션 중 하나만 지정해야 합니다.You must specify only one of the following options for .xsd files.

옵션Option 설명Description
/c [lasses ]/c[lasses] 지정된 스키마에 해당하는 클래스를 생성합니다.Generates classes that correspond to the specified schema. XML 데이터를 개체로 읽어오려면 XmlSerializer.Deserialize 메서드를 사용합니다.To read XML data into the object, use the XmlSerializer.Deserialize method.
/d [ataset ]/d[ataset] 지정된 스키마에 해당하는 DataSet에서 파생된 클래스를 생성합니다.Generates a class derived from DataSet that corresponds to the specified schema. XML 데이터를 파생 클래스로 읽어오려면 DataSet.ReadXml 메서드를 사용합니다.To read XML data into the derived class, use the DataSet.ReadXml method.

.xsd 파일에는 다음 옵션을 지정할 수도 있습니다.You can also specify any of the following options for .xsd files.

옵션Option 설명Description
/e [lement ]: 요소/e[lement]:element 코드를 생성할 대상 스키마 요소를 지정합니다.Specifies the element in the schema to generate code for. 기본적으로 모든 요소가 입력되며,By default all elements are typed. 이 인수는 한 번 이상 지정될 수 있습니다.You can specify this argument more than once.
/enableDataBinding/enableDataBinding 생성된 모든 형식에 INotifyPropertyChanged 인터페이스를 구현하여 데이터 바인딩을 사용할 수 있습니다.Implements the INotifyPropertyChanged interface on all generated types to enable data binding. 약식 표현은 /edb입니다.The short form is /edb.
/enableLinqDataSet/enableLinqDataSet (약식: /eld) LINQ to DataSet를 사용 하 여 생성 된 데이터 집합을 쿼리할 수 있도록 지정 합니다.(Short form: /eld.) Specifies that the generated DataSet can be queried against using LINQ to DataSet. 이 옵션은 /dataset 옵션이 지정된 경우 사용됩니다.This option is used when the /dataset option is also specified. 자세한 내용은 LINQ to DataSet 개요형식화된 데이터 세트 쿼리를 참조하세요.For more information, see LINQ to DataSet Overview and Querying Typed DataSets. Linq 사용에 대 한 일반적인 내용은 linq ( C# 통합 언어 쿼리 ) 또는 linq (통합 언어 쿼리)-Visual Basic를 참조 하세요.For general information about using LINQ, see Language-Integrated Query (LINQ) - C# or Language-Integrated Query (LINQ) - Visual Basic.
/f [ields ]/f[ields] 속성 대신 필드를 생성합니다.Generates fields instead of properties. 기본적으로 속성이 생성됩니다.By default, properties are generated.
/l [anguage ]: language/l[anguage]:language 사용할 프로그래밍 언어를 지정합니다.Specifies the programming language to use. CS(C#, 기본값), VB(Visual Basic), JS(JScript) 또는 VJS(Visual J#) 중에서 선택합니다.Choose from CS (C#, which is the default), VB (Visual Basic), JS (JScript), or VJS (Visual J#). System.CodeDom.Compiler.CodeDomProvider를 구현하는 클래스의 정규화된 이름을 지정할 수도 있습니다.You can also specify a fully qualified name for a class implementing System.CodeDom.Compiler.CodeDomProvider
/n [amespace ]: 네임 스페이스/n[amespace]:namespace 생성된 형식에 대한 런타임 네임스페이스를 지정합니다.Specifies the runtime namespace for the generated types. 기본 네임스페이스는 Schemas입니다.The default namespace is Schemas.
/nologo/nologo 배너를 표시하지 않습니다.Suppresses the banner.
/order/order 모든 파티클 멤버에 대해 명시적인 순서 식별자를 생성합니다.Generates explicit order identifiers on all particle members.
/o [ut ]: directoryName/o[ut]:directoryName 파일을 배치할 출력 디렉터리를 지정합니다.Specifies the output directory to place the files in. 기본값은 현재 디렉터리입니다.The default is the current directory.
/u [ri ]: uri/u[ri]:uri 코드를 생성할 대상 스키마 요소의 URI를 지정합니다.Specifies the URI for the elements in the schema to generate code for. 이 URI가 존재하는 경우 /element 옵션을 사용하여 지정된 모든 요소에 적용됩니다.This URI, if present, applies to all elements specified with the /element option.

DLL 및 EXE 파일 옵션DLL and EXE File Options

옵션Option 설명Description
/t [ype ]: typename/t[ype]:typename 스키마를 생성할 대상 형식의 이름을 지정합니다.Specifies the name of the type to create a schema for. 여러 개의 형식 인수를 지정할 수도 있습니다.You can specify multiple type arguments. typename에서 네임스페이스를 지정하지 않으면 Xsd.exe는 해당 어셈블리의 모든 형식과 지정된 형식을 일치시킵니다.If typename does not specify a namespace, Xsd.exe matches all types in the assembly with the specified type. typename에서 네임스페이스를 지정하면 지정한 형식만 일치됩니다.If typename specifies a namespace, only that type is matched. typename이 별표(*)로 끝나는 경우에는 * 앞의 문자열로 시작하는 모든 형식이 일치됩니다.If typename ends with an asterisk character (*), the tool matches all types that start with the string preceding the *. /type 옵션을 생략하면 Xsd.exe는 해당 어셈블리의 모든 형식에 대해 스키마가 생성됩니다.If you omit the /type option, Xsd.exe generates schemas for all types in the assembly.

주의Remarks

다음 표에서는 Xsd.exe에서 수행되는 작업을 보여 줍니다.The following table shows the operations that Xsd.exe performs.

XDR에서 XSD로XDR to XSD XDR 스키마 파일에서 XML 스키마를 생성합니다.Generates an XML schema from an XML-Data-Reduced schema file. XDR은 XML 기반 스키마의 초기 형식입니다.XDR is an early XML-based schema format.
XML에서 XSD로XML to XSD XML 파일에서 XML 스키마를 생성합니다.Generates an XML schema from an XML file.
XSD에서 DataSet으로XSD to DataSet XSD 스키마 파일에서 공용 언어 런타임 DataSet 클래스를 생성합니다.Generates common language runtime DataSet classes from an XSD schema file. 이렇게 생성된 클래스에서는 일반 XML 데이터에 대한 강력한 개체 모델이 제공됩니다.The generated classes provide a rich object model for regular XML data.
XSD에서 클래스로XSD to Classes XSD 스키마 파일에서 런타임 클래스를 생성합니다.Generates runtime classes from an XSD schema file. 이렇게 생성된 클래스를 System.Xml.Serialization.XmlSerializer와 함께 사용하면 해당 스키마를 따르는 XML 코드를 읽고 쓸 수 있습니다.The generated classes can be used in conjunction with System.Xml.Serialization.XmlSerializer to read and write XML code that follows the schema.
클래스를 XSD로Classes to XSD 런타임 어셈블리 파일의 형식에서 XML 스키마를 생성합니다.Generates an XML schema from a type or types in a runtime assembly file. 생성 된 스키마는 XmlSerializer에서 사용 하는 XML 형식을 정의 합니다.The generated schema defines the XML format used by the XmlSerializer.

Xsd.exe를 사용하면 W3C(World Wide Web 컨소시엄)에서 제시하는 XSD(XML Schema Definition) 언어를 따르는 XML 스키마만 조작할 수 있습니다.Xsd.exe only allows you to manipulate XML schemas that follow the XML Schema Definition (XSD) language proposed by the World Wide Web Consortium (W3C). XML 스키마 정의 제안 또는 XML 표준에 대 한 자세한 내용은 https://w3.org를 참조 하세요.For more information on the XML Schema Definition proposal or the XML standard, see https://w3.org.

XML 파일로 옵션 설정Setting Options with an XML File

/parameters 스위치를 사용하여 여러 가지 옵션을 설정하는 단일 XML 파일을 지정할 수 있습니다.By using the /parameters switch, you can specify a single XML file that sets various options. 설정할 수 있는 옵션은 XSD.exe 도구를 사용하는 방법에 따라 다릅니다.The options you can set depend on how you are using the XSD.exe tool. 스키마 생성, 코드 파일 생성 또는 DataSet 기능이 있는 코드 파일 생성을 선택할 수 있습니다.Choices include generating schemas, generating code files, or generating code files that include DataSet features. 예를 들면, 스키마는 생성하지만 코드 파일은 생성하지 않을 때 <assembly> 요소를 실행 파일(.exe) 또는 형식 라이브러리 파일(.dll) 이름으로 설정할 수 있습니다.For example, you can set the <assembly> element to the name of an executable (.exe) or type library (.dll) file when generating a schema, but not when generating a code file. 다음 XML에서는 지정된 실행 파일에 <generateSchemas> 요소를 사용하는 방법을 보여 줍니다.The following XML shows how to use the <generateSchemas> element with a specified executable:

<!-- This is in a file named GenerateSchemas.xml. -->
<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>
<generateSchemas>
   <assembly>ConsoleApplication1.exe</assembly>
</generateSchemas>
</xsd>

위의 XML이 GenerateSchemas.xml이라는 파일에 포함된 경우 명령 프롬프트에서 다음을 입력하고 Enter 키를 눌러 /parameters 스위치를 사용합니다.If the preceding XML is contained in a file named GenerateSchemas.xml, then use the /parameters switch by typing the following at a command prompt and pressing ENTER:

 xsd /p:GenerateSchemas.xml

그러나 어셈블리에 있는 단일 형식의 스키마를 생성하는 경우 다음 XML을 사용할 수 있습니다.On the other hand, if you are generating a schema for a single type found in the assembly, you can use the following XML:

<!-- This is in a file named GenerateSchemaFromType.xml. -->
<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>
<generateSchemas>
   <type>IDItems</type>
</generateSchemas>
</xsd>

위의 코드를 사용하려면 명령 프롬프트에서 어셈블리의 이름도 제공해야 합니다.But to use preceding code, you must also supply the name of the assembly at the command prompt. 명령 프롬프트에서 다음을 입력합니다. 이 경우 XML 파일 이름이 GenerateSchemaFromType.xml이라고 가정합니다.Type the following at a command prompt (presuming the XML file is named GenerateSchemaFromType.xml):

xsd /p:GenerateSchemaFromType.xml ConsoleApplication1.exe

<generateSchemas> 요소에 대해 다음 옵션 중 하나만 지정해야 합니다.You must specify only one of the following options for the <generateSchemas> element.

요소Element 설명Description
<assembly><assembly> 스키마를 생성하는 어셈블리를 지정합니다.Specifies an assembly to generate the schema from.
<type><type> 스키마를 생성할 대상 어셈블리에 있는 유형을 지정합니다.Specifies a type found in an assembly to generate a schema for.
<xml><xml> 스키마를 생성할 대상 XML 파일을 지정합니다.Specifies an XML file to generate a schema for.
<xdr><xdr> 스키마를 생성할 대상 XDR 파일을 지정합니다.Specifies an XDR file to generate a schema for.

코드 파일을 생성하려면 <generateClasses> 요소를 사용합니다.To generate a code file, use the <generateClasses> element. 다음 예제는 코드 파일을 생성합니다.The following example generates a code file. 또한 생성된 파일의 프로그래밍 언어 및 네임스페이스를 설정할 수 있는 두 개의 특성이 표시됩니다.Note that two attributes are also shown that allow you to set the programming language and namespace of the generated file.

<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>
<generateClasses language='VB' namespace='Microsoft.Serialization.Examples'/>
</xsd>
<!-- You must supply an .xsd file when typing in the command line.-->
<!-- For example: xsd /p:genClasses mySchema.xsd -->

<generateClasses> 요소에 대해 설정할 수 있는 옵션은 다음과 같습니다.Options you can set for the <generateClasses> element include the following.

요소Element 설명Description
<element><element> 코드를 생성할 대상 .xsd 파일의 요소를 지정합니다.Specifies an element in the .xsd file to generate code for.
<schemaImporterExtensions><schemaImporterExtensions> SchemaImporterExtension 클래스에서 파생된 형식을 지정합니다.Specifies a type derived from the SchemaImporterExtension class.
<schema><schema> 코드를 생성할 XML 스키마 파일을 지정합니다.Specifies a XML Schema file to generate code for. 여러 <schema> 요소를 사용하여 XML 스키마 파일을 여러 개 지정할 수 있습니다.Multiple XML Schema files can be specified using multiple <schema> elements.

다음 표에서는 <generateClasses> 요소에도 사용할 수 있는 특성을 보여 줍니다.The following table shows the attributes that can also be used with the <generateClasses> element.

특성Attribute 설명Description
languagelanguage 사용할 프로그래밍 언어를 지정합니다.Specifies the programming language to use. CS(C#, 기본값), VB(Visual Basic), JS(JScript) 또는 VJS(Visual J#) 중에서 선택합니다.Choose from CS (C#, the default), VB (Visual Basic), JS (JScript), or VJS (Visual J#). CodeDomProvider를 구현하는 클래스의 정규화된 이름을 지정할 수도 있습니다.You can also specify a fully qualified name for a class that implements CodeDomProvider.
네임스페이스(namespace)namespace 생성된 코드에 대한 네임스페이스를 지정합니다.Specifies the namespace for the generated code. 네임스페이스는 CLR 표준(예: 공백 없음 또는 백슬래시 문자)에 일치해야 합니다.The namespace must conform to CLR standards (for example, no spaces or backslash characters).
옵션options none, properties(public 필드 대신 속성 생성), order 또는 enableDataBinding(위의 XSD 파일 옵션 섹션의 /order/enableDataBinding 스위치 참조) 값 중 하나One of the following values: none, properties (generates properties instead of public fields), order, or enableDataBinding (see the /order and /enableDataBinding switches in the preceding XSD File Options section.

DataSet 요소를 사용하여 <generateDataSet> 코드를 생성하는 방식을 제어할 수도 있습니다.You can also control how DataSet code is generated by using the <generateDataSet> element. 다음 XML은 생성 된 코드가 DataSet 구조체 (예: DataTable 클래스)를 사용 하 여 지정 된 요소에 대 한 Visual Basic 코드를 만들도록 지정 합니다.The following XML specifies that the generated code uses DataSet structures (such as the DataTable class) to create Visual Basic code for a specified element. 생성된 DataSet 구조체는 LINQ 쿼리를 지원합니다.The generated DataSet structures will support LINQ queries.

<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>
    <generateDataSet language='VB' namespace='Microsoft.Serialization.Examples' enableLinqDataSet='true'>
    </generateDataSet>
</xsd>

<generateDataSet> 요소에 대해 설정할 수 있는 옵션은 다음과 같습니다.Options you can set for the <generateDataSet> element include the following.

요소Element 설명Description
<schema><schema> 코드를 생성할 XML 스키마 파일을 지정합니다.Specifies an XML Schema file to generate code for. 여러 <schema> 요소를 사용하여 XML 스키마 파일을 여러 개 지정할 수 있습니다.Multiple XML Schema files can be specified using multiple <schema> elements.

다음 표에서는 <generateDataSet> 요소에 사용할 수 있는 특성을 보여 줍니다.The following table shows the attributes that can be used with the <generateDataSet> element.

특성Attribute 설명Description
enableLinqDataSetenableLinqDataSet 생성된 DataSet을 LINQ to DataSet을 사용하여 쿼리할 수 있도록 지정합니다.Specifies that the generated DataSet can be queried against using LINQ to DataSet. 기본값은 false입니다.The default value is false.
languagelanguage 사용할 프로그래밍 언어를 지정합니다.Specifies the programming language to use. CS(C#, 기본값), VB(Visual Basic), JS(JScript) 또는 VJS(Visual J#) 중에서 선택합니다.Choose from CS (C#, the default), VB (Visual Basic), JS (JScript), or VJS (Visual J#). CodeDomProvider를 구현하는 클래스의 정규화된 이름을 지정할 수도 있습니다.You can also specify a fully qualified name for a class that implements CodeDomProvider.
네임스페이스(namespace)namespace 생성된 코드에 대한 네임스페이스를 지정합니다.Specifies the namespace for the generated code. 네임스페이스는 CLR 표준(예: 공백 없음 또는 백슬래시 문자)에 일치해야 합니다.The namespace must conform to CLR standards (for example, no spaces or backslash characters).

이러한 특성은 최상위 수준의 <xsd> 요소에서 설정할 수 있습니다.There are attributes that you can set on the top level <xsd> element. 이러한 옵션은 자식 요소(<generateSchemas>, <generateClasses> 또는 <generateDataSet>)에 사용할 수 있습니다.These options can be used with any of the child elements (<generateSchemas>, <generateClasses> or <generateDataSet>). 다음 XML 코드는 "MyOutputDirectory"라는 출력 디렉터리에 "IDItems" 요소에 대한 코드를 생성합니다.The following XML code generates code for an element named "IDItems" in the output directory named "MyOutputDirectory".

<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/' output='MyOutputDirectory'>
<generateClasses>
    <element>IDItems</element>
</generateClasses>
</xsd>

다음 표에서는 <xsd> 요소에도 사용할 수 있는 특성을 보여 줍니다.The following table shows the attributes that can also be used with the <xsd> element.

특성Attribute 설명Description
출력output 생성된 스키마 또는 코드 파일을 지정할 디렉터리의 이름입니다.The name of a directory where the generated schema or code file will be placed.
nologonologo 배너를 표시하지 않습니다.Suppresses the banner. true 또는 false로 설정합니다.Set to true or false.
도움말help 이 도구의 명령 구문 및 옵션을 표시합니다.Displays command syntax and options for the tool. true 또는 false로 설정합니다.Set to true or false.

예제Examples

다음 명령을 사용하여 myFile.xdr 에서 XML 스키마를 생성한 다음 현재 디렉터리에 저장합니다.The following command generates an XML schema from myFile.xdr and saves it to the current directory.

xsd myFile.xdr

다음 명령을 사용하여 myFile.xml 스키마를 생성한 다음 지정된 디렉터리에 저장합니다.The following command generates an XML schema from myFile.xml and saves it to the specified directory.

xsd myFile.xml /outputdir:myOutputDir

다음 명령은 C# 언어로 된 지정된 스키마와 일치하는 데이터 집합을 생성한 다음 현재 디렉터리에 XSDSchemaFile.cs로 저장합니다.The following command generates a data set that corresponds to the specified schema in the C# language and saves it as XSDSchemaFile.cs in the current directory.

xsd /dataset /language:CS XSDSchemaFile.xsd

다음 명령을 사용하여 어셈블리 myAssembly.dll에 있는 모든 형식에 대해 XML 스키마를 생성한 다음 현재 디렉터리에 schema0.xsd로 저장합니다.The following command generates XML schemas for all types in the assembly myAssembly.dll and saves them as schema0.xsd in the current directory.

xsd myAssembly.dll

참조See also