mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCompilationSettings.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <Type Name="XmlSchemaCompilationSettings" FullName="System.Xml.Schema.XmlSchemaCompilationSettings">
   3   <TypeSignature Language="C#" Value="public sealed class XmlSchemaCompilationSettings" />
   4   <TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit XmlSchemaCompilationSettings extends System.Object" />
   5   <AssemblyInfo>
   6     <AssemblyName>System.Xml</AssemblyName>
   7     <AssemblyVersion>2.0.0.0</AssemblyVersion>
   8     <AssemblyVersion>4.0.0.0</AssemblyVersion>
   9   </AssemblyInfo>
  10   <Base>
  11     <BaseTypeName>System.Object</BaseTypeName>
  12   </Base>
  13   <Interfaces />
  14   <Docs>
  15     <since version=".NET 2.0" />
  16     <remarks>
  17       <attribution license="cc4" from="Microsoft" modified="false" />
  18       <para>The <see cref="T:System.Xml.Schema.XmlSchemaCompilationSettings" /> class provides schema compilation options for the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> class. For example, the <see cref="P:System.Xml.Schema.XmlSchemaCompilationSettings.EnableUpaCheck" /> property specifies that the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> should check for Unique Particle Attribution (UPA) violations when schemas in the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> are compiled.</para>
  19     </remarks>
  20     <summary>
  21       <attribution license="cc4" from="Microsoft" modified="false" />
  22       <para>Provides schema compilation options for the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> class This class cannot be inherited.</para>
  23     </summary>
  24   </Docs>
  25   <Members>
  26     <Member MemberName=".ctor">
  27       <MemberSignature Language="C#" Value="public XmlSchemaCompilationSettings ();" />
  28       <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
  29       <MemberType>Constructor</MemberType>
  30       <AssemblyInfo>
  31         <AssemblyVersion>2.0.0.0</AssemblyVersion>
  32         <AssemblyVersion>4.0.0.0</AssemblyVersion>
  33       </AssemblyInfo>
  34       <Parameters />
  35       <Docs>
  36         <remarks>To be added.</remarks>
  37         <since version=".NET 2.0" />
  38         <summary>
  39           <attribution license="cc4" from="Microsoft" modified="false" />
  40           <para>Initializes a new instance of the <see cref="T:System.Xml.Schema.XmlSchemaCompilationSettings" /> class. </para>
  41         </summary>
  42       </Docs>
  43     </Member>
  44     <Member MemberName="EnableUpaCheck">
  45       <MemberSignature Language="C#" Value="public bool EnableUpaCheck { get; set; }" />
  46       <MemberSignature Language="ILAsm" Value=".property instance bool EnableUpaCheck" />
  47       <MemberType>Property</MemberType>
  48       <AssemblyInfo>
  49         <AssemblyVersion>2.0.0.0</AssemblyVersion>
  50         <AssemblyVersion>4.0.0.0</AssemblyVersion>
  51       </AssemblyInfo>
  52       <ReturnValue>
  53         <ReturnType>System.Boolean</ReturnType>
  54       </ReturnValue>
  55       <Docs>
  56         <value>To be added.</value>
  57         <since version=".NET 2.0" />
  58         <remarks>
  59           <attribution license="cc4" from="Microsoft" modified="false" />
  60           <para>When the <see cref="P:System.Xml.Schema.XmlSchemaCompilationSettings.EnableUpaCheck" /> property is set to false, validation will be performed based on the following rules.</para>
  61           <list type="ordered">
  62             <item>
  63               <para>If there is a choice between a strong type and a wildcard, the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> will pick the strongly typed particle as illustrated in the following schema and Xml examples.</para>
  64             </item>
  65           </list>
  66           <para>&lt;xs:sequence&gt;</para>
  67           <para>    &lt;xs:any namespace="##any"/&gt;</para>
  68           <para>    &lt;xs:element name="A" type="xs:string" minOccurs="0"/&gt;</para>
  69           <para>&lt;/xs:sequence&gt;</para>
  70           <para>In the following Xml, the A element will be associated with &lt;xs:element name="A" type="xs:string" minOccurs="0"/&gt; in the schema.</para>
  71           <para>&lt;A&gt;some text&lt;/A&gt;</para>
  72           <list type="ordered">
  73             <item>
  74               <para>If there is a choice between two strongly typed elements, the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> will pick the first one.</para>
  75             </item>
  76           </list>
  77           <para>&lt;xs:sequence&gt;</para>
  78           <para>    &lt;xs:element name="A" type="xs:string"/&gt;</para>
  79           <para>    &lt;xs:element name="B" type="xs:string" minOccurs="0"/&gt;</para>
  80           <para>    &lt;xs:element name="B" type="xs:string"/&gt;</para>
  81           <para>&lt;/xs:sequence&gt;</para>
  82           <para>In the following Xml, the B element will be associated with &lt;xs:element name="B" type="xs:string" minOccurs="0"/&gt; in the schema.</para>
  83           <para>&lt;A/&gt;</para>
  84           <para>&lt;B/&gt;</para>
  85         </remarks>
  86         <summary>
  87           <attribution license="cc4" from="Microsoft" modified="false" />
  88           <para>Gets or sets a value indicating whether the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> should check for Unique Particle Attribution (UPA) violations.</para>
  89         </summary>
  90       </Docs>
  91     </Member>
  92   </Members>
  93 </Type>